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.
Erfahren Sie, wie Git-Integrations- und Bereitstellungspipelinen mit DER API für GraphQL in Microsoft Fabric arbeiten. In diesem Artikel erfahren Sie, wie Sie eine Verbindung mit Ihrem Repository einrichten, Ihre API für GraphQL verwalten und in verschiedenen Umgebungen bereitstellen können.
Hinweis
Die API für die GraphQL-Quellcodeverwaltung und -Bereitstellung befindet sich derzeit in der Vorschau.
Voraussetzungen
- Sie müssen über eine API für GraphQL in Fabric verfügen. Weitere Informationen finden Sie unter Erstellen einer API für GraphQL in Fabric und Hinzufügen von Daten.
Überblick
Fabric bietet leistungsstarke Tools für CI/CD (kontinuierliche Integration und kontinuierliche Bereitstellung) und Das Lebenszyklusmanagement der Entwicklung über zwei Hauptkomponenten: Git-Integration (CI) und Bereitstellungspipelinen (CD). Arbeitsbereiche dienen als zentrale Komponenten für git-Synchronisierungs- und Bereitstellungsphasen.
Git-Integration (CI): Synchronisiert Arbeitsbereichselemente (z. B. Code, Konfigurationen, APIs) mit Versionssteuerungsrepositorys, aktivieren die Versionssteuerung und Änderungsnachverfolgung über Git.
Bereitstellungspipelinen (CD):Ermöglicht die Erstellung von Phasen (z. B. Entwicklung, Test, Produktion) mit verknüpften Arbeitsbereichen. Elemente, die in jeder Phase unterstützt werden, werden automatisch in nachfolgende Phasen repliziert und Änderungen in einer Arbeitsbereichstriggerbereitstellung in einer Releasepipeline ausgelöst. Sie können die Pipeline konfigurieren, um sicherzustellen, dass Änderungen in allen Umgebungen getestet und effizient bereitgestellt werden.
Fabric unterstützt verschiedene CI/CD-Workflows, die auf gängige Szenarien zugeschnitten sind. Weitere Informationen finden Sie unter CI/CD-Workflowoptionen in Fabric.
Hinweis
Während der Bereitstellung werden nur Metadaten kopiert; und Daten werden nicht kopiert.
Elemente aus dem Arbeitsbereich werden im zugeordneten Git-Repository als Infrastruktur als Code (IaC) gespeichert. Codeänderungen im Repository können die Bereitstellung in Pipelines auslösen. Mit dieser Methode können Sie Codeänderungen für Test- und Produktionsfreigabezwecke automatisch repliziert haben.
Methoden für die Datenquellenauthentifizierung
In diesem Abschnitt erfahren Sie mehr über Authentifizierungsmethoden, um Datenquellen mit Ihrer API für GraphQL zu verbinden und deren Auswirkungen auf die automatische Bindung zwischen der API für GraphQL und den verbundenen Datenquellen in Entwicklungspipelinen zu verstehen. Weitere Informationen zur automatischen Bindung im Bereitstellungspipelineprozess.
Es stehen zwei Optionen zum Verbinden von Datenquellen mit Ihrer API für GraphQL zur Verfügung:
Herstellen einer Verbindung mit Fabric-Datenquellen mit Single Sign-On-Authentifizierung (Single Sign-On Authentication, SSO)
Herstellen einer Verbindung mit Fabric ODER externen Datenquellen mithilfe einer gespeicherten Anmeldeinformation
Die erste Option, Single Sign-On (SSO), ermöglicht Verbindungen mit Datenquellen in Fabric. Wenn Sie in diesem Fall eine Datenquelle mit GraphQL mithilfe der Single Sign-On-Methode im ursprünglichen Arbeitsbereich (z. B. Dev-Phase) verbinden, wird die Datenquelle und das GraphQL-Element im Zielarbeitsbereich (z. B. Testphase) in der Pipeline bereitgestellt, und GraphQL im Zielarbeitsbereich wird automatisch mit der bereitgestellten lokalen Datenquelle im Zielarbeitsbereich verbunden (siehe das folgende Diagramm). Es gibt spezifische Einschränkungen bei der Verwendung von SSO und herstellen einer Verbindung mit einer Datenquelle über DEN SQL Analytics-Endpunkt, weitere Details finden Sie unter **Aktuelle Einschränkungen.
Mit der zweiten Option " Gespeicherte Anmeldeinformationen" können Verbindungen zu externen Datenquellen außerhalb von Fabric und Datenquellen in Fabric hergestellt werden. Die automatische Bindung wird jedoch für den Ansatz "Gespeicherte Anmeldeinformationen" nicht unterstützt. Dies bedeutet: Wenn Sie eine Datenquelle mit GraphQL mithilfe der gespeicherten Anmeldeinformationen im ursprünglichen Arbeitsbereich (Dev-Phase) verbinden, wird die Datenquelle im Zielarbeitsbereich (Testphase) in der Pipeline bereitgestellt. Das GraphQL-Element im Zielarbeitsbereich bleibt jedoch über die gespeicherten Anmeldeinformationen mit der Datenquelle im ursprünglichen Arbeitsbereich (Dev-Phase) verbunden, anstatt automatisch an eine lokale Datenquelle im Zielarbeitsbereich zu binden. (siehe nachstehendes Diagramm)
Wenn die Methode "Gespeicherte Anmeldeinformationen" zum Herstellen einer Verbindung mit Datenquellen verwendet wird, müssen Entwickler Zugriff auf die Informationen zu den Gespeicherten Anmeldeinformationen haben, um das GraphQL-Element erfolgreich bereitzustellen.
Hinweis
Wenn eine API für GraphQL im ursprünglichen Arbeitsbereich (Dev-Phase) mit einer Datenquelle verbunden ist, die sich in einem anderen Arbeitsbereich befindet, bleibt die bereitgestellte API für GraphQL im Zielarbeitsbereich (Testphase) mit der Datenquelle verbunden, die sich in einem anderen Arbeitsbereich befindet, unabhängig davon, welche Authentifizierungsmethode verwendet wird, um die Datenquellen mit Ihrer API für GraphQL zu verbinden. (siehe nachstehendes Diagramm)
API für die GraphQL-Git-Integration
Die Fabric-API für GraphQL bietet Git-Integration für die Quellcodeverwaltung. Mit der Git-Integration können Sie Ihre API für GraphQL sichern und versionieren, bei Bedarf zu früheren Phasen zurückkehren, mit Git-Verzweigungen zusammenarbeiten oder alleine arbeiten und Ihre API für den GraphQL-Lebenszyklus vollständig in Fabric verwalten.
Einrichten einer Verbindung:
Über Ihre Arbeitsbereichseinstellungen können Sie ganz einfach eine Verbindung mit Ihrem Repository einrichten, um Änderungen zu übernehmen und zu synchronisieren. Informationen zum Einrichten der Verbindung finden Sie unter "Erste Schritte mit der Git-Integration". Sobald die Verbindung hergestellt wurde, erscheinen Ihre Elemente, einschließlich der API für GraphQL, im Quellcodeverwaltungsbereich.
Nachdem Sie die API für GraphQL-Instanzen erfolgreich auf das Git-Repository übertragen haben, wird die GraphQL-Ordnerstruktur im Repository angezeigt. Sie können jetzt zukünftige Vorgänge ausführen, z. B. "Pullanforderung erstellen".
GraphQL-Darstellung in Git:
Die folgende Abbildung ist ein Beispiel für die Dateistruktur jeder API für graphQL-Element im Git-Repository:
Wenn Sie die API für das GraphQL-Element auf das Git-Repository übernehmen, wird die API für die GraphQL-Definition gespeichert. Dieser Ansatz unterstützt eine präzise Wiederherstellung, wenn Sie zu einem Fabric-Arbeitsbereich zurücksynchronisieren.
Weitere Informationen zum GraphQL-API-Definitionsformat, zur Syntax und zu Beispielen finden Sie in der Dokumentation zu Fabric-Steuerelementebenen-APIs:
API für GraphQL in der Bereitstellungspipeline
Führen Sie die folgenden Schritte aus, um Ihre API für die GraphQL-Bereitstellung mithilfe der Bereitstellungspipeline abzuschließen.
Erstellen Sie eine neue Bereitstellungspipeline, oder öffnen Sie eine vorhandene Bereitstellungspipeline. Weitere Informationen finden Sie unter "Erste Schritte mit Bereitstellungspipelines".
Weisen Sie Arbeitsbereiche entsprechend Ihren Bereitstellungszielen verschiedenen Phasen zu.
Elemente einschließlich API für GraphQL zwischen verschiedenen Phasen auswählen, anzeigen und vergleichen, wie im folgenden Beispiel gezeigt. Die hervorgehobenen Bereiche, die die Anzahl der geänderten Elemente zwischen der vorherigen Stufe und der aktuellen Stufe angeben.
- Wählen Sie die Elemente aus, die bereitgestellt werden müssen. Wählen Sie "Bereitstellen" aus, um Ihre ausgewählten Elemente (API für GraphQL und die zugehörige verbundene Datenquelle) in den Entwicklungs-, Test- und Produktionsphasen bereitzustellen.
Die nächste Nachricht wird eingeblendt, um die Elemente zu bestätigen, die Sie bereitstellen möchten. Wählen Sie "Bereitstellen" aus, um den Bereitstellungsprozess zu bestätigen und fortzusetzen.
Aktuelle Einschränkungen
Fabric CI/CD unterstützt keine automatische Bindung der untergeordneten Elemente. Dies bedeutet: Wenn die API für GraphQL eine Verbindung mit einem SQL Analytics-Endpunkt als untergeordnetes Element einer Datenquelle im ursprünglichen Arbeitsbereich (z. B. Dev-Stufe) herstellt, wird die Linie nicht an den Zielarbeitsbereich übertragen (z. B. Testphase). Daher bleibt die bereitgestellte API für GraphQL im Zielarbeitsbereich (z. B. Testphase) im ursprünglichen Arbeitsbereich (z. B. Dev-Stufe) mit dem SQL Analytics-Endpunkt verbunden.
Die automatische Bindung wird nicht unterstützt, wenn der Ansatz für gespeicherte Anmeldeinformationen für Datenquellenverbindungen verwendet wird. Weitere Informationen finden Sie im Abschnitt " Methoden zur Datenquellenauthentifizierung " weiter oben beschrieben.