Schreiben von Abfragen und Untersuchen von Daten im SQL-Editor

Die Benutzeroberfläche von Azure Databricks umfasst einen SQL-Editor, mit dem Sie Abfragen erstellen, verfügbare Daten durchsuchen und Visualisierungen erstellen können. Sie können Ihre gespeicherten Abfragen auch für andere Teammitglieder im Arbeitsbereich freigeben.

Nach dem Öffnen des Editors können Sie eine SQL-Abfrage erstellen oder die verfügbaren Daten durchsuchen. Der Text-Editor unterstützt AutoVervollständigen, automatische Formatierungen und verschiedene andere Tastenkombinationen.

Über die Abfrageregisterkarten am oberen Rand des Text-Editors können Sie mehrere Abfragen öffnen. Jede Abfrageregisterkarte enthält Steuerelemente zum Ausführen der Abfrage, zum Markieren der Abfrage als Favorit und zum Herstellen einer Verbindung mit einem SQL-Warehouse. Sie können Abfragen auch speichern, planen oder freigeben.

SQL-Editor öffnen

Um den SQL-Editor in der Benutzeroberfläche von Azure Databricks zu öffnen, klicken Sie in der Randleiste auf den SQL-Editor.

Der SQL-Editor öffnet sich zu Ihrer zuletzt geöffneten Abfrage. Wenn keine Abfrage vorhanden ist oder alle Ihre Abfragen explizit geschlossen wurden, wird eine neue Abfrage geöffnet. Es wird automatisch Neue Abfrage genannt und der Zeitstempel für die Erstellung wird im Titel angefügt.

Verbindung mit Computeressource herstellen

Sie müssen mindestens über die Berechtigung „KANN VERWENDEN“ für ein ausgeführtes SQL-Warehouse verfügen, um Abfragen auszuführen. Sie können die Dropdownliste am oberen Rand des Editors verwenden, um die verfügbaren Optionen anzuzeigen. Um die Liste zu filtern, geben Sie Text im Textfeld ein.

Beim erstmaligen Erstellen einer Abfrage wird die Liste der verfügbaren SQL-Warehouses in alphabetischer Reihenfolge angezeigt. Wenn Sie das nächste Mal eine Abfrage erstellen, ist das zuletzt verwendete SQL-Warehouse ausgewählt.

Das Symbol neben dem SQL-Warehouse gibt den Status an:

• Wird ausgeführt
• Wird gestartet
• Angehalten

Hinweis

Sollten die Liste keine SQL-Warehouses enthalten, wenden Sie sich an Ihre Arbeitsbereichsadministrator*innen.

Das ausgewählte SQL-Warehouse wird automatisch neu gestartet, wenn Sie die Abfrage ausführen. Weitere Möglichkeiten zum Starten eines SQL-Warehouse finden Sie unter Starten eines SQL-Warehouse.

Durchsuchen von Datenobjekten in SQL-Editor

Wenn Sie über die Berechtigung zum Lesen von Metadaten verfügen, werden im Schemabrowser des SQL-Editors die verfügbaren Datenbanken und Tabellen angezeigt. Sie können auch im Katalog-Explorer nach Datenobjekten suchen.

Sie können in Unity Catalog-gesteuerte Datenbankobjekte im Katalog-Explorer navigieren, ohne den aktiven Compute auszuführen. Um Daten in hive_metastore und anderen Katalogen zu untersuchen, die nicht durch den Unity-Katalog geregelt werden, müssen Sie dem Compute die entsprechenden Berechtigungen anfügen. Weitere Informationen finden Sie unter Datengovernance mit Unity Catalog.

Hinweis

Wenn im Schemabrowser oder im Katalog-Explorer keine Datenobjekte vorhanden sind, wenden Sie sich an die Arbeitsbereichsadministrator*innen.

Wählen Sie am oberen Rand des Schemabrowsers aus, um das Schema zu aktualisieren. Sie können das Schema filtern, indem Sie in das Suchfeld Filterzeichenfolgen eingeben.

Wählen Sie einen Tabellennamen aus, um die Spalten dieser Tabelle anzuzeigen.

