Migrer ved å laste opp en fil med Fabric Migration Assistant

Gjelder for:✅ Warehouse i Microsoft Fabric

Fabric Migration Assistant gir en veiledet opplevelse for å migrere kildemetadata og data til Fabric datalager. Denne guiden forklarer hvordan man migrerer metadata fra:

• Azure Synapse Analytics eller SQL Server ved at bruge en DACPAC-fil
• Teradata ved å bruke et .zip arkiv av .sql og/eller .bteq filer

Forutsetninger

Før du begynner, må du kontrollere at du har følgende klart:

• 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 kildemetadatafil i ett av disse formatene:
  • En DACPAC-fil extrahert fra Azure Synapse Analytics eller SQL Server. En DACPAC inneholder metadata for databaseobjekter, inkludert tabeller, visninger, lagrede prosedyrer og funksjoner.
    • For å lage en DACPAC fra Azure Synapse Analytics, se Extract a Data-tier Application (DAC) from an Azure Synapse dedicated SQL pool in Visual Studio 2022.
    • Du kan også bruke Generate Scripts Wizard i SQL Server Management Studio (SSMS),SDK-lignende databaseprosjekter med Visual Studio Code, eller kommandolinjeverktøyet SqlPackage.
  • Et zip-arkiv av Teradata .sql og/eller .bteq filer som inneholder objektdefinisjoner og avhengigheter for migreringen.

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 leietakeren eller kapasiteten din befinner seg utenfor USA eller Frankrike, er Copilot deaktivert som standard med mindre din Fabric-tenant-administrator aktiverer at dataene sendt til Azure OpenAI kan behandles utenfor kapasitetens geografiske region, samsvarsgrense eller nasjonale skyinstans-leietakerinnstilling i OneLake-katalogen>Govern>Configurations>Tenant-innstillinger.
• 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 kildemenyen Migrate to Fabric, under Migrate to a warehouse, velg kildesystemflisen:

   • For Azure Synapse Analytics, kies Azure Synapse Analytics dedicated SQL pool.
   • For SQL Server, Azure SQL Database eller Azure SQL Managed Instance, velg SQL Server database.
   • For Teradata, velg Teradata (Forhåndsvisning).

   

3. Hvis siden Velg din metode dukker opp, velg Last opp en fil med kildemetadata, og velg deretter Neste.

   

4. På Sett kilden, velg Velg fil, velg kildefilen, og velg deretter Neste.

   

5. På siden Velg objekter å migrere , velg objekter som skal migreres.

   

6. På siden Sett destinasjonen, oppgi navnet på Fabric-arbeidsområdet og det nye lagerobjektet du ønsker å migrere til. Velg Neste.

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

   Note

   Når du bruker Migration Assistant, har det nye lageret en mellombokstavssensitiv sortering, uavhengig av standard lagersortering.

   

   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.

8. 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.

   

9. 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 Migration Assistant gjorde på objektene.

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

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

    

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 Fabric datalager, eller at den oversatte koden ikke gjaldt for T-SQL.

La oss løse disse skriptene med hjelp fra overføringsassistenten.

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.

Få flere objekter å migrere

Bruk inkrementell migrasjon for å legge til eller oppdatere objekter i et eksisterende Fabric-lager. Oppgi ny kildeinndata, velg kun objektene du trenger, og velg hvordan du håndterer objekter som allerede finnes i destinasjonen. For eksempel, migrer én gruppe skjemaer, valider resultatet, og returner deretter senere for å migrere flere objekter eller oppdaterte definisjoner.

1. Start den inkrementelle migrasjonen fra en av følgende lokasjoner:

   • Åpne lageret, velg Migrasjonsfanen på båndet, og velg deretter Hent flere objekter.

     

   • I migrasjonssammendraget, utvid Kopier metadata, og velg deretter Hent flere objekter.

     

2. Velg kilden, velg en inndatametode, og fortsett til steget Velg flere objekter for migrering .

   

