Mit SQL Runner Abfragen und Entdeckungen erstellen

Mit SQL Runner können Sie direkt auf Ihre Datenbank zugreifen und diesen Zugriff auf verschiedene Weise nutzen. Mit SQL Runner können Sie die Tabellen in Ihrem Schema ganz einfach aufrufen, einen Ad-hoc-Test aus einer SQL-Abfrage ausführen, vorgefertigte beschreibende Abfragen für Ihre Daten ausführen, den SQL Runner-Verlauf ansehen, Ergebnisse herunterladen, Abfragen freigeben, 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-Erkundungen erstellen und mit SQL Runner Abfragen debuggen. Auf den folgenden Seiten 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 komplett neu erstellen, eine Abfrage mit „Erkunden“ erstellen 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.

SQL-Abfrage neu erstellen

Mit dem SQL Runner können Sie eigene SQL-Abfragen schreiben und für die Datenbank ausführen. Looker übergibt Ihre Abfrage so an Ihre Datenbank, wie Sie sie geschrieben haben. Achten Sie daher darauf, dass die Syntax Ihrer SQL-Abfrage für Ihren Datenbankdialekt gültig ist. Beispielsweise hat jeder Dialekt leicht unterschiedliche SQL-Funktionen mit bestimmten Parametern, die an die Funktion übergeben werden sollen.

  1. Klicken Sie in den SQL-Abfragebereich und geben Sie den SQL-Befehl ein.
  2. Optional: Doppelklicken Sie auf einen Tabellennamen oder ein Feld aus der Feldliste, um den Cursor bzw. die Tabelle in die Abfrage an der Cursorposition aufzunehmen.
  3. Klicken Sie auf Ausführen, um die Abfrage für Ihre Datenbank auszuführen.
  4. Sehen Sie sich die Ergebnisse im Bereich „Ergebnisse“ an. Der SQL-Runner lädt bis zu 5.000 Zeilen der Abfrageergebnisse. Bei SQL-Dialekten, die Streaming unterstützen, können Sie die Ergebnisse herunterladen, um sich die gesamte Ergebnismenge anzusehen.

Bei einigen SQL-Programmen können Sie mehrere Abfragen hintereinander ausführen. Sie können jedoch im SQL Runner nur jeweils eine Abfrage gleichzeitig ausführen. SQL Runners ist außerdem auf 65.535 Zeichen für Abfragen beschränkt, einschließlich Leerzeichen.

Wenn Ihnen eine Abfrage gefällt, können Sie sie einem Projekt hinzufügen, die LookML für eine abgeleitete Tabelle abrufen oder die Abfrage freigeben.

Sie können auch den SQL Runner verwenden, um mit neuen Abfragen zu spielen oder vorhandene Abfragen zu testen. Mit der Funktion Fehlerhervorhebung in SQL Runner können Sie Abfragen testen und Fehler beheben.

Mit der Funktion „Erkunden“ eine SQL-Abfrage erstellen

Sie können auch mit „Erkunden“ eine Abfrage erstellen und dann den SQL-Befehl für die Abfrage in SQL Runner abrufen:

  1. Klicken Sie in der Ansicht Erkunden auf den Tab SQL.
  2. Wählen Sie den Text der SQL-Abfrage aus und kopieren Sie ihn in SQL Runner.
  3. Klicken Sie auf Open in SQL Runner oder Explain in SQL Runner, um die Abfrage im SQL Runner zu öffnen.

Nachdem Sie dem SQL-Abfragebereich des SQL Runners eine Abfrage hinzugefügt haben, können Sie auf Ausführen klicken, 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, der Ergebnisbereich in der Mitte und der Abfragebereich unten.

  1. Nachdem eine SQL-Abfrage erstellt und ausgeführt wurde, können Sie auf dem Tab Visualisierung die Visualisierung aufrufen und einen Visualisierungstyp auswählen, wie Sie das auch auf der Seite „Erkunden“ tun würden.
  2. Sie können die Visualisierung über das Menü Einstellungen bearbeiten.
  3. Sie können Visualisierungen, die mit SQL Runner erstellt wurden, freigeben, indem Sie die URL teilen. Alle Anpassungen, die Sie über das Menü Einstellungen der Visualisierung vornehmen, werden gespeichert und der Link ändert sich nicht.

Bei der Verwendung von SQL Runner-Visualisierungen ist Folgendes zu beachten:

  • In der Ergebnistabelle und Visualisierung werden alle numerischen Felder als Maßeinheit interpretiert.
  • Der vollständige Feldname wird in der Ergebnistabelle und in der Visualisierung immer verwendet. Daher ist die Option Vollständigen Feldnamen anzeigen im Menü Einstellungen inaktiv.
  • Wenn Sie benutzerdefinierte Felder, Tabellenberechnungen, Pivot-Tabellen, Spaltensummen und Zwischensummen verwenden möchten, verwenden Sie die SQL-Runner-Abfrage.
  • Visualisierungen statischer Karten (Regionen) werden von SQL Runner-Visualisierungen nicht unterstützt. Karten, die Breiten- und Längengraddaten (Karten- und statische Kartendarstellungen) verwenden, werden jedoch unterstützt.
  • Visualisierungen von Zeitachsen werden von SQL Runner-Visualisierungen nicht unterstützt.

