Migrera genom att ladda upp en fil med Fabric Migration Assistant

gäller för:✅ Warehouse i Microsoft Fabric

Fabric Migration Assistant erbjuder en vägledd upplevelse för att migrera källmetadata och data till Fabric Data Warehouse. Denna guide förklarar hur man migrerar metadata från:

• Azure Synapse Analytics eller SQL Server genom att använda en DACPAC-fil
• Teradata med ett .zip-arkiv med .sql- och/eller .bteq-filer

Förutsättningar

Kontrollera att du har följande redo innan du börjar:

• En Fabric-arbetsyta med en aktiv kapacitet eller testkapacitet.
• Skapa en arbetsyta eller välj en befintlig arbetsyta som du vill migrera till. Migreringsassistenten skapar ett nytt lager åt dig.
• En källmetadatafil i ett av dessa format:
  • En DACPAC-fil extraherad från Azure Synapse Analytics eller SQL Server. En DACPAC innehåller metadata för databasobjekt, inklusive tabeller, vyer, lagrade procedurer och funktioner.
    • För att skapa en DACPAC från Azure Synapse Analytics, se Extract a Data-tier Application (DAC) from an Azure Synapse dedicated SQL pool in Visual Studio 2022.
    • Du kan också använda Generate Scripts Wizard i SQL Server Management Studio (SSMS),SDK-liknande databasprojekt med Visual Studio Code, eller kommandoradsverktyget SqlPackage.
  • Ett zip-arkiv av Teradata .sql och/eller .bteq filer som innehåller objektdefinitioner och beroenden för migreringen.

Om du vill använda ai-assisterad migreringsfunktioner i Migration Assistant för att åtgärda migreringsproblem måste du aktivera Copilot:

• Administratören måste aktivera klientväxeln innan du börjar använda Copilot. Mer information finns i Klientinställningar för Copilot.
• Din F2- eller P1-kapacitet måste finnas i någon av de regioner som anges i Tillgänglighet för infrastrukturresurser.
• Om din hyresgäst eller kapacitet befinner sig utanför USA eller Frankrike är Copilot inaktiverad som standard, om inte din Fabric-tenantadministratör tillåter att data som skickas till Azure OpenAI kan behandlas utanför din kapacitets geografiska region, efterlevnadsgräns eller nationella molninstans-tenant-inställning i OneLake-katalogen>Styr>konfigurationer>hyresgästinställningar.
• Copilot i Microsoft Fabric stöds inte på utvärderings-SKU:er. Endast betalda SKU:er (F2 eller högre, eller P1 eller högre) stöds just nu.
• Mer information finns i översikten över Copilot i Fabric och Power BI.

Kopiera metadata

1. I din Fabric arbetsyta väljer du knappen Migrera i åtgärdsområdet för objektet.

   

2. I källmenyn Migrate to Fabric, under Migrate to a warehouse, välj källkodssystemrutan:

   • För Azure Synapse Analytics, välj Azure Synapse Analytics dedicated SQL pool.
   • För SQL Server, Azure SQL Database eller Azure SQL Managed Instance, välj SQL Server database.
   • För Teradata, välj Teradata (Förhandsvisning).

   

3. Om sidan Välj din metod dyker upp, välj Ladda upp en fil med källmetadata och välj sedan Nästa.

   

4. När du väljer Sätt källkoden, välj Välj fil, välj källfilen och välj sedan Nästa.

   

5. På sidan Sätt destinationen, ange namnet på Fabric-arbetsytan och det nya lagerobjektet du vill migrera till. Klicka på Nästa.

6. Granska dina indata och välj Migrera. Migreringsassistenten skapar ett nytt lagerobjekt och startar metadatamigreringen.

   Note

   När du använder Migration Assistant har det nya lagret skiftlägesokänslig sortering, oavsett standardinställningen för lagersortering.

   

   Under det här steget översätter Migration Assistant T-SQL-metadata till T-SQL-syntax som stöds i Fabric Data Warehouse. När metadatamigreringen är klar öppnas Migration Assistant. Du kan när som helst komma åt Migreringsassistenten med hjälp av knappen Migrering på fliken Start i menyfliksområdet för informationslagret.

7. Granska sammanfattningen av metadatamigrering i Migration Assistant. Du ser antalet migrerade objekt och de objekt som måste åtgärdas innan de kan migreras.

   

8. Välj Visa migrerade objekt för att expandera avsnittet och se en lista över objekt som du har migrerat till Fabric-lagret.

   

   Kolumnen Tillstånd anger om Migration Assistant justerade objektets metadata under översättningen till Fabric Data Warehouse. Till exempel kan du se att vissa kolumndatatyper eller T-SQL-språkkonstruktioner automatiskt konverteras till de som stöds i Fabric. Kolumnen Detaljer visar informationen om de justeringar som Migration Assistant gjorde på objekten.

9. Markera ett objekt för att se de justeringar som Migration Assistant gjorde under migreringen.

