SQL Runner zum Erstellen von Abfragen und Explores verwenden

Mit SQL Runner können Sie direkt auf Ihre Datenbank zugreifen und diesen Zugriff auf verschiedene Arten nutzen. Mit SQL Runner können Sie ganz einfach 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, Daten zu einem 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 anderen Dokumentationsseiten finden Sie Informationen zu folgenden Themen:

Abfragen in SQL-Runner ausführen

Um eine Abfrage in Ihrer Datenbank auszuführen, 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 schreiben und in Ihrer Datenbank 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 bestimmten Parametern, die an die Funktion übergeben werden sollten.

  1. Geben Sie in das Textfeld unter der Leiste Abfrage eine SQL-Abfrage ein.
  2. Wählen Sie optional einen Tabellennamen oder ein Feld aus der Liste der Felder aus, um den Namen oder das Feld 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 Ergebnissatzes der Abfrage. Für SQL-Dialekte, die Streaming unterstützen, können Sie die Ergebnisse herunterladen, um den gesamten Ergebnissatz zu sehen.

Bei einigen SQL-Programmen können Sie mehrere Abfragen hintereinander ausführen. Sie können jedoch jeweils nur eine Abfrage in SQL Runner ausführen. SQL Runner hat außerdem eine Zeichenbeschrä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. Mit der Fehlerhervorhebung von SQL Runner können Sie Abfragen testen und debuggen.

Mit einem Explore eine SQL-Abfrage erstellen

Sie können auch mit einem Explore eine Abfrage erstellen und dann den SQL-Befehl für diese Abfrage abrufen, um ihn in SQL Runner zu verwenden:

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

