Sdílet prostřednictvím

Nasazení databázových objektů CLR

  • Článek

platí pro:SQL Server

Nasazení je proces, kterým distribuujete dokončenou aplikaci nebo modul, který se má nainstalovat a spustit na jiném počítači. Pomocí sady Visual Studio můžete vyvíjet databázové objekty CLR (Common Language Runtime) a nasazovat je na testovací server. Spravované databázové objekty lze také zkompilovat pomocí redistribuovaných souborů rozhraní .NET Framework místo sady Visual Studio. Po kompilaci je možné sestavení obsahující databázové objekty CLR nasadit na testovací server pomocí sady Visual Studio nebo příkazů Transact-SQL.

Po otestování a ověření metod CLR na testovacím serveru je možné je distribuovat do produkčních serverů pomocí skriptu nasazení. Skript nasazení je možné generovat ručně nebo pomocí aplikace SQL Server Management Studio (popsané dále v tomto článku).

Funkce integrace CLR je ve výchozím nastavení v SQL Serveru vypnutá a musí být povolená, aby bylo možné používat sestavení CLR. Další informace najdete v tématu Povolení integrace CLR.

Nasazení sestavení na testovací server

Pomocí sady Visual Studio můžete vyvíjet funkce CLR, procedury, triggery, uživatelsky definované typy (UDT) nebo uživatelem definované agregace (UDA) a nasazovat je na testovací server. Tyto spravované databázové objekty lze také zkompilovat pomocí kompilátorů příkazového řádku, jako jsou csc.exe a vbc.exe, součástí redistribuovaných souborů rozhraní .NET Framework. Integrované vývojové prostředí sady Visual Studio není nutné k vývoji spravovaných databázových objektů pro SQL Server.

Ujistěte se, že jsou vyřešeny všechny chyby a upozornění kompilátoru. Sestavení obsahující rutiny CLR je pak možné zaregistrovat v databázi SQL Serveru pomocí sady Visual Studio nebo Transact-SQL příkazů.

Poznámka

Aby bylo možné používat Visual Studio pro vzdálený vývoj, ladění a vývoj, musí být v instanci SQL Serveru povolený síťový protokol TCP/IP. Další informace o povolení protokolu TCP/IP na serveru naleznete v tématu Konfigurace klientských protokolů.

Nasazení sestavení pomocí sady Visual Studio

  1. Projekt sestavte tak, že v nabídce Sestavení vyberete název projektu sestavení .

  2. Před nasazením sestavení na testovací server vyřešte všechny chyby a upozornění sestavení.

  3. V nabídce Sestavení vyberte Nasadit. Sestavení se pak zaregistruje v instanci a databázi SQL Serveru zadané při prvním vytvoření projektu SQL Serveru v sadě Visual Studio.

Nasazení sestavení pomocí Transact-SQL

  1. Zkompilujte sestavení ze zdrojového souboru pomocí kompilátorů příkazového řádku, které jsou součástí rozhraní .NET Framework.

  2. Pro zdrojové soubory jazyka C#:

    csc /target:library C:\helloworld.cs

  3. Zdrojové soubory jazyka Visual Basic:

    vbc /target:library C:\helloworld.vb

Tyto příkazy spustí kompilátor jazyka C# nebo Visual Basic pomocí možnosti /target k určení sestavení knihovny DLL.

  1. Před nasazením sestavení na testovací server vyřešte všechny chyby a upozornění sestavení.

  2. Otevřete SQL Server Management Studio na testovacím serveru. Vytvořte nový dotaz připojený k vhodné testovací databázi (například AdventureWorks2022).

  3. Sestavení na serveru vytvořte přidáním následujícího Transact-SQL do dotazu.

    CREATE ASSEMBLY HelloWorld from 'c:\helloworld.dll' WITH PERMISSION_SET = SAFE;

  4. Procedura, funkce, agregace, uživatelem definovaný typ nebo aktivační událost se pak musí vytvořit v instanci SQL Serveru. Pokud sestavení HelloWorld obsahuje metodu s názvem HelloWorld ve třídě Procedures, lze do dotazu přidat následující Transact-SQL a vytvořit proceduru s názvem hello v SQL Serveru.

    CREATE PROCEDURE hello AS
EXTERNAL NAME HelloWorld.Procedures.HelloWorld;

Další informace o vytváření různých typů spravovaných databázových objektů v SQL Serveru najdete tady:

Nasazení sestavení na produkční servery

Po otestování a ověření databázových objektů CLR na testovacím serveru je možné je distribuovat do produkčních serverů. Další informace o ladění spravovaných databázových objektů naleznete v tématu Postup ladění databázových objektů CLR.

Nasazení spravovaných databázových objektů se podobá nasazení běžných databázových objektů (tabulek, Transact-SQL rutin atd.). Sestavení obsahující databázové objekty CLR je možné nasadit na jiné servery pomocí skriptu nasazení. Skript nasazení lze sestavit pomocí funkce Generovat skripty Management Studio. Skript nasazení lze také sestavit ručně nebo vytvořit pomocí Generovat skripty a ručně změnit. Jakmile je skript nasazení sestavený, můžete ho spustit v jiných instancích SQL Serveru a nasadit spravované databázové objekty.

Generování skriptu nasazení pomocí vygenerovaných skriptů

  1. Otevřete Management Studio a připojte se k instanci SQL Serveru, ve které je zaregistrované spravované sestavení nebo databázový objekt.

  2. V průzkumníku objektů rozbalte název serveru <> a databáze stromy. Klikněte pravým tlačítkem myši na databázi, ve které je spravovaný databázový objekt registrován, vyberte Úkolya pak vyberte Vygenerovat skripty. Otevře se Průvodce skriptem.

  3. V seznamu vyberte databázi a vyberte Další.

  4. V podokně Zvolit možnosti skriptu vyberte Dalšínebo změňte možnosti a pak vyberte Další.

  5. V podokně Zvolit typy objektů zvolte typ databázového objektu, který se má nasadit. Vyberte Další.

  6. Pro každý typ objektu vybraný v podokně Zvolit typy objektů se zobrazí Zvolit typ <> podokno. V tomto podokně si můžete vybrat ze všech instancí tohoto typu databázového objektu zaregistrovaného v zadané databázi. Vyberte jeden nebo více objektů a vyberte Další.

  7. Po výběru všech požadovaných typů databázových objektů se zobrazí podokno Možnosti výstupu. Vyberte Skript k souboru a zadejte cestu k souboru pro skript. Vyberte Další. Zkontrolujte výběry a vyberte Dokončit. Skript nasazení se uloží do zadané cesty k souboru.

Skripty po nasazení

Můžete spustit skript po nasazení.

Pokud chcete přidat skript po nasazení, přidejte do adresáře projektu sady Visual Studio soubor s názvem postdeployscript.sql. Klikněte například pravým tlačítkem na projekt v Průzkumníku řešení a vyberte Přidat existující položku. Místo do složky Testovací skripty přidejte soubor do kořenového adresáře projektu.

Když vyberete nasazení, Visual Studio spustí tento skript po nasazení projektu.

Související obsah