Mit SQL Runner Abfragen und explorative Datenanalysen erstellen

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 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. Weitere Informationen finden Sie auf den folgenden Dokumentationsseiten:

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, eine Explore verwenden, um die Abfrage zu 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 von Grund auf neu schreiben

Mit SQL Runner können Sie eigene SQL-Abfragen für Ihre Datenbank schreiben und ausführen. Looker gibt Ihre Abfrage genau so an die Datenbank weiter, wie Sie sie geschrieben haben. Achten Sie also darauf, dass die Syntax Ihrer SQL-Abfrage für Ihren Datenbankdialekt gültig ist. So hat jeder Dialekt beispielsweise leicht unterschiedliche SQL-Funktionen mit bestimmten 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. Die Ergebnisse finden Sie im Bereich Ergebnisse. 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.

Mit einigen SQL-Programmen können Sie mehrere Abfragen nacheinander 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 in SQL Runner hilft beim Testen und Beheben von Abfragen.

SQL-Abfrage mit einem Explore erstellen

Sie können auch eine Abfrage in einem explorativen Datenanalysetool 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 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-Bereiche 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 sich die Visualisierung anzusehen 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 Visualisierungen, die Sie mit SQL Runner erstellt haben, über die URL freigeben. 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 sind einige Dinge zu beachten:

  • In der Ergebnistabelle und -visualisierung werden alle numerischen Felder als Messwert interpretiert.
  • 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 für statische Karten (Regionen) werden von SQL Runner-Visualisierungen nicht unterstützt. Karten, die Daten für Breiten- und Längengrade verwenden (Karten- und Visualisierungen für statische Karten (Punkte)), werden jedoch unterstützt.
  • Zeitachsenavisualisierungen werden von SQL Runner-Visualisierungen nicht unterstützt.

Dimensionen als Drehpunkt festlegen

Sie können die Abfrageergebnisse bearbeiten, um sie in SQL Runner-Visualisierungen nach einer oder mehreren Dimensionen zu pivotieren. So erstellen Sie eine Pivot-Tabelle für ein Feld:

  1. Klicken Sie im Bereich Ergebnisse auf das Zahnradsymbol einer Spalte, um die Spaltenoptionen aufzurufen.
  2. Wählen Sie Spalte pivotieren aus.

Die gedrehten Ergebnisse werden in der SQL Runner-Visualisierung angezeigt.

Die Ergebnisse im Bereich Ergebnisse werden nicht gepivotet.

Wenn Sie die Pivot-Ergebnisse aufheben möchten, klicken Sie auf das Zahnradmenü der Pivot-Spalte und wählen Sie Spalte aufheben aus.

Feldtyp ändern

Bei der Anzeige der Ergebnisse und Visualisierung Ihrer Abfrage interpretiert SQL Runner jedes numerische Feld automatisch 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 Zahnradsymbol einer Spalte, um die Spaltenoptionen aufzurufen.
  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

Mit SQL Runner können Sie SQL-Abfragen für ein LookML-Modell schreiben und ausführen, anstatt sie direkt für Ihre Datenbank auszuführen. 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. Das kann Zeit sparen, wenn Sie beispielsweise eine Abfrage zum Beheben von Problemen mit einer abgeleiteten Tabelle erstellen.

Looker löst alle LookML-Ersetzungen auf und gibt die Abfrage dann an die Datenbank weiter. Die Abfrage muss daher in gültigem SQL für Ihren Datenbankdialekt vorliegen. So hat jeder Dialekt beispielsweise leicht 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. Optional können Sie eine Ansicht in der Ansichtsliste auswählen, um sie an der Cursorposition in die Abfrage aufzunehmen.
  5. Wenn Sie die Liste der Felder in einer Ansicht aufrufen möchten, wählen Sie die Ansicht im Bereich Ansichten aus. Optional können Sie ein Feld in der Feldliste auswählen, um es an der Position des Cursors in die Abfrage aufzunehmen.
  6. Im Bereich Vorbereitete SQL-Abfrage sehen Sie die resultierende SQL-Abfrage, die erstellt wird, nachdem alle LookML-Ersetzungen in SQL übersetzt wurden.
  7. Wählen Sie Ausführen aus, um die Abfrage auf Ihr Modell anzuwenden.
  8. Die Ergebnisse finden Sie im Bereich Ergebnisse. 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.

