SQL-Runner zum Erstellen von Abfragen und Explores verwenden

SQL Runner bietet eine Möglichkeit, direkt auf Ihre Datenbank zuzugreifen und diesen Zugriff auf verschiedene Arten zu nutzen. Mit SQL Runner können Sie problemlos durch die Tabellen in Ihrem Schema navigieren, ein Ad-hoc-Explore aus einer SQL-Abfrage verwenden, vorgefertigte beschreibende Abfragen für Ihre Daten ausführen, Ihren SQL Runner-Verlauf anzeigen, Ergebnisse herunterladen, Abfragen freigeben, ein LookML-Projekt als abgeleitete Tabelle hinzufügen und andere nützliche Aufgaben ausführen.

Auf dieser Seite wird beschrieben, wie Sie Abfragen in SQL Runner ausführen, Ad-hoc-Explores erstellen und SQL Runner zum Debuggen von Abfragen verwenden. Auf diesen Dokumentationsseiten finden Sie Informationen zu folgenden Themen:

Abfragen in SQL-Runner ausführen

Wenn Sie eine Abfrage in Ihrer Datenbank ausführen möchten, können Sie die SQL-Abfrage von Grund auf neu schreiben, ein Explore zum Erstellen der Abfrage verwenden oder eine Abfrage für ein LookML-Modell ausführen. Sie können auch den Verlauf verwenden, um eine vorherige Abfrage noch einmal auszuführen.

Neue SQL-Abfrage schreiben

Mit SQL Runner können Sie eigene SQL-Abfragen für Ihre Datenbank schreiben und ausführen. Looker übergibt Ihre Abfrage so an Ihre Datenbank, wie Sie sie geschrieben haben. Stellen Sie daher sicher, dass die Syntax Ihrer SQL-Abfrage für Ihren Datenbankdialekt gültig ist. Jeder Dialekt hat beispielsweise geringfügig unterschiedliche SQL-Funktionen mit spezifischen Parametern, die an die Funktion übergeben werden sollten.

  1. Geben Sie in das Textfeld unter der Leiste Abfrage eine SQL-Abfrage ein.
  2. Sie können auch einen Tabellennamen oder ein Feld aus der Feldliste auswählen, um es an der Cursorposition in die Abfrage aufzunehmen.
  3. Wählen Sie Ausführen aus, um die Abfrage für Ihre Datenbank auszuführen.
  4. Sehen Sie sich die Ergebnisse im Bereich Ergebnisse an. SQL Runner lädt bis zu 5.000 Zeilen des Abfrageergebnissatzes. Bei SQL-Dialekten, die Streaming unterstützen, können Sie die Ergebnisse herunterladen, um sich den gesamten Ergebnissatz anzusehen.

In einigen SQL-Programmen können Sie mehrere Abfragen hintereinander ausführen. Sie können in SQL Runner jedoch jeweils nur eine Abfrage ausführen. SQL Runner hat außerdem eine Beschränkung von 65.535 Zeichen für Abfragen, einschließlich Leerzeichen.

Nachdem Sie eine Abfrage ausgeführt haben, können Sie die Abfrage einem Projekt hinzufügen, den LookML-Code für eine abgeleitete Tabelle abrufen oder die Abfrage freigeben.

Sie können SQL Runner auch verwenden, um mit neuen Abfragen zu experimentieren oder vorhandene Abfragen zu testen. Die Fehlerhervorhebung von SQL Runner unterstützt das Testen und Debuggen von Abfragen.

SQL-Abfrage mit einem Explore erstellen

Sie können auch ein Explore verwenden, um eine Abfrage zu erstellen, und dann den SQL-Befehl für diese Abfrage abrufen, der in SQL Runner verwendet werden soll:

  1. Wählen Sie in einem Explore den Tab SQL in der Leiste Daten aus.
  2. Die SQL-Abfrage wird unter der Leiste Daten angezeigt.
  3. Wählen Sie Open in SQL Runner oder Explain in SQL Runner aus, um die Abfrage in SQL Runner zu öffnen.

Sobald dem Textfeld unter der Leiste Abfrage eine Abfrage hinzugefügt wurde, können Sie Ausführen auswählen, um die Datenbank abzufragen. Alternativ können Sie die Abfrage bearbeiten und dann die neue Abfrage ausführen.

Visualisierungen mit SQL Runner erstellen

Wenn Ihr Looker-Administrator die Labs-Funktion SQL Runner Vis aktiviert hat, können Sie Visualisierungen direkt in SQL Runner erstellen.

