SqlPackage az SQL Database-hez a Microsoft Fabricben

A következőre vonatkozik:✅ SQL-adatbázis a Microsoft Fabricben

Ebben az oktatóanyagban megtudhatja, hogyan használhatja az SqlPackage-t az SQL Database-ben a Fabricben.

Az SqlPackage egy parancssori felület, amely lehetővé teszi az adatbázisok hordozhatóságát és az adatbázisok üzembe helyezését.

• Az Azure-ban vagy a Fabricben felügyelt adatbázisok hordozhatósága (importálása/exportálása) biztosítja, hogy az adatok más platformokra is áttelepíthetők legyenek, ha később migrálni szeretné őket. – A hordozhatóság magában foglalja az SQL Serverre, az Azure SQL Database-be, a felügyelt Azure SQL-példányra és a Fabricben lévő SQL-adatbázisra való áthelyezést önálló adatbázismásolatokon (.bacpac vagy .dacpac fájlokon) keresztül.

Az SqlPackage lehetővé teszi az adatbázis-objektumok növekményes módosításainak egyszerű adatbázis-üzembe helyezését is (új táblák oszlopai, meglévő tárolt eljárások módosítása stb.).

• Az SqlPackage kinyerheti .dacpac az adatbázis objektumdefinícióit tartalmazó fájlokat, és közzétehet egy .dacpac fájlt, hogy az objektumállapotot egy új vagy meglévő adatbázisra alkalmazza.
• A közzétételi művelet sql-projektekkel is integrálható, ami offline és dinamikusabb fejlesztési ciklusokat tesz lehetővé az SQL-adatbázisok számára.

Előfeltételek

• Meglévő hálókapacitásra van szüksége. Ha nem, indítsa el a Fabric próbaverzióját.
• Hozzon létre egy új munkaterületet, vagy használjon egy meglévő Fabric-munkaterületet.
• Hozzon létre vagy használjon egy meglévő SQL-adatbázist a Fabricben. Ha még nem rendelkezik ilyen adatbázissal, hozzon létre egy új SQL-adatbázist a Fabricben.
• Telepítse a .NET 8 SDK-t.

Beállítás

Az SqlPackage dotnetes eszközként érhető el Windows, macOS és Linux rendszeren. A következő paranccsal telepítheti:

dotnet tool install --global Microsoft.SqlPackage

Globális dotnet-eszközként az SqlPackage bármely mappából elérhető a terminálban sqlpackage .

Adatbázis importálása az SqlPackage használatával

Az A .bacpac az adatbázis hordozható másolata, amely bizonyos migrálási és tesztelési helyzetekben hasznos. Ezt importálhatja.bacpac egy üres SQL-adatbázisba az SqlPackage importálásával.

Feljegyzés

A .bacpac nem helyettesíti és nem is pótolja a biztonsági mentés/visszaállítás képességét. További információ az SQL-adatbázis biztonsági mentéseiről a Fabricben: Automatikus biztonsági mentések az SQL-adatbázisban a Microsoft Fabricben és visszaállítás a Microsoft Fabric SQL-adatbázis biztonsági mentéséből.

1. Ha Azure- vagy SQL Server-környezetet használ .bacpac , előfordulhat, hogy módosítania kell a forrásadatbázist, hogy megfeleljen a Fabric T-SQL felületi SQL-adatbázisnak. Tekintse meg a(z) hordozhatóság kinyerését és közzétételét egy alternatív módszerhez, amely lehetővé teszi, hogy az SqlPackage-tulajdonságok kihagyjanak néhány nem támogatott objektumot.

2. Hozza létre az új SQL-adatbázist a Fabric felületén a szokásos módon.

3. Másolja a kapcsolati sztring a beállításokból.

   

4. Használja a terminál importálási parancsát az sqlpackage mappában. Adja meg a tulajdonosát <servername> és <database_name>a .

   sqlpackage /action:import /sourcefile:"C:\DatabaseName.bacpac" /targetconnectionstring:"Data Source=tcp:<server_name>.database.fabric.microsoft.com,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive"
   

   • Cserélje le a kapcsolati sztring az SQL-adatbázis beállításai párbeszédpanelen.
   • Cserélje le az sourcefile értéket a .bacpac () névreDatabaseName és location a helyi gépen.

5. Kövesse az importálást másolási feladattal a Data Factoryben a Microsoft Fabricben. Első lépésként tekintse meg a Másolási feladat létrehozása című rövid útmutatót.

Adatbázis exportálása az SqlPackage használatával

.bacpac Az exportálás a fordított művelet, ahol az targetfile Ön .bacpac és az sourceconnectionstring SQL-adatbázis beállításai párbeszédpanelen található, ahogyan az előző példában is látható. Adja meg a tulajdonosát <servername> és <database_name>a . Példa:

sqlpackage /action:export /targetfile:"C:\DatabaseName.bacpac" /sourceconnectionstring:"Data Source=tcp:<server_name>.database.fabric.microsoft.com,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive"