Erstellen einer Abfrage

Sie können Text eingeben, um im SQL-Editor eine Abfrage zu erstellen. Sie können Elemente aus dem Schemabrowser einfügen, um auf Kataloge und Tabellen zu verweisen.

1. Geben Sie Ihre Abfrage in den SQL-Editor ein.

   Der SQL-Editor unterstützt AutoVervollständigen. Während der Eingabe schlägt AutoVervollständigen Vervollständigungen vor. Wenn beispielsweise eine gültige Vervollständigung an der Cursorposition eine Spalte ist, schlägt AutoVervollständigen einen Spaltennamen vor. Wenn Sie select * from table_name as t where t. eingeben, erkennt AutoVervollständigen, dass t ein Alias für table_name ist, und schlägt die Spalten in table_name vor.

   

2. (Optional) Wenn Sie die Bearbeitung beendet haben, klicken Sie auf Speichern. Standardmäßig wird die Abfrage in Ihrem Benutzer-Basisordner gespeichert, oder Sie können einen anderen Speicherort auswählen. Klicken Sie dann auf Speichern.

Aktivieren und Deaktivieren von AutoVervollständigen

Mit Live-AutoVervollständigen können Sie Schematoken, Abfragesyntaxbezeichner (z. B. SELECT und JOIN) und die Titel von Abfrageausschnitten vervollständigen. AutoVervollständigen ist standardmäßig aktiviert, sofern Ihr Datenbankschema 5.000 Token (Tabellen oder Spalten) nicht überschreitet.

Verwenden Sie den Umschalter unter dem SQL-Editor, um AutoVervollständigen zu aktivieren oder zu deaktivieren.

• Um AutoVervollständigen zu deaktivieren, drücken Sie STRG+LEERTASTE oder wählen unterhalb des SQL-Editors die Schaltfläche aus.

Speichern von Abfragen

Mit der Schaltfläche Speichern rechts oben im SQL-Editor speichern Sie Ihre Abfrage.

Wichtig

Wenn Sie eine Abfrage ändern, aber nicht explizit auf Speichern klicken, wird dieser Zustand als Abfrageentwurf beibehalten. Abfrageentwürfe werden 30 Tage lang aufbewahrt. Nach 30 Tagen werden Abfrageentwürfe automatisch gelöscht. Um Ihre Änderungen beizubehalten, müssen Sie sie explizit speichern.

Bearbeiten mehrerer Abfragen

Standardmäßig verwendet der SQL-Editor Registerkarten, damit Sie mehrere Abfragen gleichzeitig bearbeiten können. Um eine neue Registerkarte zu öffnen, klicken Sie auf +, und wählen Sie dann Neue Abfrage erstellen oder Vorhandene Abfrage öffnen aus. Klicken Sie auf „Vorhandene Abfrage öffnen, um die Liste der gespeicherten Abfragen anzuzeigen. Klicken Sie auf Eigene Abfragen oder Favoriten, um die Liste der Abfragen zu filtern. Klicken Sie in der Zeile mit der Abfrage, die Sie anzeigen möchten, auf die Schaltfläche Öffnen.

Ausführen einer einzelnen oder mehrerer Abfragen

So führen Sie eine Abfrage oder alle Abfragen aus:

1. Wählen Sie ein SQL-Warehouse aus.

2. Markieren Sie eine Abfrage im SQL-Editor (wenn der Abfragebereich mehrere Abfragen enthält).

3. Drücken Sie Strg/Cmd + Eingabetaste, oder klicken Sie auf Ausführen (1000), um die Ergebnisse als Tabelle im Ergebnisbereich anzuzeigen.

   

Hinweis

Standardmäßig ist für alle Abfragen Limit 1.000 ausgewählt, wodurch Abfragen auf 1.000 Zeilen beschränkt werden. Wenn eine Abfrage mit der Einstellung Limit 1.000 gespeichert wird, gilt diese Einstellung für alle Abfrageausführungen (auch in Dashboards). Wenn für diese Abfrage alle Zeilen zurückgegeben werden sollen, können Sie die Auswahl von Limit 1000 aufheben, indem Sie die Dropdownliste Ausführen (1.000) auswählen. Wenn Sie einen anderen Grenzwert für die Anzahl von Zeilen angeben möchten, können Sie Ihrer Abfrage eine LIMIT-Klausel mit einem Wert Ihrer Wahl hinzufügen.

