Migration mit direkter Verbindung zum Quellsystem

Gilt für:✅ Warehouse in Microsoft Fabric

Der Fabric Migration Assistant für Data Warehouse ist eine Migrationserfahrung, bei der dedizierte SQL-Pools in Azure Synapse Analytics, SQL Server und anderen SQL-Datenbankplattformen nahtlos in Microsoft Fabric Data Warehouse kopiert werden können.

Dieser Leitfaden führt Sie durch die Schritte zum Migrieren zu einem Fabric Warehouse aus einem dedizierten Azure Synapse Analytics SQL-Pool oder einer SQL Server-Datenbank, indem Sie eine Verbindung mit dem Quellsystem herstellen.

Voraussetzungen

Bevor Sie beginnen, sollten Sie sicherstellen, dass Folgendes bereit ist:

  • Fabric-Arbeitsbereich mit aktiver Kapazität oder Testkapazität
  • Klicken Sie auf Arbeitsbereich erstellen, oder wählen Sie einen vorhandenen Arbeitsbereich aus. Der Migrations-Assistent erstellt ein neues Lager für Sie.
  • Sammeln Sie die Verbindungsinformationen für Ihr Quellsystem, einschließlich Servernamen, Datenbankname und Authentifizierungsmethode.

Um die KI-unterstützten Migrationsfeatures des Migrations-Assistenten zum Beheben von Migrationsproblemen zu verwenden, müssen Sie Copilot aktivieren:

Metadaten kopieren

  1. Wählen Sie in Ihrem Fabric-Arbeitsbereich die Schaltfläche Migrieren in der Aktionsleiste für Elemente aus.

    Screenshot des Fabric-Portals mit der Schaltfläche „Migrieren” im Elementaktionssatz.

  2. Wählen Sie im Menü Migrate to Fabric unter Zu einem Lager migrieren die Quellsystemkachel aus. Vir Azure Synapse Analytics, kies Azure Synapse Analytics dedicated SQL pool. Für SQL Server, Azure SQL-Datenbank oder Azure SQL Managed Instance wählen Sie SQL Server Datenbank.

    Screenshot vom Fabric-Portal der Quellsystem-Tiles.

  3. Auf der Seite "Wähle deine Methode" wählen Sie "Direkt mit dem Quellsystem verbinden" und wählen Sie dann Nächst.

    Screenshot aus dem Fabric-Portal der Eingabemethode für die Migration zur Verbindung mit dem Quellsystem.

  4. Bei Set the Source gib du den Servernamen, den Datenbanknamen und die Authentifizierungsdaten an und wähle dann Next aus.

  5. Auf der Seite "Objekte zum Migrieren auswählen" wählen Sie Objekte zum Migrieren aus.

    Screenshot aus dem Fabric-Portal, der den Objektauswahlschritt zeigt.

  6. Auf der Seite "Set the destination" wählen Sie den Fabric-Arbeitsbereich aus, geben Sie einen Namen für das neue Lager ein und wählen Sie dann Next.

  7. Überprüfen Sie Ihre Eingaben, und wählen Sie Migrieren aus. Der Migration Assistant erstellt einen neuen Lagerposten und die Metadaten-Migration beginnt.

    Hinweis

    Wenn Sie den Migrations-Assistenten verwenden, weist das neue Lager unabhängig von der Standardeinstellung für die Lagersortierung die Sortierung ohne Groß-/Kleinschreibung auf.

    Screenshot aus dem Fabric-Portal von der Überprüfungsseite des Migrations-Assistenten. Die Quelle ist Ihre Datenbank, und das Ziel ist ein neues Warehouseelement namens AdventureWorks.

    In diesem Schritt übersetzt der Migrations-Assistent T-SQL-Metadaten in unterstützte T-SQL-Syntax in Fabric Data Warehouse. Wenn die Metadaten-Migration abgeschlossen ist, öffnet sich der Migration Assistant. Sie können jederzeit auf den Migrations-Assistenten zugreifen, indem Sie die Schaltfläche " Migration " auf der Registerkarte "Start" des Menübands "Lager" verwenden.

  8. Überprüfen Sie die Zusammenfassung der Metadatenmigration im Migration Assistant. Sie sehen die Anzahl der migrierten Objekte und die Objekte, die behoben werden müssen, bevor sie migriert werden können.

    Screenshot des Fabric-Portals mit der Zusammenfassung der Metadatenmigration im Migration Assistant. Die Option „Migrierte Objekte anzeigen” ist hervorgehoben.

  9. Wählen Sie Migrierte Objekte anzeigen, um den Abschnitt zu erweitern und eine Liste der Objekte anzuzeigen, die der Migration Assistant erfolgreich in Ihr Fabric-Warehouse migriert hat.

    Screenshot des Fabric-Portals mit der Zusammenfassung der Metadatenmigration im Migration Assistant und der Liste der migrierten Objekte.

    Die Spalte Zustand zeigt an, ob die Metadaten des Objekts während der Übersetzung angepasst wurden, um in Fabric Data Warehouse unterstützt zu werden. Beispielsweise können Sie sehen, dass bestimmte Spaltendatentypen oder T-SQL-Sprachkonstrukte automatisch in die in Fabric unterstützten konvertiert werden. In der Spalte Details werden Informationen zu den Anpassungen angezeigt, die an den Objekten vorgenommen wurden.

  10. Wählen Sie ein beliebiges Objekt aus, um die Anpassungen anzuzeigen, die während der Migration vorgenommen wurden.

  11. Öffnen Sie die Metadatenmigrationszusammenfassung in der Vollbildansicht, um die Lesbarkeit zu verbessern. Anwenden von Filtern zum Anzeigen bestimmter Objekttypen.

    Screenshot der Vollbildansicht der Metadatenmigrationszusammenfassung des Migrations-Assistenten für migrierte Objekte.