Dimensionen als Drehpunkt festlegen

Sie können die Abfrageergebnisse so bearbeiten, dass sie in SQL Runner-Visualisierungen um eine oder mehrere Dimensionen pivotiert werden. So schwenken Sie ein Feld:

  1. Klicken Sie im Bereich Ergebnisse auf das Zahnradsymbol einer Spalte, um die Spaltenoptionen einzublenden.
  2. Klicken Sie auf Pivot-Spalte.

Die Ergebnisse mit Pivoting werden in der SQL-Runner-Visualisierung angezeigt:

Die Ergebnisse im Bereich Results (Ergebnisse) werden nicht als Pivot angezeigt.

Wenn Sie die Bearbeitung der Pivoting-Funktion aufheben möchten, klicken Sie auf das Zahnradsymbol und wählen Sie Spalte entfernen aus:

Feldtyp ändern

Wenn Sie die Ergebnisse und Visualisierung Ihrer Abfrage anzeigen lassen, interpretiert SQL Runner jedes numerische Feld automatisch als Maßeinheit und jedes nicht numerische Feld als Dimension. So können Sie den standardmäßigen Feldtyp überschreiben und eine Dimension in ein Maß umwandeln (oder umgekehrt):

  1. Klicken Sie im Bereich Ergebnisse auf das Zahnradsymbol einer Spalte, um die Spaltenoptionen einzublenden.
  2. Klicken Sie auf In Dimension konvertieren oder In Maßeinheit konvertieren, 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, und nicht direkt für Ihre Datenbank. Beim Erstellen Ihrer Abfrage für ein Modell können Sie LookML-Ersetzungsoperatoren wie ${view_name.field_name} oder ${view_name.SQL_TABLE_NAME} verwenden. So können Sie beim Erstellen einer Abfrage Zeit sparen, um beispielsweise Fehler in einer abgeleiteten Tabelle zu beheben.

Looker löst alle LookML-Ersetzungen auf und übergibt Ihre Abfrage dann an die Datenbank. Die Abfrage muss also in einem gültigen SQL für Ihren Datenbankdialekt stehen. Beispielsweise hat jeder Dialekt leicht unterschiedliche SQL-Funktionen mit bestimmten Parametern, die an die Funktion übergeben werden sollen.

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

  1. Klicken Sie auf den Tab Modell.
  2. Wählen Sie das Modell aus, das Sie abfragen möchten.
  3. Klicken Sie in den SQL-Abfragebereich und geben Sie die SQL-Abfrage mit LookML-Feldern ein.
  4. Optional: Doppelklicken Sie auf eine Ansicht in der Ansichtsliste, um die Ansicht in der Abfrage an der Cursorposition aufzunehmen.
  5. Wenn Sie die Liste der Felder in einer Ansicht aufrufen möchten, klicken Sie im Bereich Ansichten auf die Ansicht. Sie können auch doppelt auf ein Feld in der Feldliste klicken, um es Ihrer Abfrage an der Cursorposition hinzuzufügen.
  6. Im Bereich Vorbereitete SQL-Abfrage sehen Sie die resultierende SQL-Abfrage, die erstellt wurde, nachdem LookML-Ersetzungen in SQL übersetzt wurden.
  7. Klicken Sie auf Ausführen, um die Abfrage für Ihr Modell auszuführen.
  8. Sehen Sie sich die Ergebnisse im Bereich Ergebnisse an. Der SQL-Runner lädt bis zu 5.000 Zeilen der Abfrageergebnisse. Bei SQL-Dialekten, die Streaming unterstützen, können Sie die Ergebnisse herunterladen, um sich die gesamte Ergebnismenge anzusehen.

Wenn Ihnen eine Abfrage gefällt, können Sie sie einem Projekt hinzufügen, die LookML für eine abgeleitete Tabelle abrufen oder die Abfrage freigeben.

Sie können auch den SQL Runner verwenden, um mit neuen Abfragen zu spielen, vorhandene Abfragen zu testen oder eine neue Erkundung aus den Ergebnissen zu öffnen. Mit der Funktion Fehlerhervorhebung in SQL Runner können Sie Abfragen testen und Fehler beheben.

LookML eines Felds vom SQL-Runner ansehen

