Del via

SqlPackage til SQL-database i Microsoft Fabric

  • Artikel

Gælder for:✅SQL-database i Microsoft Fabric

I dette selvstudium lærer du, hvordan du arbejder med SqlPackage i din SQL-database i Fabric.

SqlPackage er en kommandolinjegrænseflade, der leverer databaseportabilitet og databaseinstallationer.

  • Overførsel (import/eksport) af en database, der administreres i Azure eller Fabric, sikrer, at dine data er bærbare til andre platforme, herunder SQL Server eller Azure SQL Managed Instance, hvis du vil overføre dem senere.
  • Den samme portabilitet muliggør også visse overførselsscenarier via selvstændige databasekopier (.bacpac) med import-/eksporthandlinger.

SqlPackage kan også muliggøre nem databaseinstallationer af trinvise ændringer af databaseobjekter (nye kolonner i tabeller, ændringer af eksisterende lagrede procedurer osv.).

  • SqlPackage kan udtrække en .dacpac fil, der indeholder definitionerne af objekter i en database, og udgive en .dacpac fil for at anvende objekttilstanden på en ny eller eksisterende database.
  • Publiceringshandlingen integreres også med SQL-projekter, hvilket muliggør offline- og mere dynamiske udviklingscyklusser for SQL-databaser.

Forudsætninger

Opsætte

SqlPackage er tilgængelig til Windows, macOS og Linux som et dotnetværktøj. Du kan installere den ved hjælp af følgende kommando:

dotnet tool install --global Microsoft.SqlPackage

Som et globalt dotnetværktøj er SqlPackage tilgængelig i terminalen fra en hvilken som sqlpackage helst mappe.

Importér en database med SqlPackage

A .bacpac er en bærbar kopi af en database, der er nyttig til nogle overførsels- og testscenarier. Du kan importere det .bacpac til en tom SQL-database.

Bemærk

A .bacpac er ikke en sikkerhedskopiering eller en erstatning for sikkerhedskopierings-/gendannelsesfunktioner. Du kan få flere oplysninger om sikkerhedskopier i Fabric SQL-databasen under Automatisk sikkerhedskopiering i SQL-database i Microsoft Fabric og Gendannelse fra en sikkerhedskopi i SQL-database i Microsoft Fabric.

  1. Hvis du bruger et .bacpac fra dit Azure SQL Database-miljø, skal du muligvis ændre kildedatabasen, så den opfylder Fabric SQL-databasens T-SQL-overfladeområde.

  2. Opret din nye SQL-database i Fabric som normalt via Fabric-grænsefladen.

  3. Kopiér forbindelsesstreng fra indstillingerne.

    Skærmbillede fra Fabric-portalen, der viser siden Forbindelsesstrenge i SQL-databasen.

  4. Brug kommandoen import fra terminal i sqlpackage-mappen. Angiv din ejer <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"
    • Erstat din forbindelsesstreng fra dialogboksen SQL-databaseindstillinger.
    • Erstat værdien sourcefile med navnet .bacpac (DatabaseName) og location på din lokale computer.

Du kan få flere oplysninger om import under SqlPackage-import.

Eksportér en database med SqlPackage

Eksport af en .bacpac er den omvendte handling, hvor er targetfile en .bacpac , og du sourceconnectionstring kan finde den i dialogboksen med indstillinger for SQL-database som i det forrige eksempel. Angiv din ejer <servername> og <database_name>. Eksempler:

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"

Du kan finde flere oplysninger om eksport under SqlPackage-eksport.

Udtræk og publicer

Diagram over, hvordan SQL-databaseprojekter kan flytte skemaændringer.

A .dacpac er en databaseskemamodelfil, der indeholder definitioner for tabellerne, lagrede procedurer og andre objekter i kildedatabasen. Denne fil kan oprettes ud fra en eksisterende database med SqlPackage eller fra et SQL-databaseprojekt.

SqlPackage kan udrulle en .dacpac til en ny (tom) database eller trinvist opdatere en eksisterende database, så den svarer til den ønskede .dacpac tilstand.

  • Udpak opretter en .dacpac eller SQL-filer fra en eksisterende database.
  • Publish udruller en .dacpac til en database.

SqlPackage-publicere og udtrække-syntaks svarer til import-/eksportkommandoerne.

Advarsel

Det anbefales at bruge SqlPackage til at udrulle et SQL-projekt eller .dacpac til SQL-databasen i Fabric. Det kan mislykkes at installere en .dacpac fra Visual Studio.

Hvis du vil udrulle en .dacpac, der er oprettet ud fra Azure SQL Database, SQL Server eller et SQL-projekt, der er målrettet til en anden platform end SQL-database i Fabric, skal du føje egenskaben /p:AllowIncompatiblePlatform=true til kommandoen SqlPackage publish.

Relateret indhold