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 ganz einfach zwischen den Tabellen in Ihrem Schema wechseln, eine Ad-hoc-Explore aus einer SQL-Abfrage verwenden, vordefinierte beschreibende Abfragen auf Ihre Daten ausführen, Ihren SQL Runner-Verlauf aufrufen, 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-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.

SQL-Abfrage von Grund auf neu 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 im Textfeld unter der Leiste Abfrage eine SQL-Abfrage ein.
  2. Optional können Sie einen Tabellennamen oder ein Feld aus der Feldliste auswählen, um es an der Position des Cursors 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 der Ergebnismenge der Abfrage. Bei SQL-Dialekten, die Streaming unterstützen, können Sie die Ergebnisse herunterladen, um die gesamte Ergebnismenge zu sehen.

In einigen SQL-Programmen können Sie mehrere Abfragen hintereinander ausführen. In SQL Runner kann jedoch immer nur eine Abfrage gleichzeitig ausgeführt werden. SQL Runner hat außerdem ein Limit von 65.535 Zeichen für Abfragen, einschließlich Leerzeichen.

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

Mit SQL Runner können Sie auch neue Abfragen ausprobieren oder vorhandene Abfragen 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, um ihn in SQL Runner zu verwenden:

  1. Wählen Sie in einem explorativen Datenanalysetool in der Leiste Daten den Tab SQL 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.

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 Bereiche des SQL Runners neu angeordnet. Der Visualisierungsbereich wird oben, der Ergebnisbereich in der Mitte und der Abfragebereich unten angezeigt.

  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, genau wie auf der Seite „Expl. Datenanalyse“.
  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.