In der Feldliste auf dem Tab Modell sehen Sie auch die LookML für ein Feld. Bewegen Sie den Mauszeiger auf das Feld in der Feldliste und klicken Sie rechts neben dem Feldnamen auf das Looker-Symbol:

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

Verlauf des SQL-Ausführers

Sie können auch einen aktuellen Verlauf aller Abfragen anzeigen lassen, die Sie in SQL Runner ausgeführt haben.

Klicken Sie oben im Navigationsbereich auf den Tab Verlauf, um Ihren Verlauf aufzurufen. Der SQL-Runner zeigt alle Abfragen an, die auf der Datenbankverbindung ausgeführt wurden. Rot steht für eine Abfrage, die aufgrund eines Fehlers nicht ausgeführt wurde.

Klicken Sie auf eine Abfrage im Verlauf, um sie in SQL Runner einzufügen, und klicken Sie dann auf Ausführen, um die Abfrage noch einmal auszuführen:

Abfrage sortieren

Die Sortierreihenfolge einer Tabelle ist neben dem sortierten Feldnamen durch einen Pfeil nach oben oder unten gekennzeichnet, je nachdem, ob die Ergebnisse in aufsteigender oder absteigender Reihenfolge angeordnet sind. Sie können nach mehreren Spalten sortieren, indem Sie die Umschalttaste gedrückt halten und dann auf die Spaltenüberschriften in der gewünschten Reihenfolge klicken. Die Sortierreihenfolge eines Felds ist auch durch eine Zahl angegeben, die die Sortierreihenfolge im Vergleich zu anderen Feldern unterscheidet, durch einen Pfeil neben dem Feldnamen, der die Sortierrichtung (aufsteigend oder absteigend) angibt, und durch ein Pop-up-Fenster, das eingeblendet wird, wenn Sie den Mauszeiger auf einen Feldnamen bewegen.

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

Abfragen freigeben

Sie können eine Abfrage in SQL Runner mit einem anderen Nutzer mit SQL Runner-Zugriff teilen. Um eine Abfrage freizugeben, kopieren Sie einfach die URL in die URL-Leiste:

Ergebnisse werden heruntergeladen

Nachdem Sie die 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. Klicken Sie im Zahnradmenü oben rechts auf Herunterladen.
  3. Wählen Sie das Dateiformat für den Download aus (Textdatei, CSV, JSON usw.).

  4. Klicken Sie auf Im Browser öffnen, um die Ergebnisse in einem neuen Browserfenster zu sehen, oder klicken Sie auf Herunterladen, um die Ergebnisse in eine Datei auf Ihrem Computer herunterzuladen.

    Wenn Sie auf Im Browser öffnen oder Herunterladen klicken, wird die Abfrage von Looker noch einmal ausgeführt und dann wird der Download durchgeführt.

Bei SQL-Dialekten, die Streaming unterstützen, wird mit der Option Herunterladen der gesamte Ergebnissatz heruntergeladen. Bei SQL-Dialekten, die das Streaming nicht unterstützen, werden mit der Option Herunterladen nur die Zeilen der Abfrage heruntergeladen, die im Abschnitt Ergebnisse angezeigt werden (bis zu 5.000 Zeilen).

Spaltenwerte kopieren

Sie können Spaltenwerte aus dem Abschnitt Results (Ergebnisse) in SQL Runner kopieren. Klicken Sie auf das Zahnrad in einer Spalte, um die Werte in die Zwischenablage zu kopieren. Von dort können Sie die Spaltenwerte in eine Textdatei, ein Excel-Dokument oder an einem anderen Speicherort einfügen.

Wenn Ihr Looker-Administrator die Labs-Funktion SQL Runner Vis aktiviert hat, haben Sie auch andere Optionen im Spalten-Zahnradmenü:

Sie können Spalten in der Ergebnistabelle auch manuell verschieben, anpinnen oder ihre Größe ändern.

Kostenschätzungen für SQL Runner-Abfragen

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

Für BigQuery-, MySQL- und Amazon RDS für MySQL-Verbindungen sind Kostenschätzungen immer aktiviert. Für die 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 beim Erstellen der Verbindung aktivieren. Vorhandene Verbindungen können Sie auf der Seite Verbindungen im Abschnitt Datenbank des Steuerfelds Admin von Looker bearbeiten.

Ad-hoc-Analyse erstellen

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

Es gibt zwei Möglichkeiten, einen Ad-hoc-Test von SQL Runner zu öffnen:

  • Aus den Abfrageergebnissen des SQL-Runners auswerten
  • Aus der Tabellenliste von SQL Runner ansehen

Über SQL Runner-Abfrageergebnisse auswerten

