Freigeben über

Integration der SQL-Datenbank-Quellcodeverwaltung in Microsoft Fabric

  • Artikel

Gilt für: ✅SQL-Datenbank in Microsoft Fabric

In diesem Tutorial erfahren Sie, wie Sie mit Ihrer SQL-Datenbank in Fabric mit Fabric Git Integrations-Quellcodeverwaltung arbeiten.

Eine SQL-Datenbank in Microsoft Fabric verfügt über eine Integration der Quellcodeverwaltung oder „Git-Integration”, mit der SQL-Benutzer die Definitionen ihrer Datenbankobjekte im Zeitverlauf und innerhalb eines Teams nachverfolgen können: Diese Integration ermöglicht es Teams:

  • Die Datenbank in die Quellcodeverwaltung zu committen, wodurch die Livedatenbank automatisch in Code im konfigurierten Quellcodeverwaltungsrepository (Azure DevOps) konvertiert wird.
  • Datenbankobjekte anhand der Inhalte aus der Quellcodeverwaltung zu aktualisieren, wodurch der Code im Quellcodeverwaltungsrepository validiert wird, bevor eine differenzielle Änderung auf die Datenbank angewendet wird.

Diagramm des einfachen Commit- und Aktualisierungszyklus zwischen der Livedatenbank und der Quellcodeverwaltung.

Wenn Sie mit Git nicht vertraut sind, finden Sie hier einige empfohlene Ressourcen:

Dieser Artikel enthält eine Reihe nützlicher Szenarien, die einzeln oder in Kombination verwendet werden können, um Ihren Entwicklungsprozess mit SQL-Datenbank in Fabric zu verwalten:

Voraussetzungen

Setup

Diese Repositoryverbindung gilt auf Arbeitsbereichsebene, sodass eine einzelne Verzweigung im Repository diesem Arbeitsbereich zugeordnet ist. Das Repository kann mehrere Verzweigungen aufweisen, aber nur der Code in der in den Arbeitsbereichseinstellungen ausgewählten Verzweigung wirkt sich direkt auf den Arbeitsbereich aus.

Schritte zum Verbinden Ihres Arbeitsbereichs mit einem Quellcodeverwaltungsrepository finden Sie unter Erste Schritte mit der Git-Integration. Ihr Arbeitsbereich kann mit einem Azure DevOps- oder GitHub-Remote-Repository verbunden werden.

Hinzufügen der Fabric SQL-Datenbank zur Quellcodeverwaltung

In diesem Szenario committen Sie Datenbankobjekte in die Quellcodeverwaltung. Möglicherweise entwickeln Sie eine Anwendung, in der Sie Objekte direkt in einer Testdatenbank erstellen und diese Datenbank in der Quellcodeverwaltung nachverfolgen, genau wie Ihren Anwendungscode. Daher haben Sie Zugriff auf den Verlauf der Definitionen Ihrer Datenbankobjekte und können Git-Konzepte wie Verzweigung und Zusammenführung verwenden, um Ihren Entwicklungsprozess weiter anzupassen.

  1. Herstellen einer Verbindung mit Ihrer SQL-Datenbank im Fabric SQL-Editor, SQL Server Management Studio, die mssql-Erweiterung mit Visual Studio Code oder anderen externen Tools.
  2. Erstellen Sie eine neue Tabelle, gespeicherte Prozedur oder ein anderes Objekt in der Datenbank.
  3. Wählen Sie das Menü ... für die Datenbank aus, und wählen Sie Git-Synchronisierungsstatus aktualisieren aus.
  4. Wählen Sie die Schaltfläche Quellcodeverwaltung aus, um den Quellcodeverwaltungsbereich zu öffnen.
  5. Aktivieren Sie das Kontrollkästchen neben der gewünschten Datenbank. Klicken Sie auf Commit. Der Fabric-Dienst liest Objektdefinitionen aus der Datenbank und schreibt sie in das Remoterepository.
  6. Sie können nun den Verlauf von Datenbankobjekten in der Quellansicht des Coderepositorys anzeigen.

Wenn Sie die Datenbank weiterhin bearbeiten, einschließlich der Bearbeitung vorhandener Objekte, können Sie diese Änderungen an der Quellcodeverwaltung übernehmen, indem Sie die vorherigen Schritte ausführen.

Aktualisieren der Fabric SQL-Datenbank aus der Quellcodeverwaltung