Beheben von Problemen mithilfe des Migrations-Assistenten

Einige Datenbankobjektmetadaten können möglicherweise nicht migriert werden. Dieser Fehler tritt häufig auf, da der Migrations-Assistent die T-SQL-Metadaten nicht in diejenigen übersetzen kann, die in einem Fabric Warehouse unterstützt werden oder der übersetzte Code nicht auf T-SQL angewendet werden kann.

Lassen Sie uns diese Skripte mithilfe des Migration Assistant beheben.

  1. Wählen Sie den Schritt Probleme behandeln im Migration Assistant aus, um die Skripts anzuzeigen, die nicht migriert werden konnten.

    Screenshot des Fabric-Portals mit der Liste „Probleme behandeln” im Migration Assistant.

  2. Wählen Sie ein Datenbankobjekt aus, das nicht migriert werden konnte. Eine neue Abfrage wird unter Freigegebene Abfragen im Explorer geöffnet. Diese neue Abfrage zeigt die Metadatendefinition und die Anpassungen, die der Migrations-Assistent als automatische Kommentare vorgenommen hat, die dem T-SQL-Code hinzugefügt wurden.

  3. Überprüfen Sie die Kommentare am Anfang des Skripts, um die Anpassungen anzuzeigen, die der Migrations-Assistent am Skript vorgenommen hat.

  4. Überprüfen und beheben Sie die fehlerhaften Skripts mithilfe der Fehlerinformationen und Dokumentation.

  5. Um Copilot für KI-gestützte Unterstützung beim Beheben der Fehler zu verwenden, wählen Sie Abfragefehler beheben im Abschnitt Vorgeschlagene Aktion aus. Copilot aktualisiert das Skript mit Vorschlägen. Es können Fehler auftreten, da Copilot KI verwendet. Überprüfen Sie daher Codevorschläge und nehmen Sie notwendige Anpassungen vor.

    Screenshot des Fabric-Portals des Abfrage-Editors mit T-SQL-Abfragen, die nicht migriert werden konnten, sowie kommentare und Korrekturen, die von Copilot vorgeschlagen wurden.

  6. Wählen Sie Ausführen aus, um das Objekt zu überprüfen und zu erstellen.

  7. Das nächste zu reparierende Skript wird geöffnet.

  8. Fahren Sie fort, die restlichen Skripte zu reparieren. Sie können die Korrektur jener Skripts überspringen, die Sie während dieses Schritts nicht benötigen.

  9. Wenn alle gewünschten Metadaten für die Migration bereit sind, wählen Sie im Bereich "Probleme beheben " die Schaltfläche "Zurück" aus, um die Ansicht der obersten Ebene des Migrations-Assistenten zurückzugeben. Überprüfen Sie den Schritt 2. Probleme beheben im Migrationsassistenten.