Nachdem Sie dem Textfeld unter der Leiste Abfrage eine Abfrage hinzugefügt haben, 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-Steuerfelder 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, so wie Sie es auf der Seite „Explore“ 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 der Link ändert sich nicht.

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

  • In der Ergebnistabelle und -visualisierung wird jedes numerische Feld als Messwert interpretiert.
  • In der Ergebnistabelle und Visualisierung wird immer der vollständige Feldname verwendet. Daher ist die Option Vollständigen Feldnamen anzeigen im Menü Einstellungen inaktiv.
  • Wenn Sie benutzerdefinierte Felder, Tabellenkalkulationen, Pivots, Spaltengesamtsummen und Zwischensummen verwenden möchten, nutzen Sie Ihre SQL Runner-Abfrage.
  • Statische Kartenvisualisierungen (Regionen) werden von SQL Runner-Visualisierungen nicht unterstützt. Karten mit Breiten- und Längengraddaten (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. Wählen Sie im Bereich Ergebnisse das Zahnradmenü einer Spalte aus, um die Spaltenoptionen einzublenden.
  2. Wählen Sie Pivot-Spalte aus.

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

Die Ergebnisse im Bereich Ergebnisse werden nicht als Drehpunkt angezeigt.

Um Ergebnisse aufzulösen, wählen Sie das Zahnradmenü der pivotierten Spalte und dann Drehung der Spalte aufheben aus.

Feldtyp ändern

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

  1. Wählen Sie im Bereich Ergebnisse das Zahnradmenü einer Spalte aus, um die Spaltenoptionen einzublenden.
  2. Wählen Sie In Dimension konvertieren oder In Messung konvertieren aus, um den Feldtyp zu ändern.

In der Visualisierung wird der neue Feldtyp angezeigt.

Abfrage für ein LookML-Modell ausführen

Mit SQL Runner können Sie SQL-Abfragen für ein LookML-Modell anstatt direkt für Ihre Datenbank schreiben und ausführen. Wenn Sie die Abfrage für ein Modell erstellen, können Sie LookML-Substitutionsoperatoren verwenden, z. B. ${view_name.field_name} oder ${view_name.SQL_TABLE_NAME}. Dadurch können Sie Zeit sparen, wenn Sie eine Abfrage erstellen, um beispielsweise Fehler in einer abgeleiteten Tabelle zu beheben.

Looker löst alle LookML-Substitutionen auf und übergibt Ihre Abfrage dann an die Datenbank. Daher sollte die Abfrage in gültigem SQL für Ihren Datenbankdialekt vorliegen. Jeder Dialekt hat beispielsweise geringfügig unterschiedliche SQL-Funktionen mit bestimmten 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 aus der Ansichtsliste aus, um die Ansicht an der Cursorposition in Ihre Abfrage aufzunehmen.
  5. Wenn Sie die Liste der Felder in einer Ansicht aufrufen möchten, wählen Sie die entsprechende Ansicht im Abschnitt 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 Vorbereitete SQL-Abfrage können Sie sich die resultierende SQL-Abfrage ansehen, die nach der Übersetzung von LookML-Substitutionen in SQL erstellt wurde.
  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 Ergebnissatzes der Abfrage. Für SQL-Dialekte, die Streaming unterstützen, können Sie die Ergebnisse herunterladen, um den gesamten Ergebnissatz zu sehen.

Sie können SQL Runner verwenden, um mit neuen Abfragen zu experimentieren, vorhandene Abfragen zu testen oder einen neuen Explore aus den Ergebnissen zu öffnen. Mit der Fehlerhervorhebung von SQL Runner können Sie Abfragen testen und debuggen.

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 Liste der Felder auf dem Tab Modell können Sie auch den LookML-Code für ein Feld sehen. Bewegen Sie den Mauszeiger auf 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 anzeigen, die Sie in SQL Runner ausgeführt haben.

Wenn Sie sich Ihren Verlauf ansehen möchten, wählen Sie oben im Navigationsbereich den Tab Verlauf aus. SQL-Runner zeigt alle Abfragen an, die über die Datenbankverbindung ausgeführt wurden. Rot bedeutet, dass die Abfrage aufgrund eines Fehlers nicht ausgeführt wurde.

Wählen Sie eine Abfrage aus dem 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 Namen des sortierten Felds angegeben, je nachdem, ob die Ergebnisse in aufsteigender oder absteigender Reihenfolge angezeigt werden. Sie können nach mehreren Spalten sortieren, indem Sie die Umschalttaste gedrückt halten und die Spaltenüberschriften in der gewünschten Reihenfolge auswählen. Die Sortierreihenfolge eines Feldes wird auch durch eine Zahl angegeben, die seine Sortierreihenfolge von anderen Feldern unterscheidet, durch einen Pfeil neben dem Feldnamen, der die Sortierrichtung (auf- oder absteigend) angibt, und durch ein Pop-up, das angezeigt wird, wenn Sie den Mauszeiger auf einen Feldnamen bewegen.

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

Abfragen freigeben

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

Ergebnisse werden heruntergeladen

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

  1. Schreiben Sie eine Abfrage in das Feld SQL-Abfrage. (Sie müssen die Abfrage an dieser Stelle 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 öffnen, oder Herunterladen, um die Ergebnisse in eine Datei auf Ihrem Computer herunterzuladen.

    Wenn Sie entweder Im Browser öffnen oder Herunterladen auswählen, führt Looker die Abfrage noch einmal und dann den Download aus.

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

Spaltenwerte kopieren

Sie können Spaltenwerte aus dem Abschnitt Ergebnisse 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 Ihr Looker-Administrator die Labs-Funktion SQL Runner Vis aktiviert hat, stehen im Zahnradmenü 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. Sobald 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 Run (Ausführen) an.

Für Verbindungen zu BigQuery, MySQL und Amazon RDS für MySQL sind Kostenschätzungen immer aktiviert. Bei Snowflake-, Amazon Redshift-, Amazon Aurora-, PostgreSQL-, Cloud SQL for PostgreSQL- und Microsoft Azure-PostgreSQL-Datenbankverbindungen 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. Gehen Sie dazu im Bereich Admin von Looker zum Bereich Datenbank auf der Seite Verbindungen.

Ad-hoc-Explore erstellen

Mit SQL Runner erhalten Sie schnelle Einblicke 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 über SQL Runner zu öffnen:

  • Explore aus den Abfrageergebnissen von SQL Runner
  • Aus der Tabellenliste von SQL Runner analysieren

SQL Runner-Abfrageergebnisse durchsuchen

Mit SQL Runner können Sie ein Explore über eine SQL-Abfrage öffnen. Dadurch wird aus der in SQL Runner geschriebenen Abfrage ein temporäres Explore erstellt. Auf diese Weise 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 zum Testen von Abfragen, 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. Erstellen Sie mit SQL Runner die SQL-Abfrage, 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 wie eine gespeicherte Tabelle in Ihrem Modell untersuchen können.
  3. Sie können die URL zu diesem Explore kopieren und sie mit anderen teilen.
  4. Wenn Sie die 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 Explorieren in SQL Runner erstellen

Wenn Sie Zugriff auf die Funktion 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

Mit der Option Tabelle anzeigen im Tab Datenbank können Sie ein Ad-hoc-Explore für jede Tabelle in der Verbindung erstellen. Auf diese Weise können Sie Looker für eine Tabelle verwenden, bevor Sie sie modellieren, und die Tabelle wie eine 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 zu 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 ansehen 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 der Tabelle ein Dimensionsfeld zur Verfügung. Dies entspricht der Methode, mit der Looker ein Modell zu Beginn eines Projekts generiert.
  5. Looker fügt automatisch einen Zeitrahmen für alle Datumsfelder ein.
  6. Looker enthält auch ein Zählermesswert.

Wenn Sie die Option Tabelle untersuchen 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 außerdem ein nützliches Tool zum Überprüfen von SQL-Fehlern in Abfragen.

SQL Runner-Fehlermarkierung

SQL Runner hebt die Fehlerstelle im SQL-Befehl hervor und fügt die Position des Fehlers in die Fehlermeldung ein:

Die Positionsinformationen variieren je nach Datenbankdialekt. MySQL gibt beispielsweise die Zeilennummer mit dem Fehler an, während Redshift die Zeichenposition des Fehlers angibt. Andere Datenbankdialekte können eines dieser oder andere Verhaltensmuster haben.

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

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

Wenn Sie in einem Explore auf SQL-Syntaxfehler stoßen, können Sie mit SQL Runner den Ort des Fehlers und die Art des Fehlers ermitteln, z. B. Rechtschreibfehler oder fehlende Befehle.

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

Dadurch wird der generierte SQL-Code des Explores in den SQL-Runner kopiert. Wie oben gezeigt, hebt SQL-Runner die Fehlerstelle im SQL-Befehl und die Fehlerposition in die Fehlermeldung hervor. Anschließend können Sie Änderungen vornehmen und die Abfrage in SQL Runner so lange 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 Überprüfen von SQL-Fehlern in abgeleiteten Tabellen finden Sie im Looker-Communitybeitrag Mit SQL-Runner zum Testen abgeleiteter Tabellen.