Databricks Notebook-Schnittstelle und -Steuerelemente

Hier erfahren Sie, wie Sie über die Symbolleiste und die Menüs des Databricks-Notebooks die Anzeigeeinstellungen für Notebook und Zellen steuern können.

Notebookzellen

Notebooks enthalten eine Sammlung von zwei Zelltypen: Codezellen und Markdown-Zellen. Codezellen enthalten ausführbaren Code, während Markdown-Zellen Markdown-Code enthalten, der Text und Grafiken rendert. Markdown kann zum Dokumentieren oder Illustrieren ihres Codes verwendet werden. Sie können Ihrem Notebook Zellen hinzufügen oder entfernen, um Ihre Arbeit zu strukturieren.

Sie können eine einzelne Zelle, eine Gruppe von Zellen oder das gesamte Notebook gleichzeitig ausführen. Eine Notebook-Zelle kann höchstens 10 MB umfassen, und ihre Ausgabe ist auf 20 MB begrenzt.

Symbole und Schaltflächen der Notebooksymbolleiste

Symbolleiste enthält Menüs und Symbole, die Sie zum Verwalten und Bearbeiten des Notebooks verwenden können.

Neben dem Notebooknamen befinden sich Schaltflächen, mit denen Sie die Standardsprache des Notebooks ändern und Sie das Git-Dialogfeld öffnen können, wenn das Notebook in einem Databricks Git-Ordner enthalten ist.

Wenn Sie frühere Versionen des Notebooks anzeigen möchten, klicken Sie auf die Meldung „Letzte Bearbeitung“. rechts neben den Menüs.

Die Symbole auf der rechten Seite der Symbolleiste werden in der folgenden Tabelle beschrieben:

Symbol	BESCHREIBUNG
	Ausführen aller Zellen oder Beenden der Ausführung. Der Name dieser Schaltfläche ändert sich je nach Status des Notebooks.
	Öffnen Sie die Computeauswahl. Wenn das Notebook mit einem Cluster oder SQL-Warehouse verbunden ist, zeigt diese Schaltfläche den Namen der Computeressource an.
	Öffnen des Auftragsplaners.
	Öffnen von Delta Live Tables. Diese Schaltfläche wird nur angezeigt, wenn das Notebook Teil einer Delta Live Tables-Pipeline ist.
	Öffnen des Dialogfeldfelds „Berechtigungen“.

Aktionen auf der rechten Seitenleiste

In der rechten Seitenleiste des Notebooks sind mehrere Aktionen verfügbar, wie in der folgenden Tabelle beschrieben:

Symbol	BESCHREIBUNG
	Öffnen der Notebookkommentare.
	Öffnen von MLflow-Notebookexperiment.
	Öffnen Sie den Notebook-Versionsverlauf.
	Öffnen Sie den Variablen-Explorer. (Verfügbar für Python-Variablen ab Databricks Runtime 12.2 LTS)
	Öffnen Sie den Bereich „Python-Umgebung“. In diesem Bereich werden alle Python-Bibliotheken angezeigt, die für das Notebook verfügbar sind, einschließlich Notebookbibliotheken, Clusterbibliotheken und Bibliotheken, die in der Databricks Runtime enthalten sind. Nur verfügbar, wenn das Notebook an einen Cluster angefügt ist.

Erstellen von Zellen

In Notebooks gibt es zwei Typen von Zellen: Codezellen und Markdown-Zellen. Der Inhalt von Markdown-Zellen wird in HTML gerendert. Der folgende Codeausschnitt enthält beispielsweise Markup für eine Überschrift der Ebene 1:

%md ### Libraries
Import the necessary libraries.

Rendert wie hier gezeigt:

Wenn Sie eine neue Zelle erstellen möchten, zeigen Sie oben oder unten auf eine Zelle. Klicken Sie auf Code oder Text, um eine Code- oder eine Markdown-Zelle zu erstellen.

Zellenaktionen

Im Menü „Zellenaktionen“ können Sie Zellen ausführen, ausschneiden und kopieren, Zellen im Notebook verschieben, und Code oder Ergebnisse ausblenden.

Ausführen einer Zelle

Wenn Sie Codezellen ausführen möchten, klicken Sie oben links in der Codezelle auf den Pfeil nach unten.