Az exportálással kapcsolatos további információkért lásd az SqlPackage exportálását.

Kinyerés és közzététel

Az A .dacpac egy adatbázissémamodell-fájl, amely definíciókat tartalmaz a táblákhoz, a tárolt eljárásokhoz és a forrásadatbázis egyéb objektumaihoz. Ez a fájl létrehozható egy sqlpackage-et tartalmazó meglévő adatbázisból vagy egy SQL Database-projektből.

Az SqlPackage képes üzembe helyezni egy .dacpac új (üres) adatbázist, vagy növekményesen frissíteni egy meglévő adatbázist a kívánt .dacpac állapotnak megfelelően.

• A Kivonat egy .dacpac vagy több SQL-fájlt hoz létre egy meglévő adatbázisból.
• A Közzététel egy adatbázisba helyezi üzembe a telepítendő adatokat .dacpac .

Az SqlPackage közzétételi és kinyerési szintaxisa hasonló az importálási/exportálási parancsokhoz.

Figyelmeztetés

SqlPackage használata SQL-projekt vagy .dacpac üzembe helyezéséhez egy SQL-adatbázisban a Fabric környezetben ajánlott. Előfordulhat, hogy egy .dacpac a Visual Studióból való üzembe helyezése sikertelen lehet.

Ha olyan .dacpac szeretne üzembe helyezni, amelyet az Azure SQL Database-ből, AZ SQL Serverből vagy a Fabricben lévő SQL-adatbázistól eltérő platformot célzó SQL-projektből hoztak létre, fűzze hozzá a /p:AllowIncompatiblePlatform=true tulajdonságot az SqlPackage közzétételi parancsához.

Hordozhatóság kinyerés és közzététel

Bár az SqlPackage importálási/exportálási parancsai a .bacpac formátum adathordozhatóságára összpontosítanak, a kinyerési és közzétételi parancsok képesek a .dacpac formátummal való adathordozhatóságra. A kinyerési és közzétételi tulajdonságok a kinyerési és közzétételi műveletek viselkedésének szabályozására, valamint a platformok közötti átalakítások rugalmasságának szabályozására használhatók.

Az adatok kinyeréséhez.dacpac és belefoglalásához használja az /p:ExtractAllTableData=true tulajdonságot. A kinyerési művelet létrehoz egy .dacpac-t, amely tartalmazza a sémát és a forrásadatbázisból származó adatokat. A tulajdonság /p:ExtractReferencedServerScopedElements=false kizárja a kiszolgáló hatókörébe tartozó elemeket, amelyek nem támogatottak a Fabric sql-adatbázisában. A következő parancs kinyer egy .dacpac, amely adatokat tartalmaz egy meglévő SQL-adatbázisból a Fabricben.

sqlpackage /action:extract /sourceconnectionstring:"Data Source=tcp:<server_name>.database.fabric.microsoft.com,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive" /targetfile:"C:\extracted.dacpac" /p:ExtractAllTableData=true  /p:ExtractReferencedServerScopedElements=false

Az adatokkal kinyert adatok közzétételéhez.dacpac nincs szükség további tulajdonságokra. A közzétételi művelet viselkedésének szabályozására azonban több tulajdonság is használható:

• /p:AllowIncompatiblePlatform=true lehetővé teszi egy .dacpac másik platformról (például Azure SQL Database, SQL Server) kinyert példány üzembe helyezését.
• /p:ExcludeObjectTypes=Logins;Users Kizárja azokat az objektumtípusokat, amelyek kompatibilitási problémákat tapasztalhatnak az SQL Database-ben való közzétételkor a Fabricben. A kizárható objektumtípusok teljes listáját az SqlPackage publish alatt találja.

Az SqlPackage importálási parancshoz hasonlóan, mielőtt közzétesz egy .dacpac SQL-adatbázist a Fabricben, először létre kell hoznia az adatbázist. Az adatbázist a Fabric portálon vagy más Háló felületen hozhatja létre. A következő parancs közzéteszi a kinyert .dacpac adatokat egy üres SQL-adatbázisban a Fabricben:

sqlpackage /action:publish /sourcefile:"C:\extracted.dacpac" /targetconnectionstring:"Data Source=tcp:<server_name>.database.fabric.microsoft.com,1433;Initial Catalog=<database_name>;MultipleActiveResultSets=False;Connect Timeout=30;Encrypt=True;TrustServerCertificate=False;ConnectRetryCount=6;ConnectRetryInterval=10;Authentication=Active Directory Interactive" /p:AllowIncompatiblePlatform=true /p:ExcludeObjectTypes=Logins;Users

Kapcsolódó tartalom

• SQL-adatbázis a Microsoft Fabricben
• Oktatóanyag: Életciklus-kezelés a Fabricben
• SQL-projektek áttekintése
• SQL-adatbázis forrásvezérlési integrációja
• A Microsoft Fabric migrálásának áttekintése