Olvasás angol nyelven

Megosztás a következőn keresztül:

CLR-adatbázis-objektumok üzembe helyezése

  • Cikk

A következőkre vonatkozik:SQL Server

Az üzembe helyezés az a folyamat, amellyel egy telepített és egy másik számítógépen futtatandó kész alkalmazást vagy modult terjeszt. A Visual Studióval közös nyelvi futtatókörnyezeti (CLR) adatbázis-objektumokat fejleszthet, és üzembe helyezheti őket egy tesztkiszolgálón. Másik lehetőségként a felügyelt adatbázis-objektumok a Visual Studio helyett a .NET-keretrendszer újraterjesztési fájljaival is lefordíthatók. A fordítás után a CLR-adatbázis-objektumokat tartalmazó szerelvényeket a Visual Studio vagy Transact-SQL utasításokkal telepítheti egy tesztkiszolgálóra.

Miután a CLR-metódusokat tesztelték és ellenőrizték a tesztkiszolgálón, üzembehelyezési szkripttel terjeszthetők az éles kiszolgálókra. Az üzembehelyezési szkript manuálisan vagy az SQL Server Management Studio használatával hozható létre (a cikk későbbi részében).

A CLR integrációs funkció alapértelmezés szerint ki van kapcsolva az SQL Serverben, és engedélyezni kell a CLR-szerelvények használatához. További információ: CLR-integráció engedélyezése.

A szerelvény üzembe helyezése a tesztkiszolgálón

A Visual Studio használatával CLR-függvényeket, eljárásokat, eseményindítókat, felhasználó által definiált típusokat (UDT-ket) vagy felhasználó által definiált összesítéseket (UDA-kat) fejleszthet, és üzembe helyezheti őket egy tesztkiszolgálón. Ezek a felügyelt adatbázis-objektumok a parancssori fordítókkal is lefordíthatók, például csc.exe és vbc.exe, amelyek a .NET-keretrendszer újraterjesztési fájljai közé tartoznak. Az SQL Server felügyelt adatbázis-objektumainak fejlesztéséhez nincs szükség a Visual Studio integrált fejlesztési környezetére.

Győződjön meg arról, hogy minden fordítóhiba és figyelmeztetés megoldódott. A CLR-rutinokat tartalmazó szerelvények ezután regisztrálhatók egy SQL Server-adatbázisban a Visual Studio vagy Transact-SQL utasítások használatával.

Megjegyzés

A TCP/IP hálózati protokollt engedélyezni kell az SQL Server-példányon a Visual Studio távoli fejlesztéshez, hibakereséshez és fejlesztéshez való használatához. A TCP/IP protokoll kiszolgálón való engedélyezéséről további információt az Ügyfélprotokollok konfigurálásacímű témakörben talál.

A szerelvény üzembe helyezése a Visual Studióval

  1. A projekt létrehozásához válassza Build <projekt nevét> a Build menüből.

  2. A szerelvény tesztkiszolgálón való üzembe helyezése előtt elháríthatja az összes összeállítási hibát és figyelmeztetést.

  3. A Build menüben válassza a Üzembe helyezés lehetőséget. A rendszer ezután regisztrálja a szerelvényt az SQL Server-példányban és az SQL Server-projekt Visual Studióban való első létrehozásakor megadott adatbázisban.

A szerelvény üzembe helyezése Transact-SQL

  1. Állítsa össze a szerelvényt a forrásfájlból a .NET-keretrendszerben található parancssori fordítók használatával.

  2. C#-forrásfájlok esetén:

    csc /target:library C:\helloworld.cs

  3. Visual Basic-forrásfájlok esetén:

    vbc /target:library C:\helloworld.vb

Ezek a parancsok elindítják a C# vagy a Visual Basic fordítót a /target beállítással a kódtár DLL-jének létrehozásához.

  1. A szerelvény tesztkiszolgálón való üzembe helyezése előtt elháríthatja az összes összeállítási hibát és figyelmeztetést.

  2. Nyissa meg az SQL Server Management Studiót a tesztkiszolgálón. Hozzon létre egy új lekérdezést, amely egy megfelelő tesztadatbázishoz (például AdventureWorks2022) csatlakozik.

  3. Hozza létre a szerelvényt a kiszolgálón a következő Transact-SQL hozzáadásával a lekérdezéshez.

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

  4. Az eljárást, függvényt, összesítést, felhasználó által definiált típust vagy eseményindítót ezután létre kell hozni az SQL Server példányában. Ha a HelloWorld szerelvény tartalmaz egy HelloWorld nevű metódust a Procedures osztályban, a következő Transact-SQL adható hozzá a lekérdezéshez, hogy létrehozhasson egy hello nevű eljárást az SQL Serverben.

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

