Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Artikel wird erläutert, wie Git-Integration und Bereitstellungspipelines für Eventstream in Fabric funktionieren. Erfahren Sie, wie Sie einen Arbeitsbereich mit Ihrem Git-Repository synchronisieren, Ihre Eventstream-Elemente auf Git übertragen und in verschiedenen Arbeitsbereichen bereitstellen.
Die Fabric-Plattform bietet Git-Integration und Bereitstellungspipelines für verschiedene Szenarien:
- Verwenden Sie Git-Integration, um einen Arbeitsbereich mit einem Git-Repository zu synchronisieren und inkrementelle Änderungen, Teamzusammenarbeit, Commitverlauf in Eventstream-Elementen zu verwalten.
- Verwenden Sie Bereitstellungspipelines, um einen Arbeitsbereich (mit Eventstream-Elementen) für verschiedene Entwicklungs-, Test- und Produktionsumgebungen bereitzustellen.
Voraussetzungen
Um auf die CI/CD-Features für Eventstream zuzugreifen, müssen Sie die folgenden Anforderungen erfüllen:
- Eine Fabric-Kapazität, die es ermöglicht, alle unterstützten Fabric-Elemente zu nutzen. Falls Sie noch nicht darüber verfügen, können Sie sich für eine kostenlose Testversion registrieren.
- Die Git-Integration muss über das Verwaltungsportal aktiviert werden: Benutzer können Arbeitsbereichselemente mit ihren Git-Repositorys synchronisieren.
- Zugriff auf ein vorhandenes Repository aus Azure DevOps oder GitHub.
- Sie sind Administrator eines Fabric-Arbeitsbereichs.
Arbeitsbereich mit einem Git-Repository verbinden
Ein Arbeitsbereich kann nur vom Arbeitsbereichsadministrator mit einem Repository verbunden werden. Sobald die Verbindung jedoch hergestellt wurde, kann jeder mit der entsprechenden Berechtigung im Arbeitsbereich arbeiten. Wenn Sie kein Administrator sind, bitten Sie Ihren Administrator um Hilfe beim Herstellen einer Verbindung.
Führen Sie die folgenden Schritte aus, um einen Arbeitsbereich mit einem Azure- oder GitHub-Repository zu verbinden:
Melden Sie sich bei Fabric an, und navigieren Sie zu dem Arbeitsbereich, mit dem Sie eine Verbindung herstellen möchten.
Navigieren Sie zu Arbeitsbereichseinstellungen und wählen Sie Git-Integration
Wählen Sie ein Git-Repository aus, und geben Sie einen Git-Ordner ein. Ein Arbeitsbereich wird mit einem Git-Ordner synchronisiert.
Die Fabric-Git-Integration unterstützt die selektive Synchronisation von Zweigen für jeden Arbeitsbereich. Beim Herstellen einer Verbindung können Sie auswählen, mit welcher Verzweigung synchronisiert werden soll, und Sie können Verzweigungen später über die Git-Integrationseinstellungen wechseln. Verzweigte Arbeitsbereiche sind in der Benutzeroberfläche eindeutig gekennzeichnet und helfen Administratoren dabei, parallele Entwicklungsabläufe über Teams hinweg zu verwalten.
In der Arbeitsbereichsansicht wird der Status des Eventstream-Elements als Synchronisiert angezeigt.
Änderungen am Eventstream in Git übertragen
Nachdem Sie Änderungen an Ihrem Eventstream-Element vorgenommen haben, sehen Sie in der Arbeitsbereichsansicht einen Git-Status als Nicht committet neben Ihrem Eventstream-Element. Wählen Sie die Schaltfläche Quellcodeverwaltung oben in der Ansicht aus, und wählen Sie das Eventstream-Element aus, das committet werden soll.
Vor dem Commit können Sie die integrierte Diff-Erfahrung im Bereich "Quellcodeverwaltung " verwenden, um Änderungen auf Elementebene zu überprüfen. Wählen Sie ein Element auf der Registerkarte "Änderungen " aus, um die aktuelle Arbeitsbereichsversion mit der letzten zugesicherten Version zu vergleichen, damit Sie Ihre Änderungen überprüfen können, bevor Sie sie an Git übertragen.
Nachdem das Eventstream-Element synchronisiert wurde, können Sie die neueste Eventstream-Änderung in Ihrem Git-Repository anzeigen.
Aktualisieren der Eventstream-Elemente aus Git
Wenn Sie Änderungen an Ihrem Eventstream-Element im Git-Repository vornehmen, wird in der Arbeitsbereichsansicht als Git-Status Update erforderlich neben Ihrem Eventstream-Element angezeigt. Wählen Sie die Schaltfläche Quellcodeverwaltung oben in der Ansicht aus, und wählen Sie Alle aktualisieren aus, um die neuesten Eventstream-Änderungen zusammenzuführen. Sie können auch den Diff für jedes Element auf der Registerkarte "Updates " überprüfen, bevor Sie Änderungen anwenden, um sicherzustellen, dass Sie verstehen, was in Ihrem Arbeitsbereich geändert wird.
Deployment von Eventstream-Elementen von einem Stadium in das nächste Stadium
- Wählen Sie in der Arbeitsbereichsansicht „Bereitstellungspipeline erstellen” aus. Sie können eine Pipeline auch über den Einstiegspunkt der Bereitstellungspipeline in Fabric (unten in der Liste der Arbeitsbereiche) erstellen.
- Sie können definieren, wie viele Phasen sie aufweisen soll und wie diese heißen sollen. Die Anzahl der Phasen ist dauerhaft und kann nach dem Erstellen der Pipeline nicht mehr geändert werden.
- Vergeben Sie einen Namen für Ihre Pipeline. Sie Standardpipeline hat drei Phasen namens Entwicklung, Test und Produktion. Sie können die Phasen umbenennen und zwischen 2 und 10 Phasen in einer Pipeline haben. Wählen Sie dann Erstellen und fortfahren aus.
- Nach dem Erstellen einer Pipeline können Sie jeder Phase einen Arbeitsbereich zuweisen. Screenshot, der zeigt, wie man einen Arbeitsbereich jeder Phase zuweist.
- Sobald Sie Inhalte in einer Pipelinephase haben, können Sie die Elemente auswählen und diese in der nächsten Phase bereitstellen, auch wenn der Arbeitsbereich der nächsten Phase Inhalte enthält. Gekoppelte Elemente werden überschrieben.
Sie können im Bereitstellungsverlauf überprüfen, wann Inhalte zuletzt für jede Phase bereitgestellt wurden. Über den Bereitstellungsverlauf kann ermittelt werden, wann eine Phase das letzte Mal aktualisiert wurde. Es kann auch hilfreich sein, wenn Sie die Zeit zwischen Bereitstellungen nachverfolgen möchten.
Weitere Informationen zur Bereitstellungspipeline finden Sie unter Erste Schritte mit Bereitstellungspipelines.
CI/CD-Unterstützung für Eventstream-Komponenten
Fabric CI/CD-Features umfassen Git-Integration, Bereitstellungspipelinen und öffentliche APIs. In diesem Abschnitt wird die Kompatibilität verschiedener Eventstream-Komponenten mit unterschiedlichen CI/CD-Features beschrieben. Das Verständnis dieser Supportebenen ist für das Warten und Bereitstellen von Eventstream-Elementen in arbeitsbereichsübergreifenden Arbeitsbereichen unerlässlich.
Sie können auch die Batch-APIs für Import/Export von Artikeldetails (Vorschau) für die Synchronisierung großer Elemente verwenden. Eventstream-Elemente können über diese Batch-APIs synchronisiert werden, um Vorgänge mit mehreren Arbeitsbereichen oder Umgebungen zu optimieren. Lesen Sie die API-Dokumentation für geltende Grenzwerte und Authentifizierungsanforderungen.
Supportebenendefinitionen
- Vollständig unterstützt: Die Konfiguration wird während der Bereitstellung vollständig beibehalten.
- Teilweise unterstützt: Die Ressource unterstützt CI/CD, aber erweiterte Einstellungen (z. B. Azure SQL DB (CDC)-Spaltenausschlussliste) werden nicht unterstützt und werden nach der Bereitstellung auf Standardwerte zurückgesetzt.
- Nicht unterstützt: Die Komponente unterstützt CI/CD nicht über Git-Integrations- und Bereitstellungspipelinen.
Komponentenunterstützungsmatrix
| Kategorie | Vollständig unterstützt | Teilweise unterstützt | Nicht unterstützt |
|---|---|---|---|
| Quellen | Standard-GA-Quellen (z. B. Azure Event Hubs, Confluent, Sample Data) | Azure SQL DB (CDC) Azure SQL Managed Instance (CDC) MySQL-Datenbank (CDC) PostgreSQL-Datenbank CDC SQL Server auf VM (CDC) |
Cribl (Vorschau) Anomalieerkennungsereignisse (Vorschau) |
| Flugziele | Eventhouse Lakehouse Abgeleiteter Stream Benutzerdefinierter Endpunkt Activator |
- | Geschäftsereignisse (Vorschau) Spark Notebook (Vorschau) |
| Betriebspersonal | Filter Verwalten von Feldern Aggregieren Beitreten Gruppieren nach Union Erweitern |
SQL-Code (benutzerdefinierter Code) | - |
| Funktionen | Allgemeine Funktionen (z. B. Multiple-Schema-Inferencing) | - | Status anhalten/fortsetzen |
Von Bedeutung
Nach der CI/CD-Implementierung (Git-Integrations- und Bereitstellungspipeline) werden alle Ressourcen im Zielereignisstream aktiv, es sei denn, sie schlagen wegen Verbindungs- oder Konfigurationsproblemen fehl. Die Ressourcen im ursprünglichen Eventstream (exportiert in Git) und im bereitgestellten Eventstream behalten ihre Zustände bei.
Warnung
Stellen Sie beim Importieren einer Azure Event Grid-Namespacequelle sicher, dass Sie über Mitglied- oder höhere Berechtigungen im Ziel-Fabric-Arbeitsbereich verfügen. Wenn dies nicht der Fall ist, fordern Sie die Berechtigung "Mitwirkender" für den Dienstprinzipal des Event Grid an, bevor Sie weiter fortzufahren.
Einschränkung
- Die Git-Integration und Bereitstellungspipeline bieten eingeschränkte Unterstützung für übergreifende Arbeitsbereichsszenarien. Um Probleme zu vermeiden, stellen Sie sicher, dass alle Eventstream-Ziele innerhalb desselben Arbeitsbereichs liegen. Die arbeitsbereichübergreifende Bereitstellung funktioniert möglicherweise nicht wie erwartet.
- Wenn ein Eventstream ein Eventhouse-Ziel mit dem Direct Ingestion-Modus enthält, müssen Sie die Verbindung nach dem Importieren oder Bereitstellen in einem neuen Arbeitsbereich manuell neu konfigurieren.
- Verbindungsverweise: Erwägen Sie die Verwendung von Verbindungsverweiselementen (Variable Library), um Verbindungen beim Bereitstellen von Eventstream-Elementen in arbeitsbereichsübergreifenden Arbeitsbereichen zu zentralisieren und neu zu verknüpfen. Dieser Ansatz kann die manuelle Neukonfiguration reduzieren, z. B. wenn Eventhouse-Ziele direct Ingestion verwenden.