Migrer med en DACPAC-fil

Gjelder for: ✅ Warehouse i Microsoft Fabric

Fabric Migration Assistant er en migreringsopplevelse du kan bruke til å kopiere dedikerte SQL-pooler i Azure Synapse Analytics, databaser i SQL Server og databaser fra andre SQL Database Engine-plattformer sømløst inn i Fabric Data Warehouse.

Denne guiden tar deg gjennom stegene for å migrere fra en dedikert SQL pool fra Azure Synapse Analytics til Fabric warehouse ved å bruke en DACPAC-fil.

Forutsetninger

Før du begynner, sørg for at du har følgende ting klare:

• Et stoffarbeidsområde med en aktiv kapasitet eller prøvekapasitet.
• Opprett et arbeidsområde eller velg et eksisterende arbeidsområde du vil overføre til. Migrasjonsassistenten oppretter et nytt lager for deg.
• DACPAC-fil som er trukket ut fra Azure Synapse Analytics dedikert SQL-utvalg. En DACPAC-fil (data-tier application package) er bygget fra SQL-databaseprosjekter og inneholder metadataene til databaseobjekter, inkludert skjemaet for tabeller, visninger, lagrede prosedyrer, funksjoner og mer.
  • Hvis du vil opprette en DAC i Visual Studio 2022 med SQL Server Data Tools, kan du se Pakke ut et DATA-nivåprogram (DAC) fra et Azure Synapse-dedikert SQL-utvalg i Visual Studio 2022.
  • Du kan også bruke databaseprosjekter i SDK-stil med VS Code eller kommandolinjeverktøyet SqlPackage.

For å bruke de AI-assisterte migrasjonsfunksjonene i Migration Assistant til å løse migreringsproblemer, må du aktivere Copilot:

• Administratoren må aktivere leierbryteren før du begynner å bruke Copilot. Hvis du vil ha mer informasjon, kan du se Innstillinger for Copilot-leier.
• F2- eller P1-kapasiteten må være i et av områdene som er oppført i stoffområdetilgjengelighet.
• Hvis leieren eller kapasiteten er utenfor USA eller Frankrike, er Copilot deaktivert som standard med mindre Fabric-leieradministratoren aktiverer at dataene som sendes til Azure OpenAI, kan behandles utenfor kapasitetens geografiske område, samsvarsgrense eller leietakerinnstilling for nasjonal skyforekomst i Fabric Admin-portalen.
• Copilot i Microsoft Fabric støttes ikke på prøveversjon av SKU-er. Bare betalte SKU-er (F2 eller høyere, eller P1 eller høyere) støttes nå.
• Hvis du vil ha mer informasjon, kan du se Oversikt over Copilot i Fabric og Power BI.

Kopier metadata

1. I Fabric-arbeidsområdet velger du Overfør-knappen på elementhandlingsdekket.

   

2. I menyen Migrate to Fabric source, under Migrate to a warehouse, velg kildesystemflisen.

   • Hvis du migrerer fra en dedikert SQL pool for Azure Synapse Analytics, velg Azure Synapse Analytics dedikert SQL pool-flisen .
   • Hvis du migrerer fra en annen T-SQL-database, som en database i SQL Server, Azure SQL Database eller Azure SQL Managed Instance, velg SQL Server-databaseflisen .

   

3. På siden Velg metoden din , velg Last opp en fil med kildemetadata og velg Neste.

4. Velg Velg fil , og last opp DACPAC-filen til kildedatalageret. Når opplastingen er ferdig, velg Neste.

   

5. På siden Sett destinasjonen , skriv inn navnet på det nye Fabric-arbeidsområdet og det nye lagervaret du ønsker å migrere til. Velg Neste.

6. Se gjennom inndataene dine, og velg Overfør. Migreringsassistenten oppretter et nytt lagerelement og starter metadatamigreringen.

   Bemerkning

   Når du bruker Migreringsassistenten, har det nye lageret en mellombokstavsuavhengig sammenstilling, uavhengig av standard lagersortering.

   

   I dette steget oversetter Migration Assistant T-SQL-metadata til støttet T-SQL-syntaks i Fabric Data Warehouse. Etter at metadata-migreringen er ferdig, åpnes Migreringsassistenten. Du kan når som helst få tilgang til Migreringsassistenten ved å bruke Migreringsknappen i Hjem-fanen på lagerbåndet.

