Entwickeln und Debuggen von Delta Live Tables-Pipelines in Notebooks

Wichtig

Die Notebook-Umgebung für die Entwicklung von Delta Live Tables befindet sich in Public Preview.

Dieser Artikel beschreibt Features in Azure Databricks-Notebooks, die die Entwicklung und das Debuggen von Delta Live Tables-Code unterstützen.

Übersicht über die Funktionen

Wenn Sie an einem Python- oder SQL-Notebook arbeiten, das der Quellcode für eine vorhandene Delta Live Tables-Pipeline ist, können Sie das Notebook direkt mit Ihrer Pipeline verbinden. Wenn das Notizbuch mit der Pipeline verbunden ist, stehen die folgenden Features zur Verfügung:

• Die Pipeline über das Notebook starten und überprüfen.
• Das Dataflowdiagramm und das Ereignisprotokoll der Pipeline für das neueste Update im Notebook anzeigen.
• Die Pipelinediagnose im Notebook-Editor anzeigen.
• Den Clusterstatus der Pipeline im Notebook anzeigen.
• Auf die Delta Live Tables-Benutzeroberfläche über das Notebook zugreifen.

Voraussetzungen

• Sie müssen eine vorhandene Delta Live Tables-Pipeline mit einem Python- oder SQL-Notebook als Quellcode haben.
• Sie müssen entweder der Besitzer der Pipeline sein oder über die Berechtigung CAN_MANAGE verfügen.

Begrenzungen

• Die in diesem Artikel behandelten Features sind nur in Azure Databricks-Notebooks verfügbar. Arbeitsbereichsdateien werden nicht unterstützt.
• Das Webterminal ist nicht verfügbar, wenn es an eine Pipeline angefügt ist. Daher ist es im unteren Bereich nicht als Registerkarte sichtbar.

Verbinden eines Notebooks mit einer Delta Live Tables-Pipeline

Klicken Sie im Notebook auf das Dropdownmenü, das zum Auswählen der Berechnung verwendet wird. Im Dropdownmenü werden alle Ihre Delta Live Tables-Pipelines mit diesem Notebook als Quellcode angezeigt. Um das Notebook mit einer Pipeline zu verbinden, wählen Sie es aus der Liste aus.

Anzeigen des Clusterstatus der Pipeline

Um den Status des Clusters Ihrer Pipeline einfach zu erkennen, wird sein Status im Dropdownmenü zur Berechnung grün angezeigt, wenn das Cluster ausgeführt wird.

Überprüfen des Pipelinecodes

Sie können die Pipeline überprüfen, um Syntaxfehler in Ihrem Quellcode zu suchen, ohne Daten zu verarbeiten.

Um eine Pipeline zu überprüfen, führen Sie eine der folgenden Aktionen aus:

• Klicken Sie in der oberen rechten Ecke des Notebooks auf Überprüfen.
• Drücken Sie Shift+Enter in einer beliebigen Notebook-Zelle.
• Klicken Sie im Dropdownmenü einer Zelle auf Pipeline überprüfen.

Hinweis

Wenn Sie versuchen, Ihre Pipeline zu überprüfen, während bereits ein vorhandenes Update ausgeführt wird, wird in einem Dialogfeld gefragt, ob Sie das vorhandene Update beenden möchten. Wenn Sie auf Ja klicken, wird das vorhandene Update beendet, und die Update-Überprüfung wird automatisch gestartet.

Starten der Pipeline

Ein Pipeline-Update führt die folgenden Aktionen aus: Startet ein Cluster, ermittelt und überprüft alle definierten Tabellen und Ansichten, und erstellt oder aktualisiert Tabellen und Ansichten mit den neuesten verfügbaren Daten.

Um ein Update Ihrer Pipeline zu starten, klicken Sie in der oberen rechten Ecke des Notebooks auf die Schaltfläche Start.

Anzeigen des Status eines Updates

Im oberen Bereich des Notebooks wird angezeigt, ob ein Pipeline-Update in einem der folgenden Zustände vorliegt:

• Wird gestartet
• Die Überprüfen erfolgt.
• Wird beendet

Anzeigen von Fehlern und Diagnosen

Nachdem eine Pipeline gestartet oder überprüft wurde, werden alle Fehler inline rot unterstrichen angezeigt. Zeigen Sie mit der Maus auf einen Fehler, um weitere Informationen anzuzeigen.

Anzeigen von Pipeline-Ereignissen

Wenn sie an eine Pipeline angefügt ist, befindet sich unten im Notebook eine Registerkarte für das Delta Live Tables-Ereignisprotokoll.

Anzeigen des Pipeline-Dataflowdiagramms

Um das Dataflowdiagramm einer Pipeline anzuzeigen, verwenden Sie die Data Live Tables-Diagrammregisterkarte unten im Notebook. Wenn Sie einen Knoten im Diagramm auswählen, wird dessen Schema im rechten Bereich angezeigt.

Zugreifen auf die Delta Live Tables-Benutzeroberfläche über das Notebook

Um einfach zur Delta Live Tables-Benutzeroberfläche zu springen, verwenden Sie das Menü in der oberen rechten Ecke des Notebooks.

Zugreifen auf Treiberprotokolle und die Spark-Benutzeroberfläche über das Notebook

Auf die Treiberprotokolle und die Spark-Benutzeroberfläche, die mit der zu entwickelnden Pipeline verbunden sind, kann einfach über das Menü Ansicht des Notebooks zugegriffen werden.