További információ a felügyelt adatbázis-objektumok különböző típusainak SQL Serverben való létrehozásáról:

A szerelvény üzembe helyezése éles kiszolgálókon

Miután a CLR-adatbázis-objektumokat tesztelte és ellenőrizte a tesztkiszolgálón, azokat el lehet osztani az éles kiszolgálókra. A felügyelt adatbázis-objektumok hibakereséséről további információt A CLR-adatbázisobjektumok hibakeresésecímű témakörben talál.

A felügyelt adatbázis-objektumok üzembe helyezése hasonló a normál adatbázis-objektumokhoz (táblákhoz, Transact-SQL rutinokhoz stb.). A CLR-adatbázis-objektumokat tartalmazó szerelvények üzembe helyezhetők más kiszolgálókon üzembe helyezési szkript használatával. Az üzembehelyezési szkript a Management Studio Szkriptek létrehozása funkciójának használatával hozható létre. Az üzembehelyezési szkriptet manuálisan is létrehozhatja, vagy Szkriptek létrehozása és manuálisan is módosítható. Az üzembe helyezési szkript létrehozása után futtatható az SQL Server más példányán a felügyelt adatbázis-objektumok üzembe helyezéséhez.

Üzembehelyezési szkript létrehozása szkriptek generálása használatával

  1. Nyissa meg a Management Studiót, és csatlakozzon ahhoz az SQL Server-példányhoz, ahol a felügyelt szerelvény vagy adatbázis-objektum regisztrálva van.

  2. Az Object Explorerbontsa ki a <kiszolgáló nevét> és adatbázisok fákat. Kattintson a jobb gombbal arra az adatbázisra, amelyben a felügyelt adatbázis-objektum regisztrálva van, válassza a Feladatoklehetőséget, majd válassza a Szkriptek létrehozásalehetőséget. Megnyílik a Szkript varázsló.

  3. Jelölje ki az adatbázist a listamezőből, és válassza Következőlehetőséget.

  4. A Parancsprogram beállításai panelen válassza a Következőlehetőséget, vagy módosítsa a beállításokat, majd válassza Következőlehetőséget.

  5. Az Objektumtípusok kiválasztása panelen válassza ki az üzembe helyezendő adatbázis-objektum típusát. Válassza Következőlehetőséget.

  6. Az Objektumtípusok kiválasztása panelen kijelölt összes objektumtípusnál megjelenik egy <típus kiválasztása> panel. Ebben a panelen a megadott adatbázisban regisztrált adatbázis-objektumtípus összes példánya közül választhat. Jelöljön ki egy vagy több objektumot, és válassza Továbblehetőséget.

  7. A Kimeneti beállítások panel akkor jelenik meg, amikor az összes kívánt adatbázis-objektumtípus ki van választva. Válassza szkriptet a fájlhoz, és adja meg a szkript elérési útját. Válassza Következőlehetőséget. Tekintse át a kijelöléseket, és válassza a Befejezéslehetőséget. Az üzembehelyezési szkript a megadott fájl elérési útjára lesz mentve.

Üzembehelyezési szkriptek közzététele

Futtathat üzembe helyezés utáni szkriptet.

Üzembe helyezés utáni szkript hozzáadásához vegyen fel egy postdeployscript.sql nevű fájlt a Visual Studio projektkönyvtárába. Kattintson például a jobb gombbal a projektre Megoldáskezelő, és válassza a Meglévő elem hozzáadásalehetőséget. Adja hozzá a fájlt a projekt gyökeréhez, nem pedig a Tesztszkriptek mappába.

Az üzembe helyezés kiválasztásakor a Visual Studio a projekt üzembe helyezése után futtatja ezt a szkriptet.

Kapcsolódó tartalom