Wenn SQL Runner Vis aktiviert ist, werden die SQL Runner-Felder neu angeordnet. Der Visualisierungsbereich wird oben angezeigt, der Ergebnisbereich in der Mitte und der Abfragebereich unten.

  1. Nachdem eine SQL-Abfrage erstellt und ausgeführt wurde, können Sie den Tab Visualisierung öffnen, um die Visualisierung aufzurufen und einen Visualisierungstyp auszuwählen, wie Sie es auf der Explore-Seite tun würden.
  2. Sie können die Visualisierung über das Menü Einstellungen bearbeiten.
  3. Sie können mit SQL Runner erstellte Visualisierungen freigeben, indem Sie die URL freigeben. Alle Anpassungen, die Sie über das Menü Einstellungen der Visualisierung vornehmen, werden gespeichert und die Verknüpfung bleibt unverändert.

Es gibt einige Dinge, die Sie bei der Funktionsweise von SQL Runner-Visualisierungen beachten sollten:

  • Die Ergebnistabelle und -visualisierung interpretieren jedes numerische Feld als Messwert.
  • In der Ergebnistabelle und -visualisierung wird immer der vollständige Feldname verwendet. Daher ist die Option Show Full Field Name (Vollständigen Feldnamen anzeigen) im Menü Settings (Einstellungen) inaktiv.
  • Wenn Sie benutzerdefinierte Felder, Tabellenkalkulationen, Pivots, Spaltensummen und Zwischensummen verwenden möchten, nutzen Sie Ihre SQL Runner-Abfrage.
  • Visualisierungen für statische Karten (Regionen) werden von SQL Runner-Visualisierungen nicht unterstützt. Karten, die Breiten- und Längengraddaten verwenden (Karten- und statische Kartenvisualisierungen (Punkte)), werden jedoch unterstützt.
  • Zeitachsenvisualisierungen werden von SQL Runner-Visualisierungen nicht unterstützt.

Dimensionen als Drehpunkt festlegen

Sie können die Abfrageergebnisse in SQL Runner-Visualisierungen so bearbeiten, dass sie nach einer oder mehreren Dimensionen pivotiert werden. So pivotieren Sie ein Feld:

  1. Klicken Sie im Bereich Ergebnisse auf das Zahnrad-Menü einer Spalte, um die Spaltenoptionen einzublenden.
  2. Wählen Sie Spalte pivotieren aus.

Die als Drehpunkt festgelegten Ergebnisse werden in der SQL Runner-Visualisierung angezeigt.

Die Ergebnisse im Bereich Ergebnisse werden nicht als pivotiert angezeigt.

Um das Drehen der Ergebnisse zu aufheben, klicken Sie auf das Zahnrad-Menü der pivotierten Spalte und wählen Sie Drehung der Spalte aufheben aus.

Feldtyp ändern

Bei der Anzeige der Ergebnisse und der Visualisierung Ihrer Abfrage interpretiert SQL Runner automatisch jedes numerische Feld als Messwert und jedes nicht numerische Feld als Dimension. Sie können den Standardfeldtyp überschreiben und eine Dimension in eine Kennzahl umwandeln oder umgekehrt. Gehen Sie dazu so vor:

  1. Klicken Sie im Bereich Ergebnisse auf das Zahnrad-Menü einer Spalte, um die Spaltenoptionen einzublenden.
  2. Wählen Sie In Dimension konvertieren oder In Messwert konvertieren aus, um den Feldtyp zu ändern.

In der Visualisierung wird der neue Feldtyp angezeigt.

Abfrage für ein LookML-Modell ausführen

Sie können SQL Runner verwenden, um SQL-Abfragen für ein LookML-Modell zu schreiben und auszuführen, anstatt direkt für Ihre Datenbank. Beim Erstellen der Abfrage für ein Modell können Sie LookML-Substitutionsoperatoren wie ${view_name.field_name} oder ${view_name.SQL_TABLE_NAME} verwenden. Dies kann beispielsweise beim Erstellen einer Abfrage zur Fehlerbehebung bei einer abgeleiteten Tabelle Zeit sparen.

Looker löst alle LookML-Substitutionen auf und übergibt Ihre Abfrage dann an Ihre Datenbank. Die Abfrage sollte daher in einem für Ihren Datenbankdialekt gültigen SQL-Code vorliegen. Jeder Dialekt hat beispielsweise geringfügig unterschiedliche SQL-Funktionen mit spezifischen Parametern, die an die Funktion übergeben werden sollten.

