Migrer med en DACPAC-fil eller SQL-filer

Gjelder for: ✅ Warehouse i Microsoft Fabric

Fabric Migration Assistant for datalager er en migreringsopplevelse du kan bruke til å kopiere dedikerte SQL-pooler i Azure Synapse Analytics, databaser i SQL Server og databaser fra annen SQL databasemotor plattformer sømløst inn i Fabric datalager.

Denne guiden guider deg gjennom stegene for å migrere til Fabric datalager ved å bruke en DACPAC-fil eller en zip av .sql filer.

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.

• En fil som inneholder metadata for databaseobjekter, inkludert skjema for tabeller, visninger, lagrede prosedyrer, funksjoner og mer.

  Du har flere alternativer for kildefilen:

  • DACPAC-fil hentet ut fra ditt eksisterende lager. En DACPAC (data-tier application package)-fil bygges fra SQL-databaseprosjekter.
    • Du kan bruke SDK-lignende databaseprosjekter med Visual Studio Code eller kommandolinjeverktøyet SqlPackage.
    • For å opprette en DAC i Visual Studio 2022 fra Azure Synapse Analytics med SQL Server Data Tools, se Extract a Data-tier Application (DAC) from an Azure Synapse dedicated SQL pool in Visual Studio 2022.
  • En komprimert zip av .sql filer som inneholder definisjoner av databaseobjekter. Det finnes flere måter å pakke ut .sql filer på.
    • For å generere skript i SSMS kan du bruke Generate Scripts Wizard.
    • Du kan også bruke SqlPackage Script.
  • En komprimert zip av SQL-databaseprosjektet.
    • For å opprette et SQL-databaseprosjekt i Visual Studio Code, se SQL Database Projects.

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 kildevarehuset ditt, eller en zip-pakke med .sql filer hentet ut fra kildevarehuset ditt. Når opplastingen er ferdig, velg Neste.

   

5. På siden Sett destinasjon, skriv inn navnet på det nye Fabric-arbeidsområdet, det nye lagervaret du vil migrere til, og velg sorteringen. Velg Neste.

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

   

   I dette steget oversetter Migration Assistant T-SQL-metadata til støttet T-SQL-syntaks i Fabric datalager. 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 datalager. 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 datalager 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 Koble til datakilden , skriv inn tilkoblingsopplysninger for kildevarehuset. 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.

   • På en SQL Server-instans kan du bruke dynamiske administrasjonsvisninger, for eksempel:

   SELECT 
       s.program_name
   , s.login_name
   , c.client_net_address
   FROM sys.dm_exec_sessions AS s 
   INNER JOIN sys.dm_exec_connections AS c 
   ON s.session_id = c.session_id
   WHERE s.session_id >= 50 --retrieve only user spids
   and s.session_id <> @@SPID; --ignore myself
   

   • I Azure Synapse Analytics dedikerte SQL-pooler 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