10. Öppna sammanfattningen av metadatamigrering i helskärmsvyn för bättre läsbarhet. Använd filter för att visa specifika objekttyper.

    

Åtgärda problem med hjälp av Migration Assistant

Vissa metadata för databasobjekt kan inte migreras. Ofta uppstår detta fel eftersom Migration Assistant inte kunde översätta T-SQL-metadata till de som stöds i Fabric Data Warehouse eller att den översatta koden inte kunde tillämpas på T-SQL.

Nu ska vi åtgärda dessa skript med hjälp av Migration Assistant.

1. Välj steget Åtgärda problem i Migreringsassistenten för att se skripten som inte kunde migreras.

   

2. Välj ett databasobjekt som inte kunde migreras. En ny fråga öppnas under Delade frågor i Utforskaren. Den här nya frågan visar metadatadefinitionen och de justeringar som gjordes i den som automatiska kommentarer som lagts till i T-SQL-koden.

3. Granska kommentarerna i början av skriptet för att se de justeringar som gjordes i skriptet.

4. Granska och åtgärda de brutna skripten med hjälp av felinformationen och dokumentationen.

5. Om du vill använda Copilot för AI-stöd för att åtgärda felen väljer du Åtgärda frågefel i avsnittet Föreslagen åtgärd . Copilot uppdaterar skriptet med förslag. Misstag kan inträffa när Copilot använder AI, så verifiera kodförslag och gör eventuella justeringar du behöver.

   

6. Välj Kör för att verifiera och skapa objektet.

7. Nästa skript som ska åtgärdas öppnas.

8. Fortsätt att åtgärda resten av skripten. Du kan välja att hoppa över att åtgärda skript som du inte behöver under det här steget.

9. När alla önskade metadata är klara för migrering väljer du bakåtknappen i fönstret Åtgärda problem för att returnera vyn på den översta nivån i Migration Assistant. Kontrollera Steg 2: Åtgärda problem i Migration Assistant.

Kopiera data med hjälp av Migration Assistant

Kopiera data hjälper dig att migrera data som används av de objekt som du migrerar. Du kan använda ett Fabric Data Factory-kopieringsjobb för att göra det manuellt eller följa dessa steg för kopieringsjobbintegrering i Migration Assistant.

1. Välj steget Kopiera data i Migreringsassistenten.

2. Välj Använd ett kopieringsjobb.

3. Tilldela ett namn till det nya jobbet och välj sedan Skapa.

4. På sidan Koppla till datakällan , ange anslutningsuppgifterna för ditt källsystem. Klicka på Nästa.

5. På sidan Välj data , välj de tabeller du vill migrera. Klicka på Nästa.

   

6. På sidan Välj datamål väljer du ditt nya Fabric-lagerobjekt från OneLake-katalogen. Klicka på Nästa.

7. På sidan Mappa till mål konfigurerar du varje tabells kolumnmappningar. Klicka på Nästa.

8. På sidan Kopiera jobbläge väljer du kopieringsläget. Välj en engångskopia av fullständiga data (rekommenderas för migrering) eller en kontinuerlig inkrementell kopiering. Klicka på Nästa.

9. Granska jobbsammanfattningen. Välj Spara + Kör.

10. När kopieringsjobbet är klart kontrollerar du 3. Kopiera data i Migration Assistant. Välj bakåtknappen längst upp för att återgå till vyn på den översta nivån i Migration Assistant.

Omdirigera anslutningar

I det sista steget återansluter du datainläsnings- och rapporteringsplattformarna så att deras anslutningar pekar mot ditt nya Fabric-lager.

1. Identifiera anslutningar i ditt befintliga källlager.

   • På en SQL Server instans kan du använda dynamiska hanteringsvyer, till exempel:

   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 dedikerade SQL-pooler kan du hitta sessionsinformation, inklusive källapplikationen, ansluten användare, anslutningsursprung och autentiseringsmetod:

   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. Uppdatera anslutningarna till dina rapporteringsverktyg så att de pekar på ditt Fabric-lager.

3. Testa lagret Fabric med viss rapportering innan du omdirigerar. Utför jämförelse- och dataverifieringstester på dina rapporteringsplattformar.

4. Uppdatera anslutningarna för plattformar för datainläsning (ETL/ELT) så att de pekar på ditt datalager i Fabric.

   • För Power BI/Fabric-pipelines:
     1. Använd REST-API:t List Connections för att hitta anslutningar till din gamla datakälla, den dedikerade SQL-poolen för Azure Synapse Analytics.
     2. Uppdatera anslutningarna till det nya lagret med hjälp av sidan Hantera anslutningar och gatewayer i Inställningar.

5. När du är klar kontrollerar du steget Omdirigera anslutningar i Migration Assistant.

Grattis! Nu är du redo att börja använda ditt nya lager.

Relaterat innehåll

• Infrastrukturmigreringsassistenten för datalager
• Översikt över Microsoft Fabric-migrering