So führen Sie eine Abfrage für Ihr LookML-Modell in SQL Runner aus:

  1. Wählen Sie den Tab Modell aus.
  2. Wählen Sie das Modell aus, das Sie abfragen möchten.
  3. Geben Sie im Textfeld unter der Leiste Daten Ihre SQL-Abfrage mithilfe von LookML-Feldern ein.
  4. Wählen Sie optional eine Ansicht in der Ansichtsliste aus, um die Ansicht an der Cursorposition in Ihre Abfrage aufzunehmen.
  5. Um die Liste der Felder in einer Ansicht aufzurufen, wählen Sie die Ansicht im Bereich Ansichten aus. Optional können Sie ein Feld aus der Feldliste auswählen, um es an der Cursorposition in Ihre Abfrage aufzunehmen.
  6. Im Bereich Prepared SQL Query (Vorbereitete SQL-Abfrage) können Sie die resultierende SQL-Abfrage sehen, die erstellt wird, nachdem LookML-Substitutionen in SQL übersetzt wurden.
  7. Wählen Sie Ausführen aus, um die Abfrage für Ihr Modell auszuführen.
  8. Sehen Sie sich die Ergebnisse im Bereich Ergebnisse an. SQL Runner lädt bis zu 5.000 Zeilen des Abfrageergebnissatzes. Bei SQL-Dialekten, die Streaming unterstützen, können Sie die Ergebnisse herunterladen, um sich den gesamten Ergebnissatz anzusehen.

Sie können SQL Runner verwenden, um mit neuen Abfragen zu experimentieren, vorhandene Abfragen zu testen oder ein neues Explore aus den Ergebnissen zu öffnen. Die Fehlerhervorhebung von SQL Runner unterstützt das Testen und Debuggen von Abfragen.

Wenn Sie eine Abfrage haben, die Ihnen gefällt, können Sie die Abfrage freigeben und sogar die Abfrage einem LookML-Projekt hinzufügen.

LookML eines Felds in SQL Runner anzeigen

In der Feldliste auf dem Tab Model (Modell) können Sie auch den LookML-Code für ein Feld sehen. Bewegen Sie den Mauszeiger über das Feld in der Feldliste und wählen Sie das Looker-Symbol rechts neben dem Feldnamen aus.

Looker öffnet die LookML-IDE und lädt die Datei, in der das Feld definiert ist.

SQL Runner-Verlauf

Sie können auch den aktuellen Verlauf aller Abfragen einsehen, die Sie in SQL Runner ausgeführt haben.

Wählen Sie oben im Navigationsbereich den Tab Verlauf aus, um den Verlauf aufzurufen. SQL Runner zeigt alle Abfragen an, die für die Datenbankverbindung ausgeführt wurden. Rot zeigt eine Abfrage an, die aufgrund eines Fehlers nicht ausgeführt wurde.

Wählen Sie eine Abfrage im Verlauf aus, um diese in SQL Runner zu übertragen, und wählen Sie dann Ausführen aus, um die Abfrage noch einmal auszuführen.

Abfrage sortieren

Die Sortierreihenfolge einer Tabelle wird durch einen Aufwärts- oder Abwärtspfeil neben dem sortierten Feldnamen angegeben, je nachdem, ob die Ergebnisse in aufsteigender oder absteigender Reihenfolge sind. Sie können nach mehreren Spalten sortieren, indem Sie die Umschalttaste gedrückt halten und dann die Spaltenüberschriften in der Reihenfolge auswählen, in der sie sortiert werden sollen. Die Sortierreihenfolge eines Felds wird auch durch eine Zahl angegeben, die die Sortierreihenfolge im Vergleich zu anderen Feldern unterscheidet, durch einen Pfeil neben dem Feldnamen, der die Sortierrichtung anzeigt (aufsteigend oder absteigend), und durch ein Pop-up, das erscheint, wenn Sie den Mauszeiger auf einen Feldnamen bewegen.

Weitere Informationen und Beispiele finden Sie auf der Dokumentationsseite Daten in Looker untersuchen im Abschnitt Daten sortieren.

Abfragen freigeben

Sie können eine Abfrage in SQL Runner für einen anderen Nutzer freigeben, der Zugriff auf SQL Runner hat. Wenn Sie eine Abfrage teilen möchten, kopieren Sie die URL aus der Adressleiste Ihres Browsers.

Ergebnisse werden heruntergeladen

Nachdem Sie Ihre SQL-Abfrage ausgeführt haben, können Sie die Ergebnisse in verschiedenen Formaten herunterladen.

  1. Schreiben Sie eine Abfrage in das Feld SQL-Abfrage. (Sie müssen die Abfrage an diesem Punkt nicht in SQL Runner ausführen.)
  2. Wählen Sie oben rechts im Zahnradmenü Herunterladen aus.
  3. Wählen Sie das Dateiformat für den Download aus (Textdatei, CSV, JSON usw.).

  4. Wählen Sie Im Browser öffnen aus, um die Ergebnisse in einem neuen Browserfenster zu sehen, oder wählen Sie Herunterladen aus, um die Ergebnisse in einer Datei auf Ihrem Computer herunterzuladen.

    Wenn Sie entweder Im Browser öffnen oder Herunterladen auswählen, führt Looker die Abfrage noch einmal aus. Anschließend wird der Download ausgeführt.