Nachdem eine Zelle ausgeführt wurde, werden rechts neben dem Zellausführungsmenü die letzte Ausführungszeit der Zelle und die Dauer der Ausführung angezeigt. Zeigen Sie mit dem Mauszeiger auf den Hinweis, um weitere Details anzuzeigen.

Wenn Sie detaillierte Informationen zur Ausführung standardmäßig anzeigen möchten, klicken Sie oben rechts auf Ihr Profilbild. Klicken Sie dann auf Einstellungen>Entwickler>Detaillierte Informationen zur Befehlsausführung anzeigen.

Wenn Sie über eine tabellarische Ergebnisausgabe verfügen, können Sie auch auf diese Informationen zugreifen, indem Sie auf den Abschnitt „Zuletzt aktualisiert“ der Benutzeroberfläche zeigen.

Zellensymbole

Der folgende Screenshot beschreibt die Symbole, die oben rechts in einer Notebook-Zelle angezeigt werden:

Sprachauswahl: Wählen Sie die Sprache für die Zelle aus.

Databricks-Assistent: Aktivieren oder deaktivieren Sie den Databricks-Assistenten für Codevorschläge in der Zelle.

Zellenfokus: Vergrößern Sie die Zelle, um die Bearbeitung zu vereinfachen.

Menü „Zellenaktionen anzeigen“: Öffnen Sie das Menü „Zellenaktionen“. Die Optionen in diesem Menü unterscheiden sich geringfügig für Code- und Markdown-Zellen.

Löschen einer Zelle

Um eine Zelle zu löschen, klicken Sie rechts neben der Zelle auf das Papierkorbsymbol. Dieses Symbol wird nur angezeigt, wenn Sie mit dem Mauszeiger auf die Zelle zeigen.

Verschieben einer Zelle

Um eine Zelle nach oben oder unten zu verschieben, klicken Sie auf das Ziehpunktsymbol links neben der Zelle und halten Sie es gedrückt.

Sie können auch im Menü „Zellenaktionen“ die Option Nach oben oder die Option Nach unten auswählen.

Ausschneiden, Kopieren und Einfügen von Zellen

Es gibt verschiedene Möglichkeiten zum Ausschneiden und Kopieren von Zellen. Wenn Sie jedoch den Safari-Browser verwenden, sind nur die Tastaturkurzbefehle verfügbar.

• Wählen Sie im Menü für Zellenaktionen die Option Zelle ausschneiden oder Zelle kopieren aus.
• Verwenden Sie Tastenkombinationen: Command-X oder Ctrl-X zum Ausschneiden und Command-C oder Ctrl-C zum Kopieren.
• Verwenden Sie das Menü Bearbeiten oben im Notebook. Wählen Sie Ausschneiden oder Kopieren aus.

Nachdem Sie Zellen ausgeschnitten oder kopiert haben, können Sie diese Zellen an anderer Stelle im selben Notebook, in ein anderes Notebook oder in ein Notebook auf einer anderen Browserregisterkarte oder in einem anderen Fenster einfügen. Verwenden Sie zum Einfügen von Zellen die Tastenkombination Command-V oder Ctrl-V. Die Zellen werden unterhalb der aktuellen Zelle eingefügt.

Zum Rückgängigmachen von Aktionen zum Ausschneiden oder Einfügen können Sie die Tastenkombination Command-Z bzw. Ctrl-Z oder die Menüoptionen Bearbeiten > Ausschneiden von Zellen rückgängig machen oder Bearbeiten > Einfügen von Zellen rückgängig machen verwenden.

Um angrenzende Zellen auszuwählen, klicken Sie in einer Markdownzelle, und verwenden Sie dann UMSCHALT + NACH OBEN oder NACH UNTEN, um die Zellen darüber oder darunter auszuwählen. Verwenden Sie das Bearbeitungsmenü, um die ausgewählten Zellen als Gruppe zu kopieren, auszuschneiden, einzufügen oder zu löschen. Zum Auswählen aller Zellen wählen Sie Bearbeiten > Alle Zellen auswählen aus, oder verwenden Sie die Tastenkombination im Befehlsmodus CMD+A.

Öffnen des Databricks-Assistenten

Um ein Textfeld des Databricks-Assistenten in einer Zelle zu öffnen, klicken Sie auf das Symbol des Databricks-Assistenten in der oberen rechten Ecke der Zelle.