Beenden einer Abfrage

Um eine Abfrage während der Ausführung zu beenden, klicken Sie auf Abbrechen. Administrator*innen können ausgeführte Abfragen beenden, die von anderen Benutzer*innen gestartet wurden. Weitere Informationen dazu finden Sie unter Beenden einer ausgeführten Abfrage.

Abfrageoptionen

Sie können das Kebab-Kontextmenü () am oberen Rand des Abfrage-Editors verwenden, um auf Menüoptionen zuzugreifen, mit denen Sie Abfrageinformationen klonen, wiederherstellen, formatieren und bearbeiten können.

Wiederherstellen einer gespeicherten Abfrage

Wenn Sie eine Abfrage bearbeiten, wird im Kontextmenü für die Abfrage die Option Änderungen zurücksetzen angezeigt. Sie können auf Wiederherstellen klicken, um zu Ihrer gespeicherten Version zurückzukehren.

Verwerfen und Wiederherstellen von Abfragen

So verschieben Sie eine Abfrage in den Papierkorb:

• Wählen Sie neben der Abfrage im SQL-Editor das Kebab-Kontextmenü () und dann In Papierkorb verschieben aus.
• Klicken Sie zur Bestätigung auf In den Papierkorb verschieben.

So stellen Sie eine Abfrage aus dem Papierkorb wieder her:

1. Klicken Sie in der Liste „Alle Abfragen“ auf das -Symbol.
2. Klicken Sie auf eine Abfrage.
3. Klicken Sie zunächst auf das Kebab-Kontextmenü in Form der oben rechts im SQL-Editor und dann auf Wiederherstellen.

Festlegen der Abfragebeschreibung und Anzeigen von Abfrageinformationen

So legen Sie eine Abfragebeschreibung fest

1. Wählen Sie zunächst das Kebab-Kontextmenü () neben der Abfrage und dann Abfrageinformationen bearbeiten aus.

   

2. Geben Sie im Textfeld Beschreibung eine Beschreibung ein. Klicken Sie dann auf Speichern. Sie können in diesem Dialogfeld auch den Verlauf der Abfrage anzeigen, einschließlich ihrer Erstellung und Aktualisierung.

Markieren von Abfragen als Favoriten und mit Tags

Sie können Favoriten und Tags verwenden, um die Listen von Abfragen und Dashboards zu filtern, die auf der Startseite Ihres Arbeitsbereichs und auf jeder der Eintragsseiten für Dashboards und Abfragen angezeigt werden.

Favoriten: Um eine Abfrage als Favorit zu markieren, wählen Sie den Stern links neben dem Titel in der Abfrageliste aus. Der Stern wird gelb.

Tags: Sie können Abfragen und Dashboards mit einer beliebigen Zeichenfolge markieren (taggen), die für Ihre Organisation von Bedeutung ist.

Tag hinzufügen

Sie fügen Tags im Abfrage-Editor hinzu.

1. Wählen Sie zunächst das Kebab-Kontextmenü () neben der Abfrage und dann Abfrageinformationen bearbeiten aus. Es wird das Dialogfeld Abfrageinformationen angezeigt.

2. Wenn auf die Abfrage keine Tags angewandt wurden, wird unter Add some Tags (Tags hinzufügen) im Textfeld angezeigt, wo die Tags angezeigt werden. Um ein neues Tag zu erstellen, geben Sie es in das Feld ein. Um mehrere Tags einzugeben, drücken Sie zwischen den Einträgen die TAB-TASTE.

   

3. Wählen Sie Speichern aus, um die Tags anzuwenden und das Dialogfeld zu schließen.

Entfernen von Tags

1. Wählen Sie zunächst das Kebab-Kontextmenü () neben der Abfrage und dann Abfrageinformationen bearbeiten aus.
2. Wählen Sie für Tags, die Sie entfernen möchten, das X aus.
3. Wählen Sie Speichern aus, um das Dialogfeld zu schließen.

