Udostępnij za pośrednictwem

Wdrażanie obiektów bazy danych CLR

  • Artykuł

Dotyczy:programu SQL Server

Wdrożenie to proces dystrybucji gotowej aplikacji lub modułu do zainstalowania i uruchomienia na innym komputerze. Za pomocą programu Visual Studio można tworzyć obiekty bazy danych środowiska uruchomieniowego języka wspólnego (CLR) i wdrażać je na serwerze testowym. Alternatywnie obiekty zarządzanej bazy danych można również skompilować przy użyciu plików redystrybucji programu .NET Framework zamiast programu Visual Studio. Po skompilowaniu zestawy zawierające obiekty bazy danych CLR można następnie wdrożyć na serwerze testowym przy użyciu programu Visual Studio lub instrukcji Transact-SQL.

Po przetestowaniu i zweryfikowaniu metod CLR na serwerze testowym można je dystrybuować do serwerów produkcyjnych przy użyciu skryptu wdrażania. Skrypt wdrażania można wygenerować ręcznie lub przy użyciu programu SQL Server Management Studio (opisanego w dalszej części tego artykułu).

Funkcja integracji ŚRODOWISKA CLR jest domyślnie wyłączona w programie SQL Server i musi być włączona w celu korzystania z zestawów CLR. Aby uzyskać więcej informacji, zobacz Włączanie integracji środowiska CLR.

Wdrażanie zestawu na serwerze testowym

Za pomocą programu Visual Studio można opracowywać funkcje CLR, procedury, wyzwalacze, typy zdefiniowane przez użytkownika (UDT) lub agregacje zdefiniowane przez użytkownika (UA) i wdrażać je na serwerze testowym. Te zarządzane obiekty bazy danych można również skompilować za pomocą kompilatorów wiersza polecenia, takich jak csc.exe i vbc.exe, dołączonych do plików redystrybucji programu .NET Framework. Zintegrowane środowisko programistyczne programu Visual Studio nie jest wymagane do tworzenia zarządzanych obiektów bazy danych dla programu SQL Server.

Upewnij się, że wszystkie błędy i ostrzeżenia kompilatora zostały rozwiązane. Zestawy zawierające procedury CLR można następnie zarejestrować w bazie danych programu SQL Server przy użyciu programu Visual Studio lub instrukcji Transact-SQL.

Nuta

Protokół sieciowy TCP/IP musi być włączony w wystąpieniu programu SQL Server, aby można było używać programu Visual Studio do zdalnego programowania, debugowania i programowania. Aby uzyskać więcej informacji na temat włączania protokołu TCP/IP na serwerze, zobacz Configure Client Protocols.

Wdrażanie zestawu przy użyciu programu Visual Studio

  1. Skompiluj projekt, wybierając z menu kompilacji nazwę projektu <Kompilacja>.

  2. Przed wdrożeniem zestawu na serwerze testowym rozwiąż wszystkie błędy kompilacji i ostrzeżenia.

  3. Wybierz pozycję Wdróż z menu Kompilacja. Zestaw jest następnie rejestrowany w wystąpieniu programu SQL Server i bazie danych określonej podczas tworzenia projektu programu SQL Server w programie Visual Studio.

Wdrażanie zestawu przy użyciu Transact-SQL

  1. Skompiluj zestaw z pliku źródłowego przy użyciu kompilatorów wiersza polecenia dołączonych do programu .NET Framework.

  2. W przypadku plików źródłowych języka C#:

    csc /target:library C:\helloworld.cs

  3. W przypadku plików źródłowych języka Visual Basic:

    vbc /target:library C:\helloworld.vb