Sie können ihn in einer Codezelle einsetzen, um Hilfe oder Vorschläge für Ihren Code zu erhalten. Der Databricks-Assistent muss in Ihrem Arbeitsbereich aktiviert sein.

Hinzufügen von Codekommentaren

Wenn Sie einem Code in einer Zelle einen Kommentar hinzufügen möchten, markieren Sie den Code. Rechts neben der Zelle wird ein Kommentarsymbol angezeigt. Klicken Sie auf das Symbol, um das Kommentarfeld zu öffnen.

Hinzufügen einer Zelle zu einem Dashboard

Wenn Sie eine Markdown-Zelle oder eine Zelle mit tabellarischen Ergebnissen zu einem Dashboard hinzufügen möchten, wählen Sie im Menü „Zellenaktionen“ die Option Zu Dashboard hinzufügen aus. Weitere Informationen finden Sie unter Dashboards in Notebooks.

Verknüpfen mit einer Zelle

Um einen URL-Link zu einem bestimmten Befehl in Ihrem Notebook abzurufen, klicken Sie auf , um den Fokusmodus zu öffnen, und kopieren Sie die URL aus der Adressleiste des Browsers. Klicken Sie zum Beenden des Fokusmodus auf .

Notebook – Inhaltsverzeichnis

Um ein automatisch generiertes Inhaltsverzeichnis anzuzeigen, klicken Sie auf das Symbol oben links im Notebook (zwischen der linken Seitenleiste und der obersten Zelle). Das Inhaltsverzeichnis wird anhand der im Notebook verwendeten Markdownüberschriften generiert. Zellen mit Titeln werden auch im Inhaltsverzeichnis angezeigt.

Hinzufügen eines Zellentitels

Führen Sie eine der folgenden Aktionen aus, um einer Zelleeinen Titel hinzuzufügen:

• Klicken Sie auf die Zellennummer oben in der Mitte der Zelle und geben Sie den Titel ein.
• Wählen Sie Titel hinzufügen aus dem Menü Zellaktionen aus.

Zellen mit Titeln werden im Inhaltsverzeichnis des Notebooks angezeigt.

Höhergestufte Zellentitel

Damit Zellentitel auf der Benutzeroberfläche besser sichtbar sind, können Benutzer Höhergestufte Zellentitel anzeigen aktivieren.

1. Klicken Sie auf einer beliebigen Seite in der oberen rechten Ecke auf Ihr Profilfoto und anschließend auf Einstellungen.
2. Klicken Sie auf Entwickler> Aktivieren Höhergestufte Zellentitel anzeigen.

Ein- und Ausblenden von Zelleninhalt

Der Zelleninhalt besteht aus Zellencode und den Ergebnissen der Zellenausführung. Klicken Sie zum Ausblenden von Zellencode oder Ergebnissen oben rechts in der Zelle auf das Kebab-Menü , und wählen Sie Code ausblenden oder Ergebnis ausblenden aus.

Sie können auch Zelle reduzieren auswählen, um nur die erste Zeile einer Zelle anzuzeigen. Wählen Sie zum Erweitern einer reduzierten Zelle Zelle erweitern aus.

Klicken Sie zum Anzeigen von ausgeblendeten Zellen auf das Symbol zum Anzeigen: .

Reduzierbare Überschriften

Zellen, die nach Zellen mit Markdownüberschriften angezeigt werden, können in der Überschriftenzelle reduziert werden. Um Zellen nach Zellen mit Markdownüberschriften im gesamten Notebook zu erweitern oder zu reduzieren, wählen Sie im Menü Ansicht die Option Alle Überschriften reduzieren aus. Im Rest dieses Abschnitts wird beschrieben, wie eine Teilmenge von Zellen erweitert oder reduziert wird.

Erweitern und Reduzieren von Überschriften

Die Abbildung zeigt die Überschrift MLflow setup der Ebene 1, in der die folgenden beiden Zellen reduziert sind:

Um Überschriften zu erweitern und zu reduzieren, zeigen Sie mit dem Mauszeiger auf die Markdown-Zelle. Klicken Sie auf den Pfeil, der links neben der Zelle angezeigt wird.

Anzeigeoptionen für Zellen