Bei SQL-Dialekten, die Streaming unterstützen, lädt die SQL Runner-Option Download den gesamten Ergebnissatz herunter. Bei SQL-Dialekten, die Streaming nicht unterstützen, werden mit der SQL-Runner-Option Download nur die Zeilen der Abfrage heruntergeladen, die im Bereich Results (Ergebnisse) angezeigt werden (bis zu 5.000 Zeilen).

Spaltenwerte kopieren

Sie können Spaltenwerte aus dem Abschnitt Results in SQL Runner kopieren. Wählen Sie das Zahnrad-Menü einer Spalte aus, um die Werte in die Zwischenablage zu kopieren. Von dort aus können Sie die Spaltenwerte in eine Textdatei, eine Excel-Tabelle oder einen anderen Speicherort einfügen.

Wenn der Looker-Administrator die Labs-Funktion SQL Runner Vis aktiviert hat, stehen Ihnen im Zahnrad-Menü der Spalte auch andere Optionen zur Verfügung:

Sie können Spalten in der Ergebnistabelle auch manuell verschieben, anpinnen und resize.

Kostenschätzungen für SQL Runner-Abfragen

Bei Verbindungen mit BigQuery, MySQL, Amazon RDS for MySQL, Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL for PostgreSQL und Microsoft Azure PostgreSQL liefert SQL Runner eine Schätzung der Kosten der Abfrage. Nachdem Sie die SQL-Abfrage eingegeben haben, berechnet SQL Runner die für die Abfrage erforderliche Datenmenge und zeigt die Informationen in der Nähe der Schaltfläche Ausführen an.

Bei Verbindungen zu BigQuery, MySQL und Amazon RDS for MySQL sind Kostenschätzungen immer aktiviert. Für Datenbankverbindungen von Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL for PostgreSQL und Microsoft Azure PostgreSQL müssen Sie die Option Kostenschätzung für die Verbindung aktivieren. Sie können die Kostenschätzung aktivieren, wenn Sie die Verbindung erstellen. Bei vorhandenen Verbindungen können Sie die Verbindung bearbeiten. Rufen Sie dazu im Looker-Bereich Admin den Bereich Datenbank auf der Seite Verbindungen auf.

Ad-hoc-Explore erstellen

Mit SQL Runner erhalten Sie einen schnellen Einblick in die Daten, indem Sie ein Ad-hoc-Explore für eine SQL-Abfrage oder Datenbanktabelle erstellen. Mit dem Looker-Explore können Sie Felder auswählen, Filter hinzufügen, die Ergebnisse visualisieren und SQL-Abfragen erstellen.

Es gibt zwei Möglichkeiten, ein Ad-hoc-Explore in SQL Runner zu öffnen:

  • Aus den Abfrageergebnissen des SQL Runners untersuchen
  • Aus der Tabellenliste des SQL-Runners untersuchen

Aus SQL Runner-Abfrageergebnissen untersuchen

Mit SQL Runner können Sie ein Explore über eine SQL-Abfrage öffnen. Damit wird ein temporäres Explore aus der in SQL Runner geschriebenen Abfrage erstellt. So können Sie testen, was von der Abfrage zurückgegeben wird, und die Ergebnisse visualisieren. Dies kann für alle Abfragen verwendet werden, ist aber besonders nützlich, um Abfragen zu testen, die Sie für abgeleitete Tabellen verwenden möchten.

Wenn Ihr Looker-Administrator die Labs-Funktion SQL Runner Vis aktiviert hat, können Sie Visualisierungen direkt in SQL Runner erstellen.

  1. Verwenden Sie SQL Runner, um die SQL-Abfrage zu erstellen, die Sie verwenden möchten.
  2. Wählen Sie oben rechts im Zahnradmenü Entdecken aus. Dadurch gelangen Sie zu einem neuen Explore, in dem Sie die SQL-Abfrage untersuchen können, als wäre sie eine gespeicherte Tabelle in Ihrem Modell.
  3. Sie können die URL zum Teilen in dieses Explore kopieren.
  4. Wenn Sie diese Abfrage direkt von hier aus als abgeleitete Tabelle in Ihr Projekt einfügen möchten, wählen Sie Ansicht zum Projekt hinzufügen aus.