Te polecenia uruchamiają kompilator języka C# lub Visual Basic przy użyciu opcji /target w celu określenia tworzenia biblioteki DLL.

  1. Przed wdrożeniem zestawu na serwerze testowym rozwiąż wszystkie błędy kompilacji i ostrzeżenia.

  2. Otwórz program SQL Server Management Studio na serwerze testowym. Utwórz nowe zapytanie połączone z odpowiednią testową bazą danych (na przykład AdventureWorks2022).

  3. Utwórz zestaw na serwerze, dodając następujące Transact-SQL do zapytania.

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

  4. Procedura, funkcja, agregacja, typ zdefiniowany przez użytkownika lub wyzwalacz muszą zostać utworzone w wystąpieniu programu SQL Server. Jeśli zestaw HelloWorld zawiera metodę o nazwie HelloWorld w klasie Procedures, następujące Transact-SQL można dodać do zapytania w celu utworzenia procedury o nazwie hello w programie SQL Server.

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

Aby uzyskać więcej informacji na temat tworzenia różnych typów zarządzanych obiektów bazy danych w programie SQL Server, zobacz:

Wdrażanie zestawu na serwerach produkcyjnych

Po przetestowaniu i zweryfikowaniu obiektów bazy danych CLR na serwerze testowym można je dystrybuować do serwerów produkcyjnych. Aby uzyskać więcej informacji na temat debugowania zarządzanych obiektów bazy danych, zobacz Jak debugować obiekty bazy danych CLR.

Wdrażanie zarządzanych obiektów bazy danych jest podobne do zwykłych obiektów bazy danych (tabel, Transact-SQL procedur itd.). Zestawy zawierające obiekty bazy danych CLR można wdrożyć na innych serwerach przy użyciu skryptu wdrożenia. Skrypt wdrażania można skompilować przy użyciu Generowanie skryptów funkcji programu Management Studio. Skrypt wdrażania można również skompilować ręcznie lub skompilować przy użyciu generowania skryptów i ręcznie modyfikować. Po utworzeniu skryptu wdrażania można go uruchomić w innych wystąpieniach programu SQL Server, aby wdrożyć obiekty zarządzanej bazy danych.

Generowanie skryptu wdrażania przy użyciu generowania skryptów

  1. Otwórz program Management Studio i połącz się z wystąpieniem programu SQL Server, w którym zarejestrowano zarządzany zestaw lub obiekt bazy danych do wdrożenia.

  2. W eksploratorze obiektów rozwiń nazwę serwera i drzewa Databases. Kliknij prawym przyciskiem myszy bazę danych, w której zarejestrowano obiekt zarządzanej bazy danych, wybierz pozycję Tasks, a następnie wybierz pozycję Generate Scripts (Generuj skrypty). Zostanie otwarty Kreator skryptów.

  3. Wybierz bazę danych z listy i wybierz pozycję Dalej.

  4. W okienku Wybierz opcje skryptu wybierz pozycję Dalejlub zmień opcje, a następnie wybierz pozycję Dalej.

  5. W okienku Wybierz typy obiektów wybierz typ obiektu bazy danych do wdrożenia. Wybierz pozycję Dalej.

  6. Dla każdego typu obiektu wybranego w okienku Wybierz typy obiektów zostanie wyświetlone okienko Wybierz typ <>. W tym okienku można wybrać spośród wszystkich wystąpień tego typu obiektu bazy danych zarejestrowanych w określonej bazie danych. Wybierz co najmniej jeden obiekt i wybierz pozycję Dalej.

  7. Po wybraniu wszystkich żądanych typów obiektów bazy danych zostanie wyświetlone okienko Opcje wyjściowe. Wybierz pozycję Script to file (Skrypt) i określ ścieżkę pliku dla skryptu. Wybierz pozycję Dalej. Przejrzyj wybrane opcje i wybierz pozycję Zakończ. Skrypt wdrożenia jest zapisywany w określonej ścieżce pliku.

Skrypty po wdrożeniu

Możesz uruchomić skrypt po wdrożeniu.

Aby dodać skrypt po wdrożeniu, dodaj plik o nazwie postdeployscript.sql w katalogu projektu programu Visual Studio. Na przykład kliknij prawym przyciskiem myszy projekt w eksploratorze rozwiązań i wybierz pozycję Dodaj istniejący element. Dodaj plik w katalogu głównym projektu, a nie w folderze Skrypty testowe.

Po wybraniu opcji wdróż program Visual Studio uruchomi ten skrypt po wdrożeniu projektu.

Powiązana zawartość