Freigeben über

Quellcodeverwaltung mit Warehouse (Vorschau)

  • Artikel

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:

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. Screenshot des Warehouse in den Einstellungen für die Quellcodeverwaltung im Fabric-Portal.
  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:

Screenshot des Fabric-Portals eines beispielhaften Warehouse-Schemas.

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.

Herunterladen des SQL-Datenbankprojekts eines Warehouse in Fabric

Mit der Erweiterung „SQL-Datenbankprojekte” in Azure Data Studio und Visual Studio Code können Sie ein Warehouse-Schema verwalten und Warehouse-Objektänderungen wie andere SQL-Datenbankprojekte behandeln.

Um eine lokale Kopie des Warehouse-Schemas herunterzuladen, wählen Sie SQL-Datenbankprojekt herunterladen im Menüband aus.

Screenshot des Abfragemenübands aus dem Fabric-Portal. Das Projektfeld „SQL-Datenbank herunterladen” ist hervorgehoben.

Die lokale Kopie eines Datenbankprojekts, das die Definition des Lagerschemas enthält. Das Datenbankprojekt kann verwendet werden, um:

  • Das Warehouse-Schema in einem anderen Warehouse neu zu erstellen.
  • Das Warehouse-Schema in Clienttools wie Azure Data Studio oder Visual Studio Code weiter zu entwickeln.

Veröffentlichen eines SQL-Datenbankprojekts in einem neuen Warehouse

So veröffentlichen Sie das Warehouse-Schema in einem neuen Warehouse:

  1. Erstellen Sie ein neues Warehouse in Ihrem Fabric-Arbeitsbereich.
  2. Wählen Sie auf der Starteseite für das neue Warehouse unter Warehouse erstellen die Option SQL-Datenbankprojekt aus. Screenshot der Schaltfläche für das SQL-Datenbankprojekt im Fabric-Portal.
  3. Wählen Sie die ZIP-Datei aus, die aus dem vorhandenen Warehouse heruntergeladen wurde.
  4. Das Warehouse-Schema wird im neuen Warehouse veröffentlicht.

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. Screenshot Entwicklungs-, Test- und Produktionsphasen im Fabric-Portal.
  4. Wählen Sie Bereitstellen aus, um Ihre Warehouses in den Phasen Entwicklung, Test und Produktion bereitzustellen.

Weitere Informationen zum Fabric-Bereitstellungspipelineprozess finden Sie unter Übersicht über Fabric-Bereitstellungspipelines.

Einschränkungen bei der Quellcodeverwaltung

  • Features für SQL-Sicherheit müssen mithilfe eines skriptbasierten Ansatzes exportiert/migriert werden. Erwägen Sie nach der Bereitstellung in einem SQL-Datenbankprojekt die Verwendung eines Skripts, das Sie konfigurieren können, indem Sie das Projekt mit der Erweiterung „SQL-Datenbankprojekte” öffnen, die in Azure Data Studio 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.
  • Der SQL-Analyseendpunkt wird bei der Git-Integration nicht unterstützt.

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.
  • Der SQL-Analyseendpunkt wird in Bereitstellungspipelines nicht unterstützt.

Zugehöriger Inhalt