Mit dem SQL-Runner können Sie eine explorative Datenanalyse aus einer SQL-Abfrage öffnen. Dadurch wird eine temporäre Erkundung aus der Abfrage erstellt, die in SQL Runner geschrieben ist. So können Sie testen, was von der Abfrage zurückgegeben wird, und die Ergebnisse visualisieren. Dies kann für jede Abfrage 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 dem SQL Runner die SQL-Abfrage, die Sie verwenden möchten.
  2. Klicken Sie im Zahnradmenü oben rechts auf Erkunden. Sie werden zu einer neuen Erkundung weitergeleitet, in der Sie die SQL-Abfrage so erforschen können, als wäre sie eine gespeicherte Tabelle in Ihrem Modell.
  3. Du kannst die URL kopieren, um sie mit anderen zu teilen.
  4. Klicken Sie auf Ansicht zum Projekt hinzufügen, um diese Abfrage direkt von hier aus als abgeleitete Tabelle in Ihrem Projekt hinzuzufügen.

Benutzerdefinierte Felder beim Erkunden 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. Klicken Sie wie im vorherigen Abschnitt beschrieben im Zahnradmenü auf Erkunden. Gehen Sie dann in der Feldauswahl so vor:

In SQL Runner aufgeführte Tabelle ansehen

Mit der Option Tabelle auswerten auf dem Tab Datenbank können Sie eine Ad-hoc-Analyse für jede Tabelle in der Verbindung erstellen. So können Sie Looker auf einer Tabelle verwenden, bevor Sie sie modelliert und die Tabelle genau wie eine LookML-Ansicht erkundet haben.

Wenn Sie die Funktion „Erkunden“ für die Tabelle öffnen, können Sie entscheiden, ob Sie sie Ihrem Projekt hinzufügen möchten. Sie können auch den Tab SQL auf dem Tab „Erkunden“ verwenden, um die SQL-Abfragen zu sehen, die Looker an die Datenbank sendet, und dann die Schaltfläche In SQL-Runner öffnen verwenden, um die Abfrage wieder in SQL Runner zu importieren.

  1. Klicken Sie auf den Tab Datenbank.
  2. Klicken Sie in SQL Runner auf das Zahnradsymbol für eine Tabelle und wählen Sie Tabelle auswerten aus.
  3. Looker generiert ein temporäres Modell mit einer Ansicht für die Tabelle und zeigt dann den Bericht „Erkunden“ an.
  4. Looker bietet für jede Spalte in der Tabelle ein Dimensionsfeld. Das ist die gleiche Methode, mit der Looker zu Beginn eines Projekts ein Modell generiert.
  5. Looker berücksichtigt automatisch Zeiträume für Datumsfelder.
  6. Looker enthält auch eine Zählung.

Wenn Sie die Option Tabelle erkunden verwenden, ist der LookML-Datei keine LookML-Datei zugeordnet. Sie ist nur eine Ad-hoc-Ansicht der Tabelle.

Fehlerbehebung mit SQL Runner

Der SQL-Runner ist auch ein nützliches Tool, um SQL-Fehler in Abfragen zu prüfen.

SQL Runner-Fehler markieren

Der SQL-Runner markiert den Fehlerort im SQL-Befehl und fügt die Fehlerposition in die Fehlermeldung ein:

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

Der SQL-Runner markiert außerdem die Stelle des ersten Syntaxfehlers im SQL-Befehl, indem er ihn rot unterstrichen und die Zeile mit einem „x"“ unterstrichen. Bewegen Sie den Mauszeiger auf „x"“, um weitere Informationen zum Fehler zu sehen. Klicken Sie nach der Behebung des Problems auf Ausführen, um zu sehen, ob die Abfrage weitere Fehler enthält.

Mit dem SQL-Runner Fehler in der Funktion „Erkunden“ prüfen

Wenn Sie in einem explorativen Analysetool SQL-Syntaxfehler entdecken, können Sie mit dem SQL Runner die Fehlerstelle und die Art des Fehlers ermitteln, z. B. Rechtschreibfehler oder fehlende Befehle.

  1. Klicken Sie auf dem Tab „Erkunden“ in der Datenleiste auf den Tab SQL.
  2. Klicken Sie auf In SQL Runner öffnen, um die Abfrage im SQL Runner zu öffnen.

Dadurch wird der von SQL generierte SQL-Code in den SQL-Runner kopiert. Wie oben gezeigt, hebt der SQL Runner den Fehlerort im SQL-Befehl hervor und fügt die Fehlerposition in die Fehlermeldung ein. Sie können dann Änderungen vornehmen und die Abfrage im SQL-Runner noch einmal ausführen, bis die Fehler behoben sind.

Mit SQL Runner Fehler in abgeleiteten Tabellen prüfen

Informationen zum Verwenden von SQL Runner zum Prüfen von SQL-Fehlern in abgeleiteten Tabellen finden Sie im Artikel Looker Community mit SQL Runner zum Testen abgeleiteter Tabellen verwenden.