SqlPackage pre databázu SQL v službe Microsoft Fabric

Vzťahuje sa na:✅databáza SQL v službe Microsoft Fabric

V tomto kurze sa naučíte pracovať s balíkom SqlPackage v databáze SQL v službe Fabric.

SqlPackage je CLI, ktoré poskytuje prenosnosť databázy a nasadenie databáz.

• Prenosnosť (import a export) databázy spravovanej v službe Azure alebo v službe Fabric zabezpečí, že ak budete chcieť migrovať neskôr, vaše údaje budú prenosné na iné platformy, vrátane SQL Servera alebo Azure SQL Managed Instance.
• Rovnaká prenosnosť tiež umožňuje určité scenáre migrácie prostredníctvom samostatných kópií databázy (.bacpac) s operáciami importu/exportu.

SqlPackage tiež môže umožniť jednoduché nasadenie databázových prírastkových zmien do databázových objektov (nové stĺpce v tabuľkách, zmeny existujúcich uložených procedúr atď.).

• SqlPackage môže extrahovať .dacpac súbor obsahujúci definície objektov v databáze a publikovať .dacpac súbor, ktorý použije tento stav objektu na novú alebo existujúcu databázu.
• Operácia publikovania sa tiež integruje s projektmi SQL, ktoré umožňujú offline a dynamickejšie vývojové cykly pre databázy SQL.

• Potrebujete existujúcu kapacitu služby Fabric. Ak nie, spustite skúšobnú verziu služby Fabric.
• Uistite sa, že ste povolili možnosť Povoliť databázu SQL v nastaveniach nájomníka služby Fabric.
• Vytvorte nový pracovný priestor alebo použite existujúci pracovný priestor služby Fabric.
• Vytvorenie alebo použitie existujúcej databázy SQL v službe Fabric. Ak ešte nemáte novú databázu SQL v službe Fabric, vytvorte ju.
• Nainštalujte súpravu .NET 8 SDK.

SqlPackage je k dispozícii pre Windows, macOS a Linux ako nástroj dotnet. Môžete ju nainštalovať pomocou nasledujúceho príkazu:

dotnet tool install --global Microsoft.SqlPackage

Ako globálny nástroj dotnet je sqlPackage vo vašom termináli k dispozícii ako sqlpackage z ľubovoľného priečinka.

A .bacpac je prenosná kópia databázy, užitočná v prípade niektorých scenárov migrácie a testovania. Môžete .bacpac do prázdnej databázy SQL.

1. Ak používate rozhranie .bacpac z prostredia databázy Azure SQL, môže byť potrebné zmeniť zdrojovú databázu tak, aby spĺňala oblasť povrchu T-SQL databázy Fabric SQL.

2. Vytvorte novú databázu SQL v službe Fabric ako zvyčajne prostredníctvom rozhrania služby Fabric.

3. Skopírujte reťazec pripojenia z nastavení.

   

4. Použite príkaz importu z terminálu v priečinku sqlpackage. Zadajte svojho vlastníka <servername> a <database_name>.

   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"
   

   • Nahraďte reťazec pripojenia v dialógovom okne Nastavenia databázy SQL.
   • sourcefile Nahraďte hodnotu názvom .bacpac (DatabaseName) a location v lokálnom počítači.

Ďalšie informácie o importe nájdete v téme Import sqlpackage.

Exportovanie je reverzná .bacpac operácia, kde je targetfile vaša .bacpac a nájdete ju sourceconnectionstring v dialógovom okne Nastavenia databázy SQL, ako v predchádzajúcom príklade. Zadajte svojho vlastníka <servername> a <database_name>. Napríklad:

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"

Ďalšie informácie o exporte nájdete v téme Export sqlpackage.

A .dacpac je modelový súbor schémy databázy, ktorý obsahuje definície tabuliek, uložených procedúr a ďalších objektov v zdrojovej databáze. Tento súbor je možné vytvoriť z existujúcej databázy s sqlpackage alebo z projektu databázy SQL .

SqlPackage je schopný nasadiť .dacpac do novej (prázdnej) databázy alebo prírastkovo aktualizovať existujúcu databázu tak, aby zodpovedala požadovanému .dacpac stavu.

• Extrahovanie vytvorí .dacpac alebo SQL súbory z existujúcej databázy.
• Publikovanie nasadzuje .dacpac položku do databázy.

Syntax jazyka SQLPackage publikovanie a extrahovanie je podobná syntaxi príkazov importu/exportu.

Ak chcete nasadiť .dacpac vytvorenú z databázy Azure SQL, SQL Servera alebo projektu SQL zameraného na inú platformu ako databáza SQL v službe Fabric, pripojte vlastnosť /p:AllowIncompatiblePlatform=true do príkazu na publikovanie databázy SqlPackage.

• Databáza SQL v službe Microsoft Fabric
• Kurz: Správa životného cyklu v službe Fabric
• Prehľad projektov SQL
• Integrácia ovládacieho prvku ovládacieho prvku zdrojovej databázy SQL