In diesem Szenario erstellen Sie Datenbankobjekte als Code in der SQL-Projekterweiterung in Visual Studio Code und committen die Dateien dann an die Quellcodeverwaltung, bevor Sie die Fabric SQL-Datenbank aus der Quellcodeverwaltungsintegration aktualisieren. Dieses Szenario richtet sich an Entwickler, die lieber in Visual Studio Code arbeiten, vorhandene Anwendungen mit SQL-Projekten verwenden oder erweiterte CI/CD-Pipelineanforderungen haben.

  1. Stellen Sie sicher, dass Sie die neueste Version von Visual Studio Code und die mssql- und SQL-Projekte-Eweiterungen für VS Code installiert haben.
  2. Erstellen Sie eine neue SQL-Datenbank in Ihrem Arbeitsbereich, und committen Sie sie an die Quellcodeverwaltung, ohne Objekte hinzuzufügen. In diesem Schritt werden dem Repository die leeren SQL-Projekt- und SQL-Datenbankelementmetadaten hinzugefügt.
  3. Klonen Sie das Quellcodeverwaltungsrepository auf Ihrem lokalen Computer.
    • Wenn Sie Azure DevOps verwenden, wählen Sie das Kontextmenü ... für das Quellcodeverwaltungsprojekt aus. Wählen Sie Klonen aus, um Ihr DevOps-Repository auf den lokalen Computer zu kopieren. Wenn Sie mit Azure DevOps noch nicht vertraut sind, lesen Sie den Leitfaden Mit Git codieren für Azure DevOps.
    • Wenn Sie GitHub verwenden, wählen Sie die Schaltfläche Code im Repository aus, und kopieren Sie die URL, um das Repository auf Ihren lokalen Computer zu klonen. Wenn Sie noch nicht mit GitHub arbeiten, lesen Sie den Leitfaden Klonen eines Repositorys.
  4. Öffnen Sie den geklonten Ordner in Visual Studio Code. Die dem Arbeitsbereich zugeordnete Verzweigung ist möglicherweise nicht die Standardeinstellung. Nach dem Wechseln der Verzweigung sollte ein Ordner mit dem Namen <yourdatabase>.SQLDatabase in VS Code angezeigt werden.
  5. Erstellen Sie eine .sql-Datei für mindestens eine Tabelle, die Sie in der Datenbank innerhalb der Ordnerstruktur für Ihre Datenbank erstellen möchten. Die Datei sollte die CREATE TABLE-Anweisung für die Tabelle enthalten. Erstellen Sie z. B. eine Datei namens MyTable.sql im Ordner dbo/Tables mit folgendem Inhalt:
    CREATE TABLE dbo.MyTable
(
    Id INT PRIMARY KEY,
    ExampleColumn NVARCHAR(50)
);
  6. Um sicherzustellen, dass die Syntax gültig ist, können wir das Datenbankmodell mit dem SQL-Projekt überprüfen. Verwenden Sie nach dem Hinzufügen der Dateien die Ansicht „Datenbankprojekte” in VS Code, um das Projekt zu erstellen.
  7. Committen Sie nach einem erfolgreichen Build die Dateien mit der Quellcodeverwaltungsansicht in VS Code oder Ihrer bevorzugten lokalen Git-Schnittstelle an die Quellcodeverwaltung.
  8. Pushen/synchronisieren Sie ihren Commit mit dem Remote-Repository. Überprüfen Sie, ob Ihre neuen Dateien in Azure DevOps oder GitHub angezeigt werden.
  9. Kehren Sie zur Fabric-Webschnittstelle zurück, und öffnen Sie den Bereich Quellcodeverwaltung im Arbeitsbereich. Möglicherweise verfügen Sie bereits über eine Benachrichtigung, dass Sie ausstehende Änderungen von Git haben. Wählen Sie die Schaltfläche Aktualisieren (Alle aktualisieren) aus, um den Code aus Ihrem SQL-Projekt auf die Datenbank anzuwenden.
    • Möglicherweise wird die Datenbank sofort angezeigt, wenn sie nach dem Update „Nicht committet” ist. Dies liegt daran, dass das Git-Integrationsfeature einen direkten Vergleich aller für eine Elementdefinition generierten Dateiinhalte durchführt und einige unbeabsichtigte Unterschiede möglich sind. Ein Beispiel hierfür sind Inlineattribute für Spalten. In diesen Fällen müssen Sie auf die Quellcodeverwaltung in der Fabric-Webschnittstelle zurückkehren, um die Definition mit dem zu synchronisieren, was als Teil eines Commitvorgangs generiert wird.
  10. Nachdem das Update abgeschlossen ist, verwenden Sie ein Tool Ihrer Wahl, um eine Verbindung mit der Datenbank herzustellen. Die Objekte, die Sie dem SQL-Projekt hinzugefügt haben, werden in der Datenbank angezeigt.