Es gibt drei Anzeigeoptionen für Notebooks. Verwenden Sie das Menü Ansicht, um die Anzeigeoption zu ändern.

• Standardansicht: Ergebnisse werden unmittelbar nach Codezellen angezeigt.
• Nur Ergebnisse: Nur Ergebnisse werden angezeigt.
• Nebeneinander: Code- und Ergebniszellen werden nebeneinander angezeigt.

Es stehen Aktionen über Symbole im Zellbundsteg (Bereich rechts und links von der Zelle) zur Verfügung. Sie können beispielsweise das Steuerelement zum Verschieben einer Zelle nach oben oder unten im linken Bundsteg verwenden. Um eine Zelle zu löschen, verwenden Sie das Papierkorbsymbol im rechten Bundsteg.

Um die Bearbeitung zu vereinfachen, klicken Sie auf das Symbol für den Fokusmodus , um die Zelle in voller Breite anzuzeigen. Klicken Sie zum Beenden des Fokusmodus auf . Sie können die angezeigte Breite einer Zelle auch vergrößern, indem Sie Ansicht > Zentriertes Layout deaktivieren.

Wenn Sie die Länge und den Abstand aller Zellen im Notebook automatisch nach Branchenstandard formatieren möchten, wählen Sie Bearbeiten > Notebook formatieren aus.

Entfernen von Zellrändern

Sie können Ränder erweitern oder minimieren, indem Sie im Notebook-Menü auf Anzeigen > Notebook-Layout klicken.

Zeilen- und Befehlsnummern

Um Zeilennummern oder Befehlsnummern ein- oder auszublenden, wählen Sie im Menü Ansicht die Option Zeilennummern oder Befehlsnummern aus. Für Zeilennummern können Sie auch die Tastenkombination STRG+L verwenden. Wenn sich eine Zelle in einem fehlerhaften Zustand befindet, werden Zeilennummern unabhängig von der Auswahl angezeigt.

Wenn Sie Zeilen- oder Befehlszeilennummern aktivieren, speichert Databricks Ihre Einstellung und zeigt die Nummern in allen anderen Notebooks für diesen Browser an.

Zeilenumbruch

Sie können den Zeilenumbruch in Notebook-Zellen aktivieren oder deaktivieren, sodass Text entweder in mehrere Zeilen umbrochen oder auf einer einzelnen Zeile mit horizontalem Bildlauf verbleibt.

1. Klicken Sie auf einer beliebigen Seite in der oberen rechten Ecke auf Ihr Profilfoto und anschließend auf Einstellungen.
2. Klicken Sie auf Entwicklereinstellungen>Zeilenumbruch.

Anzeigen von Notebooks im dunklen Modus

Sie können Notebooks im dunklen Modus anzeigen. Zum Aktivieren oder Deaktivieren des dunklen Modus wählen Sie Ansicht > Design und dann Helles Design oder Dunkles Design aus.

Wenn Sie Zeilen- oder Befehlszeilennummern aktivieren, speichert Databricks Ihre Einstellung und zeigt die Nummern in Ihren anderen Notebooks für diesen Browser an.

Durchsuchen von Daten

Um Tabellen und Volumens zu durchsuchen, die für die Verwendung im Notebook zur Verfügung stehen, klicken Sie auf das auf der linken Seite des Notebooks, um den Schemabrowser zu öffnen. Weitere Informationen finden Sie unter Durchsuchen von Daten.

Verwenden von Webterminal und Databricks CLI

Um das Webterminal in einem Notebook zu öffnen, wählen Sie unten auf der rechten Randleiste aus.

Verwenden der Databricks CLI in einem Webterminal

Ab Databricks Runtime 15.0 können Sie die Databricks CLI aus dem Webterminal im Notebook verwenden.

Anforderungen

• Das Notebook muss an ein Cluster im Zugriffsmodus Einzelbenutzer oder Keine Isolation, freigegeben angefügt werden.
• Die CLI ist nicht in Arbeitsbereichen verfügbar, in denen Private Link aktiviert wurde.

Die installierte CLI ist immer die neueste Version. Die Authentifizierung basiert auf dem aktuellen Benutzerkonto.

Sie können die CLI nicht aus einer Notebookzelle verwenden. In einem Notebook funktionieren Befehle wie %sh databricks ... nicht mit Databricks Runtime 15.0 oder höher.