Del via

SqlPackage for SQL-database i Microsoft Fabric

  • Artikkel

Gjelder for:✅SQL-database i Microsoft Fabric

I denne opplæringen lærer du hvordan du arbeider med SqlPackage i SQL-databasen i Fabric.

SqlPackage er en CLI som gir databaseportabilitet og databasedistribusjoner.

  • Portabiliteten (import/eksport) av en database som administreres i Azure eller i Fabric sikrer at dataene dine er flyttbare til andre plattformer, inkludert SQL Server eller Azure SQL administrert forekomst, hvis du vil overføre senere.
  • Den samme portabiliteten muliggjør også visse overføringsscenarioer gjennom selvstendige databasekopier (.bacpac) med import-/eksportoperasjoner.

SqlPackage kan også aktivere enkel databasedistribusjon av trinnvise endringer i databaseobjekter (nye kolonner i tabeller, endringer i eksisterende lagrede prosedyrer osv.).

  • SqlPackage kan pakke ut en .dacpac fil som inneholder definisjonene av objekter i en database, og publisere en .dacpac fil for å bruke denne objekttilstanden på en ny eller eksisterende database.
  • Publiseringsoperasjonen integreres også med SQL-prosjekter, som muliggjør frakoblede og mer dynamiske utviklingssykluser for SQL-databaser.

Forutsetning

Oppsett

SqlPackage er tilgjengelig for Windows, macOS og Linux som dotnet-verktøy. Du kan installere den ved hjelp av følgende kommando:

dotnet tool install --global Microsoft.SqlPackage

Som et globalt dotnet-verktøy er SqlPackage tilgjengelig i terminalen som fra hvilken som sqlpackage helst mappe.

Importere en database med SqlPackage

A .bacpac er en bærbar kopi av en database, nyttig for noen overførings- og testscenarioer. Du kan importere dette .bacpac til en tom SQL-database.

Merk

A .bacpac er ikke en sikkerhetskopi eller erstatning for sikkerhetskopierings-/gjenopprettingsfunksjoner. Hvis du vil ha mer informasjon om sikkerhetskopier i Fabric SQL-database, kan du se Automatiske sikkerhetskopier i SQL-databasen i Microsoft Fabric og Gjenopprett fra en sikkerhetskopi i SQL-databasen i Microsoft Fabric.

  1. Hvis du bruker et .bacpac fra Azure SQL Database-miljøet, må du kanskje endre kildedatabasen for å møte T-SQL-overflateområdet for Fabric SQL-databasen.

  2. Opprett den nye SQL-databasen i Fabric som vanlig gjennom Fabric-grensesnittet.

  3. Kopier tilkoblingsstreng fra innstillingene.

    Skjermbilde fra Stoff-portalen som viser tilkoblingsstrengsiden for SQL-databasen.

  4. Bruk importkommandoen fra terminalen i sqlpackage-mappen. Oppgi eieren <servername> og <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"
    • Erstatt tilkoblingsstreng fra dialogboksen innstillinger for SQL-database.
    • sourcefile Erstatt verdien med .bacpac navnet (DatabaseName) og location på den lokale maskinen.

Hvis du vil ha mer informasjon om import, kan du se SqlPackage-import.

Eksportere en database med SqlPackage

Eksportering av en .bacpac er omvendt operasjon, der du targetfile er en .bacpac , og du finner den sourceconnectionstring i dialogboksen innstillinger for SQL-databaser, som i forrige eksempel. Oppgi eieren <servername> og <database_name>. Eksempel:

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"

Hvis du vil ha mer informasjon om eksport, kan du se SqlPackage-eksport.

Trekke ut og publisere

Diagram over hvordan SQL-databaseprosjekter kan flytte skjemaendringer.

A .dacpac er en fil for databaseskjemamodell, som inneholder definisjoner for tabellene, lagrede prosedyrer og andre objekter i kildedatabasen. Denne filen kan opprettes fra en eksisterende database med SqlPackage eller fra et SQL-databaseprosjekt.

SqlPackage er i stand til å distribuere en .dacpac til en ny (tom) database eller trinnvis oppdatering av en eksisterende database for å samsvare med ønsket .dacpac tilstand.

  • Pakk ut oppretter en .dacpac eller sql-filer fra en eksisterende database.
  • Publiser distribuerer en .dacpac til en database.

SqlPackage publisere og trekke ut syntaks ligner på kommandoene for import/eksport.

Advarsel

Det anbefales å bruke SqlPackage til å distribuere et SQL-prosjekt eller .dacpac til SQL-database i Fabric. Distribusjon av en .dacpac fra Visual Studio kan mislykkes.

Hvis du vil distribuere en .dacpac som ble opprettet fra Azure SQL Database, SQL Server eller et SQL-prosjekt rettet mot en annen plattform enn SQL-database i Fabric, tilføyer du egenskapen /p:AllowIncompatiblePlatform=true til publiseringskommandoen SqlPackage.

Relatert innhold