Quellcodeverwaltung (Vorschau)

Gilt für:✅ Warehouse in Microsoft Fabric

In diesem Artikel wird erläutert, wie Git-Integrations- und Bereitstellungspipelines für Warehouses in Microsoft Fabric funktionieren. Erfahren Sie, wie Sie eine Verbindung mit Ihrem Repository einrichten, Ihre Warehouses verwalten und sie in verschiedenen Umgebungen bereitstellen. Die Quellcodeverwaltung für Fabric Warehouse ist derzeit eine Previewfunktion.

Sie können sowohl Git-Integration als auch Bereitstellungspipelines für verschiedene Szenarien verwenden:

• Verwenden Sie Git- und SQL-Datenbankprojekte, um inkrementelle Änderungen, Teamzusammenarbeit, Commitverlauf in einzelnen Datenbankobjekten zu verwalten.
• Verwenden Sie Bereitstellungspipelines, um Codeänderungen an verschiedene Vorproduktions- und Produktionsumgebungen höher zu stufen.

Git-Integration

Die Git-Integration in Microsoft Fabric ermöglicht es Entwicklern, ihre Entwicklungsprozesse, Tools und bewährten Methoden direkt in die Fabric-Plattform zu integrieren. Sie ermöglicht Entwicklern, die in Fabric entwickeln, Folgendes:

• Sichern und Versionieren ihrer Arbeit
• Wiederherstellen vorheriger Phasen nach Bedarf
• Mit anderen zusammenarbeiten oder alleine arbeiten mit Git-Branches
• Wenden Sie die Funktionen vertrauter Quellcodeverwaltungstools an, um Fabric-Elemente zu verwalten

Weitere Informationen zum Git-Integrationsprozess finden Sie unter:

• Was ist die Microsoft Fabric Git-Integration?
• Grundlegende Konzepte der Git-Integration
• Erste Schritte mit der Git-Integration

Einrichten einer Verbindung mit der Quellcodeverwaltung

Über die Seite Arbeitsbereichseinstellungen können Sie ganz einfach eine Verbindung mit Ihrem Repository einrichten, um Änderungen zu committen und zu synchronisieren.

1. Informationen zum Einrichten der Verbindung finden Sie unter Erste Schritte mit der Git-Integration. Befolgen Sie die Anweisungen zum Herstellen einer Verbindung mit einem Git-Repository mit Azure DevOps oder GitHub als Git-Anbieter.
2. Nach dem Herstellen der Verbindung werden Ihre Elemente (einschließlich Warehouses) im Bereich Quellcodeverwaltung angezeigt.
3. Nachdem Sie die Warehouse-Instanzen erfolgreich mit dem Git-Repository verbunden haben, wird die Ordnerstruktur des Warehouse im Repository angezeigt. Sie können nun zukünftige Vorgänge ausführen, z. B. eine Pull Request erstellen.

Datenbankprojekte für ein Warehouse in Git

Die folgende Abbildung ist ein Beispiel für die Dateistruktur der einzelnen Warehouse-Elemente im Repository:

Wenn Sie das Warehouse-Element in das Git-Repository committen, wird das Warehouse als SQL-Datenbankprojekt in ein Quellcodeformat konvertiert. Ein SQL-Projekt ist eine lokale Darstellung von SQL-Objekten, die das Schema einer einzelnen Datenbank umfassen, z. B. Tabellen, gespeicherte Prozeduren oder Funktionen. Die Ordnerstruktur der Datenbankobjekte wird nach Schema/Objekttyp organisiert. Jedes Objekt im Warehouse wird mit einer SQL-Datei dargestellt, die die Definition der Datendefinitionssprache (Data Definition Language, DDL) enthält. Warehouse-Tabellendaten und SQL-Sicherheitsfeatures sind nicht im SQL-Datenbankprojekt enthalten.

Freigegebene Abfragen werden auch an das Repository committet und erben den Namen, unter dem sie gespeichert werden.

Bereitstellungspipelines

Sie können auch Bereitstellungspipelines verwenden, um Ihren Warehouse-Code in verschiedenen Umgebungen bereitzustellen, z. B. in der Entwicklungs-, Test- und Produktionsumgebung. Bereitstellungspipelines machen Datenbankprojekte nicht verfügbar.