3. På Velg flere objekter å migrere, velg objektene som skal migreres:

   • Bruk filteret for å se alle kildeobjekter, objekter med navnekonflikter, eller objekter uten navnekonflikter.

     

   • Objekter hvis navn allerede finnes i lageret viser et advarselsikon. Hvis du velger ett av disse objektene, løser du navnekonflikten senere i migreringen.

     

   • Som standard inkluderer Migration Assistant direkte avhengigheter når du velger et objekt. Velg et objektnavn for å se dets direkte avhengigheter i høyre rute.

     

   • Hvis et objekt i inndatafilen ikke har et skjemanavn, tildeler Migration Assistant objektet til standardskjemaetdbo.

4. Ved gjennomgang, verifiser oppsummeringen av kilde, destinasjon og objektmigrering.

   

5. Velg Migrer. Migration Assistant oversetter de valgte objektene og lager objekter som ikke har navnekonflikter. Objekter med navnekonflikter forblir uavhengige til du har løst hver konflikt.

Løs konflikter og fiks objekter

Når du oppdaterer et eksisterende lager gjennom inkrementell migrering, lar konfliktløsning deg velge hvilken objektdefinisjon du skal beholde.

1. I Migration Assistant-oppsummeringen, se gjennom konfliktene for å løse tellingen. Utvid 2. Løs konflikter og fiks objekter.

   

2. På fanen Konflikter kan du gå gjennom objektene som har navnekonflikter.

   

3. Velg et objekt for å sammenligne dets SQL-definisjoner. Den eksisterende definisjonen vises til venstre, og den innkommende oversatte definisjonen vises til høyre.

   

4. Velg en av følgende handlinger for objektet:

   • Fortsett å eksistere: Behold den eksisterende objektdefinisjonen og kast den innkommende oversatte definisjonen.
   • Fortsett å komme: Erstatt den eksisterende objektdefinisjonen med den innkommende oversatte definisjonen. Bekreft handlingen når du blir bedt om det.
   • Omdøp innkommende: Lag det innkommende objektet med et annet navn og behold det eksisterende objektet.

   

   Hvis du velger Omdøp innkommende, skriv inn skjemaet og objektnavnet, og velg deretter Omdøp.

   

5. Valgfritt: Rediger det innkommende skriptet før du beholder det. For å forkaste redigeringene dine og gjenopprette det oversatte skriptet, velg Reset incoming.

   

6. For å anvende definisjonen av innkommende bok, velg Hold innkommende (overskriv eksisterende). Hvis du redigerte det innkommende skriptet, velg Overskriv eksisterende i stedet.

   Advarsel!

   For en tabell, behold innkommende drops og gjenskaper den eksisterende tabellen. Hvis tabellen inneholder data, forårsaker denne handlingen datatap, og du må laste dataene inn igjen. Hvis Migration Assistant ikke kan bruke det innkommende skriptet, gjenoppretter det forrige objektdefinisjon, men det gjenoppretter ikke tapte data.

   For en tabell, velg Erstatt tabell for å bekrefte handlingen.

   

7. Når manuset fungerer som det skal, markerer Migration Assistant konflikten som løst.

   

8. Gjenta disse stegene for hvert objekt med en navnekonflikt. For å bruke samme handling på flere objekter, velg objektene, og velg deretter Behold eksisterende eller Fortsett innkommende.

   

9. Bekreft at hvert vellykket behandlet objekt er markert som løst. Hvis et objekt trenger flere endringer, se gjennom informasjonen i høyre rute.

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 kopijobb.

3. Tilordne et navn til den nye jobben, og velg deretter Opprett.

4. På siden Koble til datakilde, oppgi tilkoblingsinformasjonen for kildesystemet ditt. Velg Neste.

5. På siden Velg data, velg tabellene du vil migrere. 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, tilkoblet bruker, tilkoblingsopprinnelse og autentiseringsmetode:

   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