Migrera med en DACPAC-fil eller SQL-filer

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

Fabric Migration Assistant för Data Warehouse är en migreringsupplevelse som du kan använda för att kopiera dedikerade SQL-pooler i Azure Synapse Analytics, databaser i SQL Server och databaser från andra SQL Database Engine plattformar sömlöst till Fabric Data Warehouse.

Den här guiden vägleder dig genom stegen för att migrera till Fabric Data Warehouse med hjälp av en DACPAC-fil eller en zip med .sql filer.

Förutsättningar

Innan du börjar kontrollerar du att följande objekt är klara:

• 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 fil som innehåller metadata för databasobjekt, inklusive schemat för tabeller, vyer, lagrade procedurer, funktioner med mera.

  Du har flera alternativ för källfilen:

  • DACPAC-fil som extraherats från ditt befintliga lager. En DACPAC-fil (programpaket på datanivå) skapas från SQL-databasprojekt.
    • Du kan använda databasprojekt i SDK-format med Visual Studio Code eller kommandoradsverktyget SqlPackage.
    • Information om hur du skapar en DAC i Visual Studio 2022 från Azure Synapse Analytics med SQL Server Data Tools finns i Extract a Data-tier Application (DAC) från en Azure Synapse dedikerad SQL-pool i Visual Studio 2022.
  • En komprimerad zip med .sql filer som innehåller databasobjektdefinitioner. Du kan extrahera .sql filer på flera olika sätt.
    • Om du vill generera skript i SSMS kan du använda guiden Generera skript.
    • Du kan också använda SqlPackage Script.
  • En komprimerad zip för SQL-databasprojektet.
    • Information om hur du skapar ett SQL-databasprojekt i Visual Studio Code finns i SQL Database Projects.

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 klientorganisation eller kapacitet ligger utanför USA eller Frankrike inaktiveras Copilot som standard såvida inte infrastrukturadministratören aktiverar data som skickas till Azure OpenAI kan bearbetas utanför kapacitetens geografiska region, efterlevnadsgräns eller nationella klientinställning för molninstanser i infrastrukturadministratörsportalen .
• 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 Migrera till Fabric-källmenyn, under Migrera till ett lager, välj källsystemruta.

   • Om du migrerar från en dedikerad SQL-pool för Azure Synapse Analytics väljer du den dedikerade SQL-poolpanelen för Azure Synapse Analytics .
   • Om du migrerar från någon annan T-SQL-databas, till exempel en databas i SQL Server, Azure SQL Database eller Azure SQL Managed Instance, väljer du sql Server-databaspanelen .

   

3. På sidan Välj metod väljer du Ladda upp en fil med källmetadata och väljer Nästa.

4. Välj Välj fil och ladda upp DACPAC-filen i ditt källdatalager eller en zip med .sql filer som extraherats från ditt källdatalager. När uppladdningen är klar väljer du Nästa.

   

5. På sidan Ange målet anger du namnet på den nya Fabric-arbetsytan, det nya warehouse-objekt som du vill migrera till och väljer sorteringsordning. Klicka på Nästa.

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

   

   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 Information visar information om de justeringar som portalen har gjort för 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.

    

11. Du kan också välja menyn Exportera för att ladda ned en migreringssammanfattning som en Excel-fil eller en CSV.

    • Den nedladdade Excel-filen är en helt strukturerad arbetsbok med två kalkylblad: Migrerade objekt och objekt som ska åtgärdas. Den är MIP-kompatibel och överensstämmer med organisationens känslighetsetiketter.
    • CSV är lätt och verktygsvänlig.

    

    Varje exporterad fil ger en strukturerad och omfattande vy över dina migreringsresultat, inklusive:

    Fältnamn	Beskrivning	Exempelvärden
    Objektnamn	Namn på SQL-objekt
    Objekttyp	SQL-objekttyper	Tabell, vy, lagrad procedur, funktion
    Tillstånd	Översättningstillstånd	Justerad: Kompatibla uppdateringar för infrastrukturlager tillämpas Inte justerad: Ingen ändring i det ursprungliga skriptet
    Detaljer	Lista över justeringar som tillämpas eller felmeddelanden
    Typ av fel	Typ av översättningsfel	Översättningsmeddelande, översättningsfel, tillämpningsfel

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

Vissa metadata för databasobjekt kan inte migreras. Det här felet beror vanligtvis på att Migreringsassistenten inte kunde översätta T-SQL-metadata till dem som stöds i ett infrastrukturlager eller att den översatta koden inte kunde tillämpas på T-SQL.

Å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-knappen.

3. Ange ett namn för det nya jobbet och välj sedan Skapa.

4. På sidan Anslut till datakälla anger du autentiseringsuppgifter för anslutning för källlagret. Klicka på Nästa.

5. På sidan Välj data väljer du de tabeller som du vill migrera. Metadata för objektet bör redan existera i mållagret. 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ällprogram, vem som är ansluten, var anslutningen kommer ifrån och om den använder 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. 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
• Uppgradera dina Azure Data Factory-pipelines till Fabric