Benutzerdefinierte Felder beim Erkunden in SQL Runner erstellen

Wenn Sie Zugriff auf die Funktion für benutzerdefinierte Felder haben, können Sie benutzerdefinierte Felder verwenden, um nicht modellierte Felder in SQL Runner zu visualisieren. Wählen Sie, wie im vorherigen Abschnitt beschrieben, im Zahnradmenü die Option Expl. Datenanalyse aus. Führen Sie dann im Field Picker die folgenden Schritte aus:

In SQL Runner aufgeführte Tabelle untersuchen

Verwenden Sie die Option Tabelle untersuchen auf dem Tab Datenbank, um ein Ad-hoc-Explore für jede Tabelle in der Verbindung zu erstellen. Auf diese Weise können Sie Looker für eine Tabelle verwenden, bevor Sie sie modelliert haben, und die Tabelle genau wie bei einer LookML-Ansicht erkunden.

Nachdem Sie ein Explore für die Tabelle geöffnet haben, können Sie entscheiden, ob Sie die Tabelle Ihrem Projekt hinzufügen möchten. Sie können auch den Tab SQL des Explores verwenden, um sich die SQL-Abfragen anzusehen, die Looker an die Datenbank sendet, und dann die Schaltfläche In SQL-Runner öffnen verwenden, um die Abfrage wieder in SQL-Runner zu übertragen.

  1. Wählen Sie den Tab Datenbank aus.
  2. Wählen Sie in SQL Runner das Zahnrad für eine Tabelle und dann Tabelle untersuchen aus.
  3. Looker generiert ein temporäres Modell mit einer Ansicht für die Tabelle und zeigt dann das Explore an.
  4. Looker stellt für jede Spalte in der Tabelle ein Dimensionsfeld bereit. Das funktioniert genauso wie bei dem Generieren eines Modells zu Beginn eines Projekts.
  5. Looker fügt für alle Datumsfelder automatisch Zeiträume hinzu.
  6. Looker umfasst auch einen Zählwert für die Anzahl.

Wenn Sie die Option Explore Table verwenden, ist dem Explore keine LookML-Datei zugeordnet. Es handelt sich lediglich um eine Ad-hoc-Ansicht der Tabelle.

Fehlerbehebung mit SQL-Runner

SQL Runner ist auch ein nützliches Tool zum Prüfen von SQL-Fehlern in Abfragen.

SQL Runner-Fehlerhervorhebung

SQL Runner hebt die Fehlerposition im SQL-Befehl hervor und gibt die Position des Fehlers in der Fehlermeldung an:

Die angegebenen Positionsinformationen variieren je nach Datenbankdialekt. Beispielsweise gibt MySQL die Zeilennummer an, die den Fehler enthält, während Redshift die Zeichenposition des Fehlers angibt. Andere Datenbankdialekte können eines dieser oder andere Verhaltensweisen haben.

SQL Runner hebt außerdem die Stelle des ersten Syntaxfehlers im SQL-Befehl hervor, indem er rot unterstrichen und die Zeile mit einem x markiert wird. Bewegen Sie den Mauszeiger auf das x, um weitere Informationen zum Fehler zu sehen. Nachdem Sie das Problem behoben haben, wählen Sie Ausführen aus, um zu sehen, ob die Abfrage weitere Fehler enthält.

SQL-Runner zum Prüfen von Fehlern in Explores verwenden

Wenn in einem Explore SQL-Syntaxfehler auftreten, können Sie mithilfe von SQL Runner die Position des Fehlers und die Art des Fehlers wie Rechtschreibfehler oder fehlende Befehle ermitteln.

  1. Wählen Sie im Explore den SQL-Tab der Datenleiste aus.
  2. Wählen Sie Open in SQL Runner (In SQL-Runner öffnen) aus, um die Abfrage in SQL Runner zu öffnen.

Dadurch wird der vom Explore generierte SQL-Code in den SQL-Runner kopiert. Wie im Abschnitt SQL Runner-Fehlerhervorhebung gezeigt, hebt SQL Runner die Fehlerposition im SQL-Befehl hervor und gibt die Position des Fehlers in der Fehlermeldung an. Sie können dann Änderungen vornehmen und die Abfrage in SQL Runner noch einmal ausführen, bis Sie die Fehler behoben haben.

SQL-Runner zum Prüfen von Fehlern in abgeleiteten Tabellen verwenden

Informationen zur Verwendung von SQL Runner zum Prüfen von SQL-Fehlern in abgeleiteten Tabellen finden Sie im Looker-Communitybeitrag Mit SQL Runner abgeleitete Tabellen testen.