Mit SQL Runner können Sie neue Abfragen ausprobieren, vorhandene Abfragen testen oder aus den Ergebnissen eine neue explorative Datenanalyse ö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 über den SQL Runner ansehen

In der Feldliste auf dem Tab Modell sehen Sie auch die LookML für ein Feld. 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

Außerdem können Sie sich einen Verlauf aller Abfragen ansehen, die Sie in SQL Runner ausgeführt haben.

Wenn Sie Ihren Verlauf aufrufen möchten, wählen Sie oben im Navigationsbereich den Tab Verlauf aus. In SQL Runner werden alle Abfragen angezeigt, die über die Datenbankverbindung ausgeführt wurden. Rot bedeutet, dass eine Abfrage aufgrund eines Fehlers nicht ausgeführt wurde.

Wählen Sie eine Abfrage im Verlauf aus, um sie in SQL Runner einzufügen, und dann Ausführen, 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 angezeigt, je nachdem, ob die Ergebnisse in aufsteigender oder absteigender Reihenfolge sortiert sind. Sie können nach mehreren Spalten sortieren, indem Sie die Umschalttaste gedrückt halten und in der gewünschten Reihenfolge der Sortierung die zugehörigen Spaltenüberschriften auswählen. 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 Seite 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 Suchanfrage 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. Geben Sie im Feld SQL-Abfrage eine Abfrage ein. Sie müssen die Abfrage in SQL Runner 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 Option Herunterladen in SQL Runner nur die Zeilen der Abfrage heruntergeladen, die im Bereich Ergebnisse angezeigt werden (bis zu 5.000 Zeilen).

Spaltenwerte kopieren

Sie können Spaltenwerte aus dem Bereich Ergebnisse in SQL Runner kopieren. Wählen Sie das Zahnradmenü einer Spalte aus, um die Werte in die Zwischenablage zu kopieren. Dort können Sie die Spaltenwerte in eine Textdatei, eine Excel-Tabelle oder an 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 die Größe anpassen.

Kostenschätzungen für SQL Runner-Abfragen

Für Verbindungen zu BigQuery, MySQL, Amazon RDS for MySQL, Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL for PostgreSQL und Microsoft Azure PostgreSQL gibt SQL Runner eine Schätzung der Kosten der Abfrage an. 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.

Für BigQuery-, MySQL- und Amazon RDS for MySQL-Verbindungen sind Kostenschätzungen immer aktiviert. Für 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. 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
  • Explores über die Tabellenliste von SQL Runner erstellen

Explores aus den Ergebnissen von SQL Runner-Abfragen erstellen

Mit dem SQL Runner können Sie ein Explore über eine SQL-Abfrage öffnen. Dadurch wird ein temporäres Explore aus der im 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 Expl. Datenanalyse 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 hier 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 Benutzerdefinierte Felder haben, können Sie damit nicht modellierte Felder in SQL Runner visualisieren. Wählen Sie wie im vorherigen Abschnitt beschrieben im Zahnrad-Menü die Option Explore aus. Führen Sie dann in der Feldauswahl die folgenden Schritte aus:

In SQL Runner aufgeführte Tabelle untersuchen

Verwenden Sie die Option Tabelle analysieren auf dem Tab Datenbank, um eine explorative Datenanalyse für eine beliebige 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.

Nachdem Sie ein Explore für die Tabelle geöffnet haben, können Sie entscheiden, ob Sie sie Ihrem Projekt hinzufügen möchten. Auf dem Tab SQL des Explores können Sie sich die SQL-Abfragen ansehen, die Looker an die Datenbank sendet. Über die Schaltfläche Im SQL Runner öffnen können Sie die Abfrage dann wieder im SQL Runner öffnen.

  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. So wird auch in Looker ein Modell zu Beginn eines Projekts generiert.
  5. In Looker werden Zeiträume für alle Datumsfelder automatisch berücksichtigt.
  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 Informationen zur Position 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 Sie in einem Explore SQL-Syntaxfehler feststellen, können Sie mit SQL Runner den Ort und die Art des Fehlers ermitteln, z. B. Rechtschreibfehler oder fehlende Befehle.

  1. Wählen Sie in der explorativen Datenanalyse 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 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.

Mit SQL Runner Fehler in abgeleiteten Tabellen prüfen

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.