Migreren met een directe verbinding naar het bronsysteem

Van toepassing op:✅ Warehouse in Microsoft Fabric

De Fabric Migration Assistant voor Data Warehouse is een migratie-ervaring waarbij je speciale SQL-pools in Azure Synapse Analytics, SQL Server en andere SQL-databaseplatforms naadloos kunt kopiëren naar Microsoft Fabric Data Warehouse.

In deze handleiding wordt u begeleid bij de stappen voor het migreren naar een fabricwarehouse vanuit een toegewezen SQL-pool of SQL Server-database van Azure Synapse Analytics door verbinding te maken met het bronsysteem.

Vereiste voorwaarden

Controleer voordat u begint of u het volgende gereed hebt:

  • Een Fabric-werkruimte met een actieve capaciteit of proefcapaciteit.
  • Maak een werkruimte of selecteer een bestaande werkruimte waarnaar u wilt migreren. De Migration Assistant maakt een nieuw magazijn voor u.
  • Verzamel de verbindingsinformatie voor je bronsysteem, inclusief de servernaam, databasenaam en authenticatiemethode.

Als u de door AI ondersteunde migratiefuncties van de Migration Assistant wilt gebruiken om migratieproblemen op te lossen, moet u Copilot activeren:

Metagegevens kopiëren

  1. Selecteer in uw Fabric-werkruimte de knop Migreren in het actiescherm van het item.

    Schermopname van de Fabric-portal van de knop Migreren in de actiebalk van het item.

  2. Selecteer in het menu Migreren naar Fabric onder Migreren naar een magazijn de tegel van het bronsysteem. För Azure Synapse Analytics, kies Azure Synapse Analytics dedicated SQL pool. Voor SQL Server, Azure SQL Database of Azure SQL Managed Instance, selecteer SQL Server database.

    Screenshot van het Fabric-portaal van de bronsysteemtegels.

  3. Op de pagina Je methode kiezen selecteert u Rechtstreeks verbinding maken met het bronsysteem en selecteert u vervolgens Volgende.

    Screenshot van het Fabric-portaal van de invoermethode voor migratie om verbinding te maken met het bronsysteem.

  4. Op Set the source geef je de servernaam, databasenaam en authenticatiegegevens in, en selecteer vervolgens Volgende.

  5. Selecteer op de pagina 'Objecten kiezen om te migreren' de objecten die u wilt migreren.

    Screenshot van het Fabric-portaal, met de stap objectselectie.

  6. Selecteer op de pagina 'Set the destination' de Fabric-werkruimte, voer een naam in voor het nieuwe magazijn en selecteer vervolgens Next.

  7. Controleer uw invoer en selecteer Migreren. De Migration Assistant maakt een nieuw warehouse-item aan en de metadata-migratie begint.

    Opmerking

    Wanneer u de Migration Assistant gebruikt, heeft het nieuwe magazijn hoofdletterongevoelige sortering, ongeacht de standaard magazijnsorteringinstelling.

    Screenshot van het Fabric-portaal van de Review-pagina van de Migration Assistant. De bron is je database en de bestemming is een nieuw magazijnitem genaamd AdventureWorks.

    Tijdens deze stap vertaalt Migration Assistant T-SQL-metagegevens naar ondersteunde T-SQL-syntaxis in Fabric Data Warehouse. Wanneer de metadata-migratie is voltooid, opent de Migration Assistant. U kunt de Migration Assistant op elk gewenst moment openen met behulp van de knop Migratie op het tabblad Start van het lint van het magazijn.

  8. Bekijk het overzicht van de metagegevensmigratie in de Migration Assistant. U ziet het aantal gemigreerde objecten en de objecten die moeten worden hersteld voordat ze kunnen worden gemigreerd.

    Schermopname van de Fabric-portal met het overzicht van de metadatamigratie door de Migration Assistant. De optie Gemigreerde objecten weergeven is gemarkeerd.

  9. Selecteer 'Show migrated objects' om de sectie uit te breiden en een lijst te zien van objecten die de Migration Assistant succesvol naar je Fabric-magazijn heeft geïmporteerd.

    Schermopname van de Fabric-portal van het overzicht van de migratie van metagegevens van de Migration Assistant en de lijst met gemigreerde objecten.

    De kolom Staat geeft aan of de metadata van het object tijdens de vertaling is aangepast om in Fabric Data Warehouse ondersteund te worden. U ziet bijvoorbeeld dat bepaalde kolomgegevenstypen of T-SQL-taalconstructies automatisch worden geconverteerd naar de constructies die worden ondersteund in Fabric. In de kolom Details ziet u de informatie over de aanpassingen die zijn aangebracht aan de objecten.

  10. Selecteer een object om de aanpassingen te zien die zijn aangebracht tijdens de migratie.

  11. Open het overzicht van de metagegevensmigratie in de volledige schermweergave voor een betere leesbaarheid. Filters toepassen om specifieke objecttypen weer te geven.

    Schermopname van het volledige scherm met de samenvatting van metagegevensmigratie door Migration Assistant van gemigreerde objecten.