Bei der Verwendung von SQL Runner-Visualisierungen sind einige Dinge zu beachten:

  • Die Ergebnistabelle und -visualisierung interpretieren jedes numerische Feld als Messwert.
  • In der Ergebnistabelle und in der 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, Pivot-Tabellen, Spaltensummen und Zwischensummen verwenden möchten, führen Sie ein Explore aus der SQL Runner-Abfrage aus.
  • Visualisierungen mit statischen Karten (Regionen) werden von SQL Runner-Visualisierungen nicht unterstützt. Karten, die Daten zu Breiten- und Längengraden verwenden (Karten- und Visualisierungen mit statischen Karten (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 erstellen Sie eine Pivot-Tabelle für 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 gepivotet.

Wenn Sie die Drehung der Ergebnisse aufheben möchten, klicken Sie auf das Zahnradmenü der pivotierten Spalte und wählen Sie 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 ein Messwert 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. Wenn Sie eine Abfrage für ein Modell erstellen, können Sie LookML-Ersetzungsoperatoren 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-Ersetzungen auf und gibt die Abfrage dann an die Datenbank weiter. Die Abfrage muss also in gültigem SQL für Ihren Datenbankdialekt 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. Optional können Sie eine Ansicht in der Ansichtsliste auswählen, um sie an der Cursorposition in die 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 auf Ihr Modell anzuwenden.
  8. Sehen Sie sich die Ergebnisse im Bereich Ergebnisse an. SQL Runner lädt bis zu 5.000 Zeilen der Ergebnismenge der Abfrage. 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 in SQL Runner hilft beim Testen und Beheben von Abfragen.

Wenn Ihnen eine Abfrage gefällt, können Sie sie freigeben und sogar 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 in der Feldliste auf das Feld und wählen Sie rechts neben dem Feldnamen das Looker-Symbol 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. In SQL Runner werden alle Abfragen angezeigt, die über 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 Abfrage 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 Feldes wird auch durch eine Zahl angegeben, die seine Sortierreihenfolge im Vergleich zu anderen Feldern kennzeichnet, sowie durch einen Pfeil neben dem Feldnamen, der die Sortierrichtung (auf- oder absteigend) zeigt, und durch ein Popup-Feld, das erscheint, wenn Sie mit der Maus auf einen Feldnamen zeigen.

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 herunterladen

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 in SQL Runner zu diesem Zeitpunkt nicht ausführen.
  2. Wählen Sie oben rechts im Zahnrad-Menü die Option 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 Herunterladen, um die Ergebnisse in eine Datei auf Ihrem Computer herunterzuladen.

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

Bei SQL-Dialekten, die Streaming unterstützen, wird mit der Option Herunterladen des SQL Runners der gesamte Ergebnissatz heruntergeladen. 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 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 Zahnradmenü 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 Ihnen im Zahnradmenü der Spalte weitere Optionen zur Verfügung:

Sie können Spalten in der Ergebnistabelle auch manuell verschieben, anpinnen und größe anpassen.

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 Menge der Daten, die für die Abfrage erforderlich sind, und zeigt die Informationen neben 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. Bestehende Verbindungen können Sie im Looker-Steuerfeld Verwaltung auf der Seite Verbindungen im Bereich Datenbank bearbeiten.

Ad-hoc-Explore erstellen

Mit SQL Runner können Sie schnell einen Überblick über die Daten erhalten, indem Sie eine explorative Datenanalyse 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:

  • Explores aus den Abfrageergebnissen von SQL Runner erstellen
  • Aus der Tabellenliste des SQL-Runners untersuchen

Aus SQL Runner-Abfrageergebnissen untersuchen

Mit dem 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. Diese Funktion kann für jede Abfrage 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 gewünschte SQL-Abfrage zu erstellen.
  2. Wählen Sie oben rechts im Zahnrad-Menü die Option Explore aus. Daraufhin wird ein neues Explore geöffnet, in dem Sie die SQL-Abfrage so analysieren können, als wäre sie eine gespeicherte Tabelle in Ihrem Modell.
  3. Sie können die URL zu diesem Explore kopieren, um sie zu teilen.
  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 Exploren 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 Entdecken aus. Führen Sie dann in der Feldauswahl 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. So können Sie Looker für eine Tabelle verwenden, bevor Sie sie modelliert haben, und sie wie eine LookML-Ansicht analysieren.

Sobald Sie ein Explore für die Tabelle öffnen, 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 analysieren aus.
  3. Looker generiert ein temporäres Modell mit einer Ansicht für die Tabelle und zeigt dann das Explore an.
  4. In Looker wird für jede Spalte in der Tabelle ein Dimensionsfeld bereitgestellt. Auf diese Weise wird in Looker ein Modell zu Beginn eines Projekts generiert.
  5. Looker fügt für alle Datumsfelder automatisch Zeiträume hinzu.
  6. Looker enthält auch einen Zählwert.

Wenn Sie die Option Explore-Tabelle 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 Überprüfen von SQL-Fehlern in Abfragen.

Hervorhebung von Fehlern im SQL Runner

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

Die angegebenen Positionsinformationen variieren je nach Datenbankdialekt. MySQL gibt beispielsweise 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 ihn rot unterstreicht und die Zeile mit einem x kennzeichnet. Bewegen Sie den Mauszeiger auf das x, um weitere Informationen zum Fehler zu erhalten. Nachdem Sie das Problem behoben haben, wählen Sie Ausführen aus, um zu sehen, ob noch weitere Fehler in der Abfrage vorhanden sind.

Fehler in Explores mit SQL Runner prüfen

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 generierte SQL-Code des Explores in SQL Runner kopiert. Wie im Abschnitt Fehlerhervorhebung in SQL Runner zu sehen ist, hebt SQL Runner die Position von Fehlern 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 so lange noch einmal ausführen, bis Sie die Fehler behoben haben.

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

Informationen dazu, wie Sie mit SQL Runner SQL-Fehler in abgeleiteten Tabellen prüfen, finden Sie im Looker-Communitybeitrag Abgeleitete Tabellen mit SQL Runner testen.