Führen Sie die folgenden Schritte aus, um Ihre Warehouse-Bereitstellung mithilfe der Bereitstellungspipeline durchzuführen.

1. Erstellen Sie eine neue Bereitstellungspipeline, oder öffnen Sie eine vorhandene Bereitstellungspipeline. Weitere Informationen finden Sie unter Erste Schritte mit Bereitstellungspipelines.
2. Weisen Sie Arbeitsbereiche entsprechend Ihren Bereitstellungszielen verschiedenen Phasen zu.
3. Wählen Sie wie im folgenden Beispiel gezeigt Elemente aus (einschließlich Warehouses zwischen verschiedenen Phasen), zeigen Sie sie an, und vergleichen Sie sie.
4. Wählen Sie Bereitstellen aus, um Ihre Warehouses in den Phasen Entwicklung, Test und Produktion bereitzustellen.

Weitere Informationen zum Fabric-Bereitstellungspipelineprozess finden Sie in der Einführung in Bereitstellungspipelinen.

Einschränkungen bei der Quellcodeverwaltung

• Features für SQL-Sicherheit müssen mithilfe eines skriptbasierten Ansatzes exportiert/migriert werden. Erwägen Sie die Verwendung eines Skripts nach der Bereitstellung in einem SQL-Datenbankprojekt, das Sie konfigurieren können, indem Sie das Projekt mit der erweiterung SQL-Datenbankprojekte öffnen, die in Visual Studio Code verfügbar ist.

Einschränkungen bei der Git-Integration

• Wenn Sie derzeit ALTER TABLE verwenden, um eine Einschränkung oder Spalte im Datenbankprojekt hinzuzufügen, wird die Tabelle gelöscht und bei der Bereitstellung neu erstellt, was zu Datenverlust führt. Beachten Sie die folgende Problemumgehung, um Tabellendefinition und Daten beizubehalten:
  • Erstellen Sie eine neue Kopie der Tabelle im Warehouse mit CREATE TABLE und INSERT, CREATE TABLE AS SELECT oder mit Tabelle klonen.
  • Ändern Sie die neue Tabellendefinition mit neuen Einschränkungen oder Spalten nach Bedarf mithilfe von ALTER TABLE.
  • Löschen Sie die alte Tabelle.
  • Benennen Sie die neue Tabelle in den Namen der alten Tabelle mit sp_rename um.
  • Ändern Sie die Definition der alten Tabelle im SQL-Datenbankprojekt auf exakt dieselbe Weise. Das SQL-Datenbankprojekt des Warehouse in der Quellcodeverwaltung und das Live-Warehouse sollten nun übereinstimmen.
• Erstellen Sie derzeit kein Dataflow Gen2 mit einem Ausgabeziel für das Warehouse. Commit und Aktualisierung von Git würden durch ein neues Element mit dem Namen DataflowsStagingWarehouse blockiert, das im Repository angezeigt wird.
• Die Fabric Git-Integration unterstützt das SQL Analytics-Endpunktelement nicht.
• Elementübergreifende Abhängigkeiten, Elementsequenzierung und Synchronisierungslücken zwischen dem SQL-Analyseendpunkt und dem Lager wirken sich auf die "Verzweigung zu einem neuen/vorhandenen Arbeitsbereich" und den "Wechsel zu einem anderen Zweig" während der Entwicklung und kontinuierlichen Integration aus.

Einschränkungen für Bereitstellungspipelines

• Wenn Sie derzeit ALTER TABLE verwenden, um eine Einschränkung oder Spalte im Datenbankprojekt hinzuzufügen, wird die Tabelle gelöscht und bei der Bereitstellung neu erstellt, was zu Datenverlust führt.
• Erstellen Sie derzeit kein Dataflow Gen2 mit einem Ausgabeziel für das Warehouse. Die Bereitstellung würde durch ein neues Element mit dem Namen DataflowsStagingWarehouse blockiert, das in der Bereitstellungspipeline angezeigt wird.
• Fabric-Bereitstellungspipelines unterstützen das SQL Analytics-Endpunktelement nicht.
• Elementabhängigkeiten, Elementsequenzierung und Synchronisierungslücken zwischen dem SQL-Analyseendpunkt und dem Warehouse beeinflussen die Workflows von Fabric Deployment Pipelines.

Zugehöriger Inhalt

• Entwicklung und Bereitstellung
• Erste Schritte mit der Git-Integration