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
- Meglévő hálókapacitásra van szüksége. Ha nem, indítsa el a Fabric próbaverzióját.
- Győződjön meg arról, hogy engedélyezi az SQL-adatbázist a Fabric-bérlő beállításaiban.
- 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.
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.
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.Hozza létre az új SQL-adatbázist a Fabric felületén a szokásos módon.
Másolja a kapcsolati sztring a beállításokból.
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
éslocation
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
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.