Migrieren mit einer DACPAC-Datei

Zutreffend für: ✅ Warehouse in Microsoft Fabric

Der Fabric-Migrations-Assistent ist eine Migrationserfahrung, mit der Sie dedizierte SQL-Pools in Azure Synapse Analytics, Datenbanken in SQL Server und Datenbanken von anderen SQL-Datenbankmodulplattformen nahtlos in Fabric Data Warehouse kopieren können.

Dieser Leitfaden führt Sie durch die Schritte zum Migrieren von einem dedizierten Sql-Pool von Azure Synapse Analytics zu Fabric Warehouse mithilfe einer DACPAC-Datei.

Tipp

Weitere Informationen zu den Features und Funktionen des Migration Assistant finden Sie unter Fabric Migration Assistant für Data Warehouse.

Weitere Informationen zur Strategie und Planung Ihrer Migration finden Sie unter Planung der Migration: dedizierte SQL-Pools für Azure Synapse Analytics zu Fabric Data Warehouse.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass die folgenden Elemente bereit sind:

• 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.
• DACPAC-Datei, die aus den dedizierten SQL-Pool für Azure Synapse Analytics extrahiert wurde. Eine DACPAC-Datei basiert auf SQL-Datenbankprojekten und enthält die Metadaten von Datenbankobjekten, einschließlich des Schemas von Tabellen, Ansichten, gespeicherten Prozeduren, Funktionen und mehr.
  • Informationen zum Erstellen eines DAC in Visual Studio 2022 mit SQL Server Data Tools finden Sie unter Extrahieren einer Datenebenenanwendung (Data Tier Application, DAC) aus einem dedizierten Azure Synapse-SQL-Pool in Visual Studio 2022.
  • Sie können auch DATENBANKprojekte im SDK-Stil mit VS Code oder dem Befehlszeilenprogramm SqlPackage verwenden.

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

• Ihr Administrator muss den Mandantenwechsel aktivieren, bevor Sie mit der Verwendung von Copilot beginnen. Weitere Informationen finden Sie unter Copilot-Mandanteneinstellungen.
• Ihre F2- oder P1-Kapazität muss sich in einer der Regionen befinden, die in der Verfügbarkeit von Fabric-Regionen aufgeführt sind.
• Wenn sich Ihr Mandant oder Ihre Kapazität außerhalb der USA oder Frankreich befindet, ist Copilot standardmäßig deaktiviert, es sei denn, Ihr Fabric-Mandantenadministrator aktiviert die Mandanteneinstellung Daten, die an Azure OpenAI gesendet werden, können außerhalb der geografischen Region, Compliance-Grenze oder der nationalen Cloud-Instanz Ihres Mandanten verarbeitet werden im Fabric Admin-Portal.
• Copilot in Microsoft Fabric wird für Test-SKUs nicht unterstützt. Derzeit werden nur kostenpflichtige SKUs (F2 oder höher oder P1 oder höher) unterstützt.
• Weitere Informationen finden Sie unter Übersicht über Copilot in Fabric und Power BI.

Metadaten kopieren

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

   

2. Wählen Sie im Menü Migrate to Fabric unter Zu einem Lager migrieren die Quellsystemkachel aus.

   • Wenn Sie von einem dedizierten SQL-Pool in Azure Synapse Analytics migrieren, wählen Sie die Kachel Dedizierter SQL-Pool von Azure Synapse Analytics aus.
   • Wenn Sie aus einer anderen T-SQL-Datenbank migrieren, z. B. aus einer Datenbank in SQL Server, Azure SQL-Datenbank oder azure SQL Managed Instance, wählen Sie die SQL Server-Datenbankkachel aus.

   

3. Wählen Sie auf der Seite "Methode auswählen" die Option "Datei hochladen" mit den Quellmetadaten aus, und wählen Sie "Weiter" aus.

4. Wählen Sie Datei auswählen aus, und laden Sie die DACPAC-Datei Ihres Quelldatenlagers hoch. Wenn der Upload abgeschlossen ist, wählen Sie "Weiter" aus.

   

5. Geben Sie auf der Seite " Ziel festlegen " den Namen des neuen Fabric-Arbeitsbereichs und des neuen Lagerelements ein, zu dem Sie migrieren möchten. Wählen Sie Weiteraus.

6. Überprüfen Sie Ihre Eingaben, und wählen Sie Migrieren aus. Der Migrations-Assistent erstellt ein neues Lagerelement und startet die Metadatenmigration.

   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.

   

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

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

   

8. Wählen Sie "Migrierte Objekte anzeigen" aus, um den Abschnitt zu erweitern und eine Liste der Objekte anzuzeigen, die Sie erfolgreich zu Ihrem Fabric Warehouse migriert haben.

   

   Die Spalte "Status" gibt an, ob der Migrations-Assistent die Metadaten des Objekts während der Übersetzung in Fabric Data Warehouse angepasst hat. 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 die Informationen zu den Anpassungen angezeigt, die das Portal an den Objekten vorgenommen hat.

9. Wählen Sie ein beliebiges Objekt aus, um die Anpassungen anzuzeigen, die der Migrations-Assistent während der Migration vorgenommen hat.

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

    

11. Wählen Sie optional das Menü " Exportieren " aus, um eine Migrationszusammenfassung als Excel-Datei oder CSV herunterzuladen.

    • Die heruntergeladene Excel-Datei ist eine vollständig strukturierte Arbeitsmappe mit zwei Arbeitsblättern: Migrierte Objekte und Objekte zum Beheben. Es ist MIP-konform und steht im Einklang mit den Vertraulichkeitskennzeichnungen Ihrer Organisation.
    • Die CSV ist einfach und toolfreundlich.

    

    Jede exportierte Datei bietet eine strukturierte, umfassende Ansicht Ihrer Migrationsergebnisse, einschließlich:

    Feldname	Beschreibung	Beispielwerte
    Objektname	Name des SQL-Objekts
    Objekttyp	SQL-Objekttypen	Tabelle, Ansicht, gespeicherte Prozedur, Funktion
    State	Übersetzungszustand	Angepasst: Fabric Data Warehouse-kompatible Updates werden angewendet Nicht angepasst: Keine Änderung im ursprünglichen Skript
    Details	Liste der angewendeten Anpassungen oder Fehlermeldungen
    Fehlertyp	Typ des Übersetzungsfehlers	Übersetzungsmeldung, Übersetzungsfehler, Fehler beim Anwenden einer Übersetzung

Beheben von Problemen mithilfe des Migrations-Assistenten

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

Beheben Sie diese Skripts mithilfe des Migrations-Assistenten.

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

   

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 vorgenommenen Anpassungen als automatische Kommentare an, die dem T-SQL-Code hinzugefügt wurden.

3. Überprüfen Sie die Kommentare am Anfang des Skripts, um die Anpassungen anzuzeigen, die am Skript vorgenommen wurden.

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.

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

7. Das nächste zu behebende 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.

Kopieren von Daten mithilfe des Migrations-Assistenten

Das Kopieren von Daten hilft bei der Migration 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ählen Sie die Schaltfläche Kopierauftrag verwenden aus.

3. Geben Sie einen Namen für den neuen Auftrag ein, und wählen Sie dann "Erstellen" aus.

4. Geben Sie auf der Seite "Verbindung mit der Datenquelle"die Verbindungsdaten für den dedizierten SQL-Pool (Azure Synapse Analytics) der Quelle ein. 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.

   

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 oben die Schaltfläche "Zurück" aus, um zur Ansicht der obersten Ebene des Migrations-Assistenten 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 dedizierten SQL-Pools für Azure Synapse Analytics finden Sie beispielsweise Sitzungsinformationen, einschließlich Quellanwendung, die verbunden ist, von der die Verbindung stammt, und wenn sie Microsoft Entra oder SQL-Authentifizierung verwendet:

   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:
     1. 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.
     2. Aktualisieren Sie die Verbindungen mit dem neuen Lager mithilfe der Seite "Verbindungen und Gateways verwalten " in den Einstellungen.

5. Wenn Sie fertig sind, überprüfen Sie den Schritt "Verbindungen neu umleiten " im Migrations-Assistenten.

Glückwunsch! Sie sind jetzt bereit, mit der Nutzung Ihres neuen Lagers zu beginnen.

Verwandte Inhalte

• Fabric Migration Assistant für Data Warehouse
• Übersicht der Microsoft Fabric Migration
• Aktualisieren Ihrer Azure Data Factory-Pipelines auf Fabric