7. Se gjennom sammendraget for metadataoverføring i overføringsassistenten. Du ser antall migrerte objekter og hvilke objekter som må fikses før de kan migreres.

   

8. Velg Vis migrerte objekter for å utvide seksjonen og se en liste over objekter du har migrert til Fabric-lageret ditt.

   

   Kolonnen Tilstand indikerer om Migration Assistant justerte objektets metadata under oversettelsen til Fabric Data Warehouse. Du kan for eksempel se at bestemte kolonnedatatyper eller T-SQL-språkkonstruksjoner automatisk konverteres til de som støttes i Fabric. Kolonnen Detaljer viser informasjonen om justeringene portalen gjorde på objektene.

9. Velg et hvilket som helst objekt for å se justeringene som Migreringsassistenten gjorde under migreringen.

10. Åpne sammendraget for metadataoverføring i fullskjermvisning for bedre lesbarhet. Bruk filtre for å vise bestemte objekttyper.

    

11. Velg eventuelt Eksport-menyen for å laste ned et migrasjonssammendrag som en Excel-fil eller en CSV.

    • Den nedlastede Excel-filen er en fullstendig strukturert arbeidsbok med to arbeidsark: Migrerte objekter og Objekter som skal fikses. Det er MIP-kompatibelt og tilpasset organisasjonens sensitivitetsetiketter.
    • CSV-en er lett og verktøyvennlig.

    

    Hver eksporterte fil gir en strukturert, omfattende oversikt over migreringsresultatene dine, inkludert:

    Feltnavn	Beskrivelse	Utvalgsverdier
    Objektnavn	Navn på SQL-objekt
    Objekttype	SQL-objekttyper	Tabell, visning, lagret prosedyre, funksjon
    Status	Oversettelsestilstand	Justert: Oppdateringer som er kompatible med Fabric Data Warehouse er implementert Ikke justert: Ingen endring i det opprinnelige manuset
    Detaljer	Liste over justeringer eller feilmeldinger
    Type feil	Type oversettelsesfeil	Oversettelsesmelding, Oversettelsesfeil, Oversettelsesanvendingsfeil

Fiks problemer ved å bruke Migration Assistant

Enkelte metadata for databaseobjekter kan ikke overføres. Ofte oppstår denne feilen fordi Migration Assistant ikke kunne oversette T-SQL-metadataene til de som støttes i et Fabric-lager, eller den oversatte koden ikke ble brukt på T-SQL.

Fiks disse skriptene ved å bruke Migreringsassistenten.

1. Velg Løs problemer-trinnet i Overføringsassistent for å se skriptene som ikke ble overført.

   

2. Velg et databaseobjekt som ikke kan overføres. En ny spørring åpnes under Delte spørringer i utforskeren. Denne nye spørringen viser metadatadefinisjonen og justeringene som ble gjort i den som automatiske kommentarer lagt til I T-SQL-koden.

3. Se gjennom kommentarene i begynnelsen av skriptet for å se justeringene som ble gjort i skriptet.

4. Gå gjennom og fiks de ødelagte skriptene ved å bruke feilinformasjonen og dokumentasjonen.

5. Hvis du vil bruke Copilot for AI-drevet hjelp til å rette opp feilene, velger du Rette spørringsfeil i delen Foreslått handling. Copilot oppdaterer skriptet med forslag. Feil kan skje når Copilot bruker kunstig intelligens, så bekreft kodeforslag og foreta eventuelle justeringer du trenger.

6. Velg Kjør for å validere og opprette objektet.

7. Neste skript som skal fikses åpnes.

8. Fortsett å løse resten av skriptene. Du kan velge å hoppe over å fikse skript som du ikke trenger i løpet av dette trinnet.