Anzeigen von Abfrageergebnissen

Nachdem eine Abfrage ausgeführt wurde, werden die Ergebnisse im darunter liegenden Bereich angezeigt. Neue Ergebnistabelle ist für neue Abfragen EIN. Wählen Sie bei Bedarf die Dropdownliste aus, um die Einstellung zu deaktivieren. In den Bildern in diesem Abschnitt wird die Einstellung „Neue Ergebnistabelle“ verwendet.

Mithilfe des Ergebnisbereichs können Sie mit Ihren Abfrageergebnissen interagieren und diese untersuchen. Der Ergebnisbereich enthält die folgenden Features zum Untersuchen der Ergebnisse:

Visualisierungen, Filter und Parameter

Wählen Sie aus, um eine Visualisierung, einen Filter oder einen Parameter hinzuzufügen. Die folgenden Optionen erscheinen:

Visualisierung: Visualisierungen können helfen, das Resultset zu untersuchen. Eine vollständige Liste der verfügbaren Visualisierungstypen finden Sie unter Visualisierungstypen.

Filter: Mithilfe von Filtern können Sie das Resultset einschränken, nachdem eine Abfrage ausgeführt wurde. Sie können Filter anwenden, um selektiv verschiedene Teilmengen der Daten anzuzeigen. Informationen zum Verwenden von Filtern finden Sie unter Abfragefilter.

Parameter: Mit Parametern können Sie das Resultset eingrenzen, indem Sie zur Laufzeit Werte in einer Abfrage ersetzen. Informationen zum Anwenden von Parametern finden Sie unter Arbeiten mit Abfrageparametern.

Bearbeiten und Herunterladen eines Dashboards sowie Hinzufügen von Elementen zu diesem

Wichtig

• Databricks empfiehlt die Verwendung von KI/BI-Dashboards (ehemals Lakeview-Dashboards).
• Ursprüngliche Databricks-SQL-Dashboards werden jetzt als Legacy-Dashboards bezeichnet. Sie erhalten weiterhin wichtige Programmfehlerbehebungen, aber sie werden nicht mit neuen Features aktualisiert. Legacy-Dashboards werden voraussichtlich bis Ende 2025 ausgedient haben. Databricks rät davon ab, neue Legacy-Dashboards zu erstellen.
  • Konvertieren Sie Legacy-Dashboards mithilfe des Migrationstools oder der REST-API. Anweisungen zur Verwendung des integrierten Migrationstools finden Sie unter Klonen eines Legacy-Dashboards in einem KI/BI-Dashboard. Tutorials zum Erstellen und Verwalten von Dashboards mithilfe der REST-API finden Sie unter Verwenden von Azure Databricks-APIs zum Verwalten von Dashboards.

Klicken Sie auf der Registerkarte „Ergebnisse“ auf , um weitere Optionen anzuzeigen.

1. Klicken Sie auf Bearbeiten, um die in der Visualisierung angezeigten Ergebnisse anzupassen.
2. Klicken Sie auf Löschen, um die Registerkarte „Ergebnisse“ zu löschen.
3. Klicken Sie auf Duplizieren, um die Registerkarte „Ergebnisse“ zu klonen.
4. Klicken Sie auf Zum Dashboard hinzufügen, um die Abfrage und die Visualisierung in ein neues Dashboard zu kopieren.
   • Diese Aktion erstellt ein neues Dashboard, das alle der Abfrage zugeordneten Visualisierungen enthält. Lesen Sie Dashboards, um zu erfahren, wie Sie Ihr Dashboard bearbeiten.
   • Sie werden aufgefordert, einen Namen für das neue Dashboard auszuwählen. Das neue Dashboard wird in Ihrem Stammordner gespeichert.
   • Sie können einem vorhandenen Dashboard keine Ergebnisse hinzufügen.
