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


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 hordozhatók legyenek, beleértve az SQL Servert vagy a felügyelt Azure SQL-példányt is, ha később migrálni szeretne.
  • Ugyanez a hordozhatóság bizonyos migrálási forgatókönyveket is lehetővé tesz az importálási/exportálási műveletekkel rendelkező önálló adatbázis-másolatok (.bacpac) használatával.

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

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.

Feljegyzés

Az A .bacpac nem biztonsági mentés vagy csere a biztonsági mentési/visszaállítási képességekhez. A Fabric SQL-adatbázisban lévő biztonsági mentésekről további információt a Microsoft Fabric sql-adatbázis automatikus biztonsági mentései és a Microsoft Fabric SQL-adatbázis biztonsági másolataiból történő visszaállítás című témakörben talál.

  1. Ha az Azure SQL Database-környezetből használ, .bacpac előfordulhat, hogy módosítania kell a forrásadatbázist, hogy megfeleljen a Fabric SQL-adatbázis T-SQL felületének.

  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.

    Képernyőkép a Háló portálról, amelyen az SQL-adatbázis Kapcsolati sztringek lapja látható.

  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.

Az importálással kapcsolatos további információkért lásd az SqlPackage importálásá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.exe /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

Ábra arról, hogy az SQL Database-projektek hogyan helyezhetik át a sémamódosításokat.

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 meglévő adatbázisból az SqlPackage használatával, vagy 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.