Weitere Objekte zum Migrieren abrufen

Verwenden Sie inkrementelle Migration, um Objekte in einem bestehenden Fabric-Warehouse hinzuzufügen oder zu aktualisieren. Gib neue Quelleingaben an, wähle nur die Objekte aus, die du brauchst, und entscheide, wie du mit Objekten umgehst, die bereits im Ziel existieren. Migrieren Sie zum Beispiel eine Gruppe von Schemata, validieren Sie das Ergebnis und kehren Sie dann später zurück, um weitere Objekte oder aktualisierte Definitionen zu migrieren.

  1. Starte die inkrementelle Migration von einer der folgenden Stellen aus:

    • Öffnen Sie das Lager, wählen Sie die Registerkarte Migration auf dem Ribbon aus und wählen Sie dann Mehr Objekte abrufen.

      Screenshot von „Mehr Objekte abrufen“ im Migrationstab eines Warehouse.

    • In der Migrationszusammenfassung erweitern Sie Metadaten kopieren und wählen Sie dann Mehr Objekte abrufen.

      Screenshot von

  2. Wählen Sie die Quelle, wählen Sie eine Eingabemethode und fahren Sie mit dem Schritt „Mehr Objekte zum Migrieren wählen“ fort.

    Screenshot der Seite „Weitere Objekte zum Migrieren auswählen“ des Migration Assistant.

  3. Bei Mehr Objekte zum Migrieren auswählen wählen Sie die zu migrierenden Objekte aus:

    • Verwenden Sie den Filter, um alle Quellobjekte, Objekte mit Namenskonflikten oder Objekte ohne Namenskonflikte anzuzeigen.

      Screenshot des Namenskonfliktfilters auf der Seite

    • Objekte, deren Namen bereits im Warehouse existieren, zeigen ein Warnsymbol an. Wenn Sie eines dieser Objekte auswählen, lösen Sie den Namenskonflikt später in der Migration.

      Screenshot des Warnsymbols und des Tooltips für ein Objekt, dessen Name bereits im Warehouse existiert.

    • Standardmäßig enthält Migration Assistant direkte Abhängigkeiten, wenn Sie ein Objekt auswählen. Wählen Sie im rechten Fenster einen Objektnamen, um dessen direkte Abhängigkeiten anzuzeigen.

      Screenshot der direkten Abhängigkeiten eines ausgewählten Objekts.

    • Wenn ein Objekt in der Eingabedatei keinen Schemanamen hat, weist Migration Assistant das Objekt dem Standardschema dbo zu.

  4. Überprüfen Sie bei Review die Zusammenfassung der Quell-, Ziel- und Objektmigration.

    Screenshot der Zusammenfassung der Quell-, Ziel- und Objektmigration auf der Prüfseite.

  5. Wählen Sie "Migrieren" aus. Migration Assistant übersetzt die ausgewählten Objekte und erstellt Objekte, die keine Namenskonflikte haben. Objekte mit Namenskonflikten bleiben ausstehend, bis du jeden Konflikt gelöst hast.

Konflikte lösen und Objekte reparieren

Wenn Sie ein bestehendes Warehouse durch inkrementelle Migration aktualisieren, können Sie mit Konfliktlösung wählen, welche Objektdefinition Sie behalten möchten.

  1. Überprüfen Sie in der Migration Assistant-Zusammenfassung die Anzahl Zu lösende Konflikte. 2. Konflikte lösen und Objekte reparieren aufklappen.

    Screenshot der Anzahl der zu lösenden Konflikte und des Schritts „Konflikte lösen und Objekte reparieren“.

  2. Auf dem Reiter Konflikte überprüfen Sie die Objekte, die Namenskonflikte haben.

    Screenshot der Objekte im Tab Konflikte.

  3. Wählen Sie ein Objekt aus, um dessen SQL-Definitionen zu vergleichen. Die bestehende Definition erscheint links, die neu übersetzte Definition rechts.

    Screenshot, der die bestehenden und neuen SQL-Definitionen für ein Objekt vergleicht.

  4. Wählen Sie eine der folgenden Aktionen für das Objekt:

    • Vorhandenes beibehalten: Behalten Sie die bestehende Objektdefinition und verwerfen Sie die eingehende übersetzte Definition.
    • Eingehendes beibehalten: Ersetze die bestehende Objektdefinition durch die eingehende übersetzte Definition. Bestätigen Sie die Aktion, wenn Sie dazu aufgefordert werden.
    • Umbenennen des Eingehenden: Erstellen Sie das eingehende Objekt mit einem anderen Namen und behalten Sie das bestehende Objekt.

    Screenshot der Aktionen Keep incoming, Keep existing und Rename incoming für ein Objekt.

    Wenn Sie Eingehende umbenennen auswählen, geben Sie das Schema und den Objektnamen ein und wählen dann Umbenennen.

    Screenshot des Dialogs „Migriertes Objekt umbenennen“.

  5. Optional: Überarbeite das eingehende Skript, bevor du es speicherst. Um Ihre Bearbeitungen zu verwerfen und das übersetzte Skript wiederherzustellen, wählen Sie Eingehendes zurücksetzen.

    Screenshot von „Reset incoming“ oberhalb einer bearbeiteten eingehenden SQL-Definition.

  6. Um die eingehende Definition anzuwenden, wählen Sie Eingehende beibehalten (Vorhandenes überschreiben). Wenn du das eingehende Skript bearbeitet hast, wähle stattdessen Vorhandenes überschreiben.

    Warning

    Für eine Tabelle: Eingehendes beibehalten löscht die vorhandene Tabelle und erstellt sie neu. Wenn die Tabelle Daten enthält, verursacht diese Aktion Datenverlust, und Sie müssen die Daten erneut laden. Wenn Migration Assistant das eingehende Skript nicht anwenden kann, stellt er die vorherige Objektdefinition wieder her, stellt aber keine gelöschten Daten wieder her.

    Für eine Tabelle wählen Sie Tabelle ersetzen, um die Aktion zu bestätigen.

    Screenshot des Bestätigungsdialogs zum Ersetzen einer bestehenden Tabelle.

  7. Wenn das Skript erfolgreich läuft, markiert Migration Assistant den Konflikt als gelöst.

    Screenshot, das zeigt, dass der Konflikt eines Objekts gelöst ist.

  8. Wiederholen Sie diese Schritte für jedes Objekt mit einem Namenskonflikt. Um dieselbe Aktion auf mehrere Objekte anzuwenden, wähle die Objekte aus und wähle dann Vorhandene beibehalten oder Eingehende beibehalten.

    Screenshot der Massenaktionen „Eingehendes beibehalten“ und „Vorhandenes beibehalten“.

  9. Bestätigen Sie, dass jedes erfolgreich verarbeitete Objekt als gelöst markiert ist. Wenn ein Objekt weitere Änderungen benötigt, überprüfen Sie die Informationen im rechten Fenster.

Kopieren von Daten mithilfe des Migrations-Assistenten

Das Kopieren von Daten hilft Ihnen beim Migrieren von Daten, die von den von Ihnen migrierten Objekten verwendet werden. Sie können einen Fabric Data Factory-Kopierauftrag verwenden, um ihn manuell auszuführen, oder führen Sie die folgenden Schritte für die Integration des Kopierauftrags im Migrations-Assistenten aus.

  1. Wählen Sie den Schritt Daten kopieren im Migration Assistant aus.

  2. Wähle Kopierauftrag verwenden.

  3. Geben Sie dem neuen Auftrag einen Namen und wählen Sie dann Erstellen aus.

  4. Auf der Seite "Verbinden zur Datenquelle" geben Sie die Verbindungsdaten für die Quelle an. Wählen Sie Weiteraus.

  5. Wählen Sie auf der Seite Daten auswählen die Tabellen aus, die Sie migrieren möchten. Die Objektmetadaten sollten bereits im Ziel-Warehouse vorhanden sein. Wählen Sie Weiteraus.

    Screenshot aus dem Fabric-Portal des Bereichs

  6. Wählen Sie auf der Seite Datenziel auswählen Ihr neues Fabric Warehouse-Element aus dem OneLake-Katalog aus. Wählen Sie Weiteraus.

  7. Auf der Seite Zu Ziel zuordnen konfigurieren Sie die Spaltenzuordnungen jeder Tabelle. Wählen Sie Weiteraus.

  8. Wählen Sie auf der Seite Kopierauftragsmodus den Kopiermodus aus. Wählen Sie eine einmalige vollständige Datenkopie (empfohlen für die Migration) oder fortlaufendes inkrementelles Kopieren aus. Wählen Sie Weiteraus.

  9. Überprüfen Sie die Auftragszusammenfassung. Wählen Sie Speichern + ausführen aus.

  10. Wenn der Kopierauftrag abgeschlossen ist, überprüfen Sie die 3. Daten kopieren im Migrationsassistenten. Wählen Sie die Zurück-Taste, um zur obersten Ansicht des Migration Assistant zurückzukehren.

Verbindungen erneut erstellen

Verbinden Sie im letzten Schritt die Datenlade- und Berichterstellungsplattformen erneut, damit ihre Verbindungen auf Ihr neues Fabric Warehouse verweisen.

  1. Identifizieren Sie Verbindungen in Ihrem vorhandenen Quelllager.

    • In einer SQL-Datenbank in jeder Microsoft-SQL-Instanz können Sie dynamische Verwaltungsansichten verwenden, zum Beispiel:
    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 den dedizierten SQL-Pools von Azure Synapse Analytics finden Sie Sitzungsinformationen, einschließlich Quellanwendung, verbundener Benutzer, Verbindungsursprung und Authentifizierungsmethode:
    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. Aktualisieren Sie die Verbindungen zu Ihren Berichtsplattformen, damit sie auf Ihr Fabric Warehouse verweisen.

  3. Testen Sie das Fabric Warehouse mit einigen Berichten, bevor Sie die Verbindungen neu erstellen. Führen Sie Vergleichs- und Datenüberprüfungstests in Ihren Berichtsplattformen durch.

  4. Aktualisieren Sie die Verbindungen zu Ihren Datenladeplattformen (ETL/ELT), damit sie auf Ihr Fabric Warehouse verweisen.

    • Für Power BI-/Fabric-Pipelines:
      • Verwenden Sie die REST API zu Auflisten von Verbindungen, um Verbindungen zu Ihrer alten Datenquelle, dem dedizierten SQL-Pool von Azure Synapse Analytics, zu finden.
      • Aktualisieren Sie die Verbindungen zum neuen Fabric Data Warehouse über die Erfahrung "Verbindungen und Gateways verwalten" unter den Einstellungen.
  5. Nach Abschluss überprüfen Sie den Schritt "Reroute-Verbindungen" im Migration Assistant.

Glückwunsch! Sie können das Warehouse jetzt nutzen.

Screenshot des Fabric-Portal-Migrationsassistenten mit allen vier abgeschlossenen Arbeitsschritten und einem Glückwunsch-Popup.