5. Klicken Sie auf Zu Legacy-Dashboard hinzufügen, um die Registerkarte „Ergebnisse“ einem neuen oder vorhandenen Legacy-Dashboard hinzuzufügen.
6. Klicken Sie auf eine der Downloadoptionen, um Ergebnisse herunterzuladen. Details und Grenzwerte finden Sie in der folgenden Beschreibung.

Ergebnisse herunterladen: Sie können die Ergebnisse als CSV-, TSV- oder Excel-Datei herunterladen.

Sie können bis zu ca. 1 GB an Ergebnisdaten aus Databricks SQL im CSV- und TSV-Format und bis zu 100.000 Zeilen in einer Excel-Datei herunterladen.

Die endgültige Dateidownloadgröße kann etwas mehr oder weniger als 1 GB betragen, da der Grenzwert von 1 GB in einem früheren Schritt im Prozess angewandt wird als der endgültige Dateidownload.

Hinweis

Wenn Sie eine Abfrage nicht herunterladen können, wurde das Herunterladen für Ihren Arbeitsbereich möglicherweise durch die Arbeitsbereichsadministrator*innen deaktiviert.

Vergangene Ausführungen

Sie können vorherige Ausführungen der Abfrage anzeigen, einschließlich der vollständigen Abfragesyntax. Frühere Ausführungen werden im schreibgeschützten Modus geöffnet und enthalten Schaltflächen zum Klonen in eine neue Abfrage und zum Fortsetzen der Bearbeitung. Auf dieser Registerkarte werden keine geplanten Ausführungen angezeigt.

Ergebnisse erkunden

Die zurückgegebenen Abfrageergebnisse werden unterhalb der Abfrage angezeigt. Die Registerkarte Rohergebnisse wird mit den zurückgegebenen Zeilen aufgefüllt. Sie können integrierte Filter verwenden, um die Ergebnisse nach auf- oder absteigenden Werte neu zu sortieren. Sie können Filter auch verwenden, um nach Ergebniszeilen zu suchen, die einen bestimmten Wert enthalten.

Sie können Registerkarten im Ergebnisbereich verwenden, um Visualisierungen, Filter und Parameter hinzuzufügen.

Filtern der Liste der gespeicherten Abfragen im Abfragefenster

In den Abfragefenstern können Sie die Abfrageliste nach der Liste der von Ihnen erstellten Abfragen (Eigene Abfragen), nach Favoriten und nach Tags filtern.

Automatisieren von Updates

Mit der Schaltfläche Zeitplan können Sie einen automatischen Zeitplan für die Ausführung von Abfragen festlegen. Automatische Updates können Ihnen helfen, Ihre Dashboards und Berichte mit den aktuellsten Daten auf dem neuesten Stand zu halten. Geplante Abfragen können auch Databricks SQL-Warnungen aktivieren. Dieser spezielle Typ von geplanter Aufgabe sendet Benachrichtigungen, wenn ein Wert einen bestimmten Schwellenwert erreicht.

Siehe Planen einer Abfrage.

Siehe Was sind Databricks SQL-Warnungen?.

Freigeben von Abfragen

Mit der Schaltfläche Freigeben können Sie Ihre Abfrage für andere Benutzer*innen in Ihrem Arbeitsbereich freigeben. Für die Freigage stehen Ihnen die folgenden Optionen zur Verfügung:

• Run as owner (owner’s credentials) (Als Besitzer ausführen (Anmeldeinformationen des Besitzers/der Besitzer*in)): Diese Einstellung bedeutet, dass Betrachter*innen dieselben Abfrageergebnisse wie dem/der Abfragebesitzer*in angezeigt werden. Sie gilt für geplante oder manuelle Abfrageausführungen.
• Run as view (viewers credentials) (Als Sicht ausführen (Anmeldeinformationen für Viewer)): Diese Einstellung beschränkt die Ergebnisse auf die zugewiesenen Berechtigungen der Betrachter*innen.

Weitere Informationen finden Sie unter Konfigurieren von Abfrageberechtigungen.

Nächster Schritt

Unter Zugreifen auf und Verwalten von gespeicherten Abfragen erfahren Sie, wie Sie auf der Azure Databricks-Benutzeroberfläche mit Abfragen arbeiten.