Hinweis

Wenn Änderungen am lokalen SQL-Projekt vorgenommen werden, wenn ein Syntaxfehler oder die Verwendung nicht unterstützter Features in Fabric vorliegt, schlägt die Datenbankaktualisierung fehl. Sie müssen die Änderung in der Quellcodeverwaltung manuell wiederherstellen, bevor Sie fortfahren können.

Erstellen eines Verzweigungsarbeitsbereichs

In diesem Szenario richten Sie eine neue Entwicklungsumgebung in Fabric ein, indem Sie einen doppelten Satz von Ressourcen basierend auf der Quellcodeverwaltungsdefinition erstellen. Die duplizierte Datenbank enthält die Datenbankobjekte, die wir in die Quellcodeverwaltung eingecheckt haben. Dieses Szenario richtet sich an Entwickler, die ihren Anwendungsentwicklungslebenszyklus in Fabric fortsetzen und die Quellcodeverwaltungsintegration von Fabric nutzen.

  1. Schließen Sie das Szenario Konvertieren der Fabric SQL-Datenbank in Code in der Quellcodeverwaltung ab.
    • Sie sollten über eine Verzweigung in einem Quellcodeverwaltungsrepository verfügen, wobei sowohl ein SQL-Projekt als auch die Fabric-Objektmetadaten vorhanden sind.
  2. Öffnen Sie im Fabric-Arbeitsbereich den Bereich Quellcodeverwaltung. Wählen Sie auf der Registerkarte „Verzweigungen” des Menüs Quellcodeverwaltung die Option Verzweigen in neuen Arbeitsbereich aus.
  3. Geben Sie die Namen der Verzweigung und des Arbeitsbereichs an, die erstellt werden. Die Verzweigung wird im Quellcodeverwaltungsrepository erstellt und mit dem committeten Inhalt der Verzweigung des Arbeitsbereichs gefüllt, von dem Sie verzweigen. Der Arbeitsbereich wird in Fabric erstellt.
  4. Navigieren Sie zu dem neu erstellten Arbeitsbereich in Fabric. Nach Abschluss der Datenbankerstellung enthält die neu erstellte Datenbank jetzt die in Ihrem Coderepo angegebenen Objekte. Wenn Sie den Fabric-Abfrage-Editor öffnen und im Objekt-Explorer navigieren, verfügt die Datenbank über neue (leere) Tabellen und andere Objekte.

Zusammenführen von Änderungen von einem Branch in einen anderen

In diesem Szenario verwenden Sie das Quellcodeverwaltungsrepository, um Datenbankänderungen zu überprüfen, bevor sie für die Bereitstellung verfügbar sind. Dieses Szenario richtet sich an Entwickler, die in einer Teamumgebung arbeiten und die Quellcodeverwaltung zum Verwalten ihrer Datenbankänderungen verwenden.

Erstellen Sie zwei Arbeitsbereiche mit zugeordneten Verzweigungen im selben Repository, wie im vorherigen Szenario beschrieben.

  1. Nehmen Sie mit der Datenbank auf der sekundären Verzweigung Änderungen an den Datenbankobjekten vor.
    • Ändern Sie beispielsweise eine vorhandene gespeicherte Prozedur, oder erstellen Sie eine neue Tabelle.
  2. Überprüfen Sie diese Änderungen an der Quellcodeverwaltung mit der Schaltfläche Committen in der Quellcodeverwaltung in Fabric.
  3. Erstellen Sie in Azure DevOps oder GitHub eine Pull Request von der sekundären Verzweigung bis zur primären Verzweigung.
    • In der Pull Request können Sie die Änderungen im Datenbankcode zwischen dem primären Arbeitsbereich und dem sekundären Arbeitsbereich sehen.
  4. Nachdem Sie die Pull Request abgeschlossen haben, wird die Quellcodeverwaltung aktualisiert, die Datenbank in Fabric im primären Arbeitsbereich wird jedoch nicht mehr geändert. Um die primäre Datenbank zu ändern, aktualisieren Sie den primären Arbeitsbereich aus der Quellcodeverwaltung mithilfe der Schaltfläche Aktualisieren in der Quellcodeverwaltung in Fabric.

Zugehöriger Inhalt