Problemen oplossen met behulp van Migration Assistant

Sommige metagegevens van databaseobjecten kunnen niet worden gemigreerd. Deze fout treedt meestal op omdat de Migration Assistant de T-SQL-metagegevens niet kan vertalen naar de metagegevens die worden ondersteund in een Fabric-magazijn of omdat de vertaalde code niet kan worden toegepast op T-SQL.

We gaan deze scripts oplossen met behulp van de Migration Assistant.

  1. Selecteer de stap Problemen oplossen in de Migration Assistant om de scripts te zien die niet zijn gemigreerd.

    Schermopname van de Fabric-portal van de lijst "Problemen Oplossen" van Migration Assistant.

  2. Selecteer een databaseobject dat niet kan worden gemigreerd. Er wordt een nieuwe query geopend onder de gedeelde query'sin Explorer. Deze nieuwe query toont de metagegevensdefinitie en de aanpassingen die de Migration Assistant heeft aangebracht als automatische opmerkingen die zijn toegevoegd aan de T-SQL-code.

  3. Bekijk de opmerkingen aan het begin van het script om de aanpassingen te zien die de Migration Assistant aan het script heeft aangebracht.

  4. Bekijk en los de verbroken scripts op met behulp van de foutinformatie en documentatie.

  5. Als u Copilot wilt gebruiken voor hulp op basis van AI bij het oplossen van de fouten, selecteert u Queryfouten oplossen in de sectie Voorgestelde actie . Copilot werkt het script bij met suggesties. Fouten kunnen optreden als Copilot AI gebruikt, dus controleer codesuggesties en breng eventuele aanpassingen aan die u nodig hebt.

    Schermopname van de Fabric-portal van de Query-editor met T-SQL-query's die niet konden worden gemigreerd, en de opmerkingen en oplossingen die worden voorgesteld door Copilot.

  6. Selecteer uitvoeren om het object te valideren en te maken.

  7. Het volgende script dat moet worden opgelost, wordt geopend.

  8. Ga door met het herstellen van de rest van de scripts. U kunt ervoor kiezen om tijdens deze stap het aanpassen van scripts die u niet nodig hebt over te slaan.

  9. Wanneer alle gewenste metagegevens gereed zijn voor migratie, selecteert u de knop Vorige in het deelvenster Problemen oplossen om de weergave op het hoogste niveau van de Migration Assistant te retourneren. Controleer de 2. Problemen oplossen stap in de Migration Assistant.

Meer objecten verkrijgen om te migreren

