Quellcodeverwaltung und Bereitstellung von Notebooks

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

Git-Integration von Notebooks

Fabric-Notebooks bieten Git-Integration für die Quellcodeverwaltung mit Azure DevOps. Mit der Git-Integration können Sie Ihr Notebook sichern und Versionen des Notebooks verwalten, es nach Bedarf auf vorherige Phasen zurücksetzen, mithilfe von Git-Branches eigenständig arbeiten oder mit anderen zusammenarbeiten und den gesamten Lebenszyklus des Notebookinhalts in Fabric verwalten.

Wichtig

Dieses Feature befindet sich in der Vorschauphase.

Herstellen einer Verbindung

Über Ihre Arbeitsbereichseinstellungen können Sie ganz einfach eine Verbindung mit Ihrem Repository einrichten, um Änderungen zu committen und zu synchronisieren. Informationen zum Einrichten der Verbindung finden Sie unter Erste Schritte mit der Git-Integration. Nach dem Herstellen der Verbindung werden Ihre Elemente (einschließlich Notebooks) im Bereich Quellcodeverwaltung angezeigt.

Nachdem Sie die Notebookinstanzen erfolgreich in das Git-Repository committet haben, wird die Ordnerstruktur des Notebooks im Repository angezeigt.

Sie können nun zukünftige Vorgänge ausführen, z. B. Pull Request erstellen.

Notebookdarstellung in Git

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

Wenn Sie das Notebookelement in das Git-Repository committen, wird der Notebookcode in ein Quellcodeformat konvertiert und nicht in eine standardmäßige IPYNB-Datei. Beispielsweise wird ein PySpark-Notebook in eine Datei „notebook-content.py“ konvertiert. Dieser Ansatz ermöglicht einfachere Code Reviews mithilfe integrierter Diff-Features.

In der Quelldatei des Elementinhalts werden Metadaten (einschließlich des Standard-Lakehouse und der angefügten Umgebung), Markdown-Zellen und Codezellen beibehalten und unterschieden. Dieser Ansatz ermöglicht eine präzise Wiederherstellung bei der Rückwärtssynchronisierung mit einem Fabric-Arbeitsbereich.

Die Ausgabe von Notebookzellen ist bei der Synchronisierung mit Git nicht enthalten.

Hinweis

• Derzeit werden Dateien in Notebookressourcen nicht in das Repository committet. Das Committen dieser Dateien wird in einer zukünftigen Version unterstützt.
• Die angefügte Umgebung bleibt in einem Notebook erhalten, wenn Sie die Synchronisierung vom Repository in einen Fabric-Arbeitsbereich durchführen. Derzeit werden arbeitsbereichsübergreifende Verweisumgebungen nicht unterstützt. Sie müssen manuell eine neue Umgebung oder Standardeinstellungen für einen Arbeitsbereich zum Ausführen des Notebooks anfügen.
• Die Standard-Lakehouse-ID bleibt im Notebook erhalten, wenn Sie die Synchronisierung vom Repository in einen Fabric-Arbeitsbereich durchführen. Wenn Sie ein Notebook mit dem Standard-Lakehouse committen, müssen Sie manuell auf ein neu erstelltes Lakehouse-Element verweisen. Weitere Informationen finden Sie im Thema zur Lakehouse Git-Integration.

Notebook in Bereitstellungspipelines

Sie können die Bereitstellungspipeline auch verwenden, um Ihren Notebookcode in verschiedenen Umgebungen bereitzustellen, z. B. in der Entwicklungs-, Test- und Produktionsumgebung. Mit diesem Feature können Sie Ihren Entwicklungsprozess optimieren, die Qualität und Konsistenz sicherstellen und manuelle Fehler mit einfachen Vorgängen mit wenig Code reduzieren. Sie können auch Bereitstellungsregeln verwenden, um das Verhalten Ihrer Notebooks bei der Bereitstellung anzupassen, z. B. durch Ändern des Standard-Lakehouse eines Notebooks.

Wichtig

Dieses Feature befindet sich in der Vorschauphase.

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

1. Erstellen Sie eine neue Bereitstellungspipeline, oder öffnen Sie eine vorhandene Bereitstellungspipeline. Weitere Informationen finden Sie unter Get started with deployment pipelines (Erste Schritte mit Bereitstellungspipeline).

2. Weisen Sie Arbeitsbereiche entsprechend Ihren Bereitstellungszielen verschiedenen Phasen zu.

3. Wählen Sie wie im folgenden Beispiel gezeigt Elemente aus (einschließlich Notebooks zwischen verschiedenen Phasen), zeigen Sie sie an, und vergleichen Sie sie.

   

4. Wählen Sie Bereitstellen aus, um Ihre Notebooks in den Entwicklungs-, Test- und Produktionsphasen bereitzustellen.

5. (Optional.) Sie können Bereitstellungsregeln auswählen, um Bereitstellungsregeln für einen Bereitstellungsprozess zu erstellen. Bereitstellungsregeln werden in der Zielphase für einen Bereitstellungsprozess eingegeben.

   

   Fabric unterstützt die Parametrisierung des Standard-Lakehouse für beliebige Notebookinstanzen bei der Bereitstellung mit Bereitstellungsregeln. Es stehen drei Optionen zur Verfügung, um das standardmäßige Ziel-Lakehouse anzugeben: identisch mit dem Quell-Lakehouse, Nicht zutreffend und „anderes Lakehouse“.

   

   Sie können die Isolation gesicherter Daten erreichen, indem Sie diese Regel einrichten. Das Standard-Lakehouse Ihres Notebooks wird durch das Standard-Lakehouse ersetzt, das Sie während der Bereitstellung als Ziel angegeben haben.

   Hinweis

   Wenn Sie sich dafür entscheiden, andere Lakehouses in der Zielumgebung zu übernehmen, ist die Lakehouse-ID unbedingt erforderlich. Die ID eines Lakehouse können Sie der Lakehouse-URL entnehmen.

6. Überwachen Sie den Bereitstellungsstatus unter Bereitstellungsverlauf.

Zugehöriger Inhalt

• Verwalten und Ausführen von Fabric-Notebooks mit öffentlichen APIs
• Einführung in die Git-Integration
• Einführung in Bereitstellungspipelines