9. Når all ønsket metadata er klar for migrering, velg tilbake-knappen i Fiks problemer-panelet for å returnere toppnivåvisningen av Migreringsassistenten. Sjekk 2. Fiks problemer-steget i Migreringsassistenten.

Kopier data ved å bruke Migration Assistant

Kopier data hjelper deg med å overføre data som brukes av objektene du overfører. Du kan bruke en Fabric Data Factory-kopijobb for å gjøre det manuelt, eller følge disse stegene for integrasjon av kopieringsjobben i Migreringsassistenten.

1. Velg trinnet Kopier data i overføringsassistenten.

2. Velg Bruk en kopieringsjobb-knappen.

3. Skriv inn et navn på den nye jobben, og velg deretter Opprett.

4. På siden Connect to data source , skriv inn tilkoblingsopplysninger for kilden Azure Synapse Analytics (SQL DW) dedikert SQL-pool. Velg Neste.

5. På siden Velg data velger du tabellene du vil overføre. Objektmetadataene skal allerede finnes i mållageret. Velg Neste.

   

6. Velg det nye Fabric-lagerelementet fra OneLake-katalogenpå Velg datamål-siden. Velg Neste.

7. Konfigurer kolonnetilordningene for hver tabell i Tilordne til mål side. Velg Neste.

8. Velg kopieringsmodus på siden Kopier jobbmodus. Velg en engangs fullstendig datakopi (anbefales for overføring) eller en kontinuerlig trinnvis kopiering. Velg Neste.

9. Se gjennom jobbsammendraget. Velg Lagre + Kjør.

10. Når kopijobben er ferdig, sjekk 3. Kopier datasteget i Migreringsassistenten. Velg tilbake-knappen øverst for å gå tilbake til toppvisningen av Migreringsassistenten.

Omdirigere tilkoblinger

I siste steg, koble til datalastings- og rapporteringsplattformene igjen slik at tilkoblingene deres peker til ditt nye Fabric-lager.

1. Identifiser tilkoblinger på det eksisterende kildelageret.

   • For eksempel, i dedikerte SQL-pooler fra Azure Synapse Analytics, kan du finne sesjonsinformasjon, inkludert kildeapplikasjon, hvem som er tilkoblet, hvor tilkoblingen kommer fra, og om den bruker Microsoft Entra eller SQL-autentisering:

   SELECT DISTINCT CASE 
            WHEN len(tt) = 0
                THEN app_name
            ELSE tt
            END AS application_name
        ,login_name
        ,ip_address
   FROM (
        SELECT DISTINCT app_name
            ,substring(client_id, 0, CHARINDEX(':', ISNULL(client_id, '0.0.0.0:123'))) AS ip_address
            ,login_name
            ,isnull(substring(app_name, 0, CHARINDEX('-', ISNULL(app_name, '-'))), 'h') AS tt
        FROM sys.dm_pdw_exec_sessions
        ) AS a;
   

2. Oppdater tilkoblingene til rapporteringsplattformene slik at de peker til Fabric-lageret.

3. Test Fabric-lageret med litt rapportering før du omdirigerer. Utfør sammenlignings- og datavalideringstester i rapporteringsplattformene.

4. Oppdater tilkoblingene for datainnlastingsplattformer (ETL/ELT) slik at de peker til Fabric-lageret.

   • For Power BI/Fabric-rørledninger:
     1. Bruk REST-API-en for List Connections til å finne tilkoblinger til den gamle datakilden, det dedikerte SQL-utvalget for Azure Synapse Analytics.
     2. Oppdater tilkoblingene til det nye lageret ved å bruke siden Administrer tilkoblinger og gatewayer i Innstillinger.

5. Når du er ferdig, sjekk steget Omdiriger forbindelser i Migreringsassistenten.

Gratulerer! Nå er du klar til å begynne å bruke ditt nye lager.

Relatert innhold

• Infrastrukturoverføringsassistent for datalager
• Oversikt over Microsoft Fabric-overføring
• Oppgrader dine Azure Data Factory-pipelines til Fabric