Gebruik incrementele migratie om objecten toe te voegen of bij te werken in een bestaand Fabric-warehouse. Geef nieuwe broninvoer, selecteer alleen de objecten die je nodig hebt, en bepaal hoe je omgaat met objecten die al in de bestemming bestaan. Migreer bijvoorbeeld één groep schema's, valideer het resultaat en keer later terug om meer objecten of bijgewerkte definities te migreren.

  1. Begin de incrementele migratie vanaf een van de volgende locaties:

    • Open het warehouse, selecteer het tabblad Migratie op het lint en selecteer vervolgens Meer objecten ophalen.

      Screenshot van Meer objecten ophalen op het tabblad Migratie van een datawarehouse.

    • Vouw in de migratiesamenvatting Metadata kopiëren uit en selecteer vervolgens Meer objecten ophalen.

      Screenshot van Get more objects op de voltooide pagina Metagegevens kopiëren.

  2. Selecteer de bron, kies een invoermethode en ga door naar de stap Kies meer objecten om te migreren.

    Screenshot van de pagina 'Kies meer objecten om te migreren' van Migration Assistant.

  3. Op Kies meer objecten om te migreren selecteert u de te migreren objecten:

    • Gebruik het filter om alle bronobjecten, objecten met naamconflicten, of objecten zonder naamconflicten te bekijken.

      Screenshot van het naamgevingsconflictfilter op de pagina 'Kies meer objecten om te migreren'.

    • Objecten met namen die al in het magazijn voorkomen, tonen een waarschuwingsicoon. Als je een van deze objecten selecteert, los je het naamgevingsconflict later in de migratie op.

      Screenshot van het waarschuwingsicoon en tooltip voor een object waarvan de naam al in het warehouse staat.

    • Standaard bevat Migration Assistant directe afhankelijkheden wanneer je een object selecteert. Selecteer een objectnaam om de directe afhankelijkheden ervan te bekijken in het rechterpaneel.

      Screenshot van de directe afhankelijkheden voor een geselecteerd object.

    • Als een object in het invoerbestand geen schemanaam heeft, wijst Migration Assistant het object toe aan het standaard dbo schema.

  4. Controleer bij Review de samenvatting van bron, bestemming en objectmigratie.

    Screenshot van de samenvatting van bron-, bestemmings- en objectmigratie op de Review-pagina.

  5. Selecteer Migreren. Migration Assistant vertaalt de geselecteerde objecten en maakt objecten aan zonder naamconflicten. Objecten met naamconflicten blijven in behandeling totdat je elk conflict hebt opgelost.

Conflicten oplossen en objecten repareren

Wanneer je een bestaand warehouse bijwerkt via incrementele migratie, kun je met conflictoplossing kiezen welke objectdefinitie je wilt behouden.

  1. Bekijk in de Migration Assistant-samenvatting het aantal Op te lossen conflicten. Vouw 2. Conflicten oplossen en objecten repareren uit.

    Screenshot van het aantal op te lossen conflicten en de stap Conflicten oplossen en objecten repareren.

  2. Bekijk op het tabblad Conflicten de objecten die naamconflicten hebben.

    Screenshot van de objecten op het tabblad Conflicten.

  3. Selecteer een object om de SQL-definities te vergelijken. De bestaande definitie verschijnt links, en de inkomende vertaalde definitie verschijnt rechts.

    Screenshot waarin de bestaande en binnenkomende SQL-definities voor een object worden vergeleken.

  4. Kies een van de volgende acties voor het object:

    • Bestaande behouden: Behoud de bestaande objectdefinitie en verwerp de binnenkomende vertaalde definitie.
    • Binnenkomend behouden: Vervang de bestaande objectdefinitie door de binnenkomende vertaalde definitie. Bevestig de actie wanneer u hierom wordt gevraagd.
    • Hernoem inkomend: Maak het inkomende object aan met een andere naam en behoud het bestaande object.

    Screenshot van de acties Keep incoming, Keep existing en Rename incoming voor een object.

    Als je Binnenkomend hernoemen selecteert, voer dan het schema en de objectnaam in en selecteer vervolgens Hernoemen.

    Screenshot van het dialoogvenster om het gemigreerde object te hernoemen.

  5. Optioneel: Bewerk het binnenkomende script voordat je het bewaart. Om je bewerkingen weg te gooien en het vertaalde script te herstellen, selecteer Reset incoming.

    Screenshot van Reset incoming boven een bewerkte inkomende SQL-definitie.

  6. Om de inkomende definitie toe te passen, selecteer je Inkomende behouden (bestaande overschrijven). Als je het binnenkomende script hebt bewerkt, kies dan in plaats daarvan Overschrijven bestaand .

    Warning

    Voor een tabel verwijdert en maakt Keep incoming de bestaande tabel opnieuw aan. Als de tabel data bevat, veroorzaakt deze actie gegevensverlies en moet je de data opnieuw laden. Als Migration Assistant het binnenkomende script niet kan toepassen, herstelt het de vorige objectdefinitie, maar herstelt het verwijderde gegevens niet.

    Selecteer voor een tabel Tabel vervangen om de actie te bevestigen.

    Screenshot van het bevestigingsdialoogvenster voor het vervangen van een bestaande tabel.

  7. Wanneer het script succesvol draait, markeert Migration Assistant het conflict als opgelost.

    Screenshot die laat zien dat het conflict van een object is opgelost.

  8. Herhaal deze stappen voor elk object met een naamconflict. Om dezelfde actie op meerdere objecten toe te passen, selecteer je de objecten en selecteer je vervolgens Bestaande behouden of Inkomende behouden.

    Screenshot van de bulkacties Inkomende behouden en Bestaande behouden.

  9. Bevestig dat elk succesvol verwerkt object als opgelost is gemarkeerd. Als een object meer wijzigingen nodig heeft, bekijk dan de informatie in het rechterpaneel.

Gegevens kopiëren met Behulp van Migration Assistant

Met het kopiëren van gegevens kunt u gegevens migreren die worden gebruikt door de objecten die u migreert. U kunt een Fabric Data Factory-kopieertaak gebruiken om dit handmatig te doen of volg deze stappen voor de integratie van de kopieertaak in de Migration Assistant.

  1. Selecteer de stap Gegevens kopiëren in de Migration Assistant.

  2. Selecteer Een kopieertaak gebruiken.

  3. Wijs een naam toe aan de nieuwe taak en selecteer Maken.

  4. Op de pagina Connect to data source geeft u de verbindingsgegevens van de bron. Kies Volgende.

  5. Selecteer op de pagina Gegevens kiezen de tabellen die u wilt migreren. De objectmetagegevens moeten al aanwezig zijn in het doelwarehouse. Kies Volgende.

    Schermopname van de Fabric-portal van het deelvenster Gegevens kiezen, met enkele tabellen geselecteerd.

  6. Op de pagina Gegevensbestemming kiezen kiest u uw nieuwe Fabric-magazijnitem uit de OneLake-catalogus. Kies Volgende.

  7. Configureer op de pagina Toewijzen aan doel de kolomtoewijzingen van elke tabel. Kies Volgende.

  8. Op de pagina Kopieerwerk kies je de kopieermodus. Kies een eenmalige volledige gegevenskopie (aanbevolen voor migratie) of een continue incrementele kopie. Kies Volgende.

  9. Bekijk de taaksamenvatting. Selecteer Opslaan en uitvoeren.

  10. Wanneer de kopieertaak is voltooid, controleert u de 3. Kopiegegevens-stap in de Migration Assistant. Selecteer de terugknop om terug te keren naar het bovenste overzicht van de Migration Assistant.

Verbindingen omleiden

Herstel in de laatste stap de verbindingen van de platforms voor gegevensladen en -rapportage, zodat hun verbindingen naar uw nieuwe Fabric data warehouse wijzen.

  1. Identificeer verbindingen in uw bestaande bronmagazijn.

    • Op een SQL-database in elke Microsoft SQL-instantie kun je dynamische beheerweergaven gebruiken, bijvoorbeeld:
    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
    
    • In Azure Synapse Analytics speciale SQL-pools kun je sessie-informatie vinden, inclusief de bronapplicatie, verbonden gebruiker, verbindingsoorsprong en authenticatiemethode:
    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. Werk de verbindingen met uw rapportageplatforms bij zodat deze verwijzen naar uw Fabric-magazijn.

  3. Test het Fabric-magazijn met enkele rapportages voordat u het omleidt. Voer vergelijkings- en gegevensvalidatietests uit op uw rapportageplatforms.

  4. Werk de verbindingen voor het laden van gegevens (ETL/ELT)-platforms bij zodat deze verwijzen naar uw Fabric-magazijn.

    • Voor Power BI/Fabric-pijplijnen:
      • Gebruik de REST API List Connections om verbindingen met uw oude gegevensbron te vinden, de toegewezen SQL-pool van Azure Synapse Analytics.
      • Werk de verbindingen naar de nieuwe Fabric Data Warehouse bij door de ervaring Verbindingen en Gateways beheren te gebruiken onder de instellingen.
  5. Als dit klaar is, controleer dan de stap Reroute-verbindingen in de Migration Assistant.

Gefeliciteerd! U bent nu klaar om het magazijn te gaan gebruiken.

Schermopname van de Fabric portal Migratieassistent met alle vier de taakstappen voltooid en een felicitaties pop-up.