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 in den Tabellen Ihres Schemas navigieren, ein Ad-hoc-Explore aus einer SQL-Abfrage verwenden, vordefinierte beschreibende Abfragen für Ihre Daten ausführen, Ihren SQL-Runner-Verlauf aufrufen, Ergebnisse herunterladen, Abfragen freigeben, sie als abgeleitete Tabelle zu einem LookML-Projekt 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 wie Sie SQL-Runner zum Debuggen von Abfragen verwenden. Weitere Informationen finden Sie auf den folgenden Dokumentationsseiten:
- Grundlagen von SQL-Runner
- Abgeleitete Tabellen mit SQL-Runner erstellen
- Datenbankfunktionen mit SQL-Runner verwalten
Abfragen in SQL-Runner ausführen
Wenn Sie eine Abfrage für Ihre Datenbank ausführen möchten, können Sie die SQL-Abfrage von Grund auf neu schreiben, ein 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 übergibt Ihre Abfrage genau 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. Jeder Dialekt hat beispielsweise leicht unterschiedliche SQL-Funktionen mit bestimmten Parametern, die an die Funktion übergeben werden sollten.
- Geben Sie eine SQL-Abfrage in das Feld unter der Leiste Abfrage ein.
- Optional können Sie einen Tabellennamen oder ein Feld aus der Feldliste auswählen, um ihn an der Cursorposition in Ihre Abfrage einzufügen.
- Wählen Sie Ausführen aus, um die Abfrage für Ihre Datenbank auszuführen.
- Sehen Sie sich die Ergebnisse im Bereich Ergebnisse an. SQL-Runner lädt bis zu 5.000 Zeilen des Ergebnissatzes der Abfrage. Bei SQL-Dialekten, die Streaming unterstützen, können Sie die Ergebnisse herunterladen, um den gesamten Ergebnissatz zu sehen.
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 neue Abfragen zu testen oder vorhandene Abfragen zu prüfen. Die Fehlerhervorhebung in SQL-Runner hilft beim Testen und Debuggen von Abfragen.
Explore verwenden, um eine SQL-Abfrage zu 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:
- Wählen Sie in einem Explore in der Leiste Daten den Tab SQL aus.
- Die SQL-Abfrage wird unter der Leiste Daten angezeigt.
- Wählen Sie In SQL-Runner öffnen oder In SQL-Runner erklären aus, um die Abfrage in SQL-Runner zu öffnen.
Sobald eine Abfrage in das Feld unter der Leiste Abfrage eingefü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 SQL Runner Vis Labs-Funktion 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.
- Nachdem eine SQL-Abfrage erstellt und ausgeführt wurde, können Sie den Tab Visualisierung öffnen, um die Visualisierung anzusehen und einen Visualisierungstyp auszuwählen, genau wie auf der Explore-Seite.
- Sie können die Visualisierung über das Menü Einstellungen bearbeiten.
- 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 sind einige Dinge zu beachten:
- In der Ergebnistabelle und der Visualisierung wird jedes numerische Feld als Messwert interpretiert.
- In der Ergebnistabelle und 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, Pivots, Spaltensummen und Teilergebnisse verwenden möchten, führen Sie eine Explore-Abfrage aus Ihrer SQL-Runner-Abfrage aus.
- Visualisierungen mit statischen Karten (Regionen) werden von SQL-Runner-Visualisierungen nicht unterstützt. Karten, die Breiten- und Längengraddaten verwenden (Visualisierungen mit Karten und 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 bearbeiten, um sie in SQL-Runner-Visualisierungen nach einer oder mehreren Dimensionen zu pivotieren. So pivotieren Sie ein Feld:
- Wählen Sie im Bereich Ergebnisse das Zahnradmenü einer Spalte aus, um die Spaltenoptionen aufzurufen.
- Wählen Sie Spalte pivotieren aus.
Die pivotieren Ergebnisse werden in der SQL-Runner-Visualisierung angezeigt.
Wenn Sie die Pivotierung der Ergebnisse aufheben möchten, wählen Sie das Zahnradmenü der pivotieren Spalte und dann Pivotierung der Spalte aufheben aus.
Feldtyp ändern
Wenn die Ergebnisse und die Visualisierung Ihrer Abfrage angezeigt werden, 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 einen Messwert umwandeln oder umgekehrt. Gehen Sie dazu so vor:
- Wählen Sie im Bereich Ergebnisse das Zahnradmenü einer Spalte aus, um die Spaltenoptionen aufzurufen.
- Wählen Sie In Dimension umwandeln oder In Messwert umwandeln 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 direkt für Ihre Datenbank. Wenn Sie eine Abfrage für ein Modell erstellen, können Sie LookML-Substitutionsoperatoren wie ${view_name.field_name} oder ${view_name.SQL_TABLE_NAME} verwenden. Das kann Zeit sparen, wenn Sie beispielsweise eine Abfrage erstellen, um Fehler in einer abgeleiteten Tabelle zu beheben.
Looker löst alle LookML-Substitutionen auf und übergibt Ihre Abfrage dann an Ihre Datenbank. Die Abfrage sollte also in gültigem SQL für Ihren Datenbankdialekt vorliegen. Jeder Dialekt hat 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:
- Wählen Sie den Tab Modell aus.
- Wählen Sie das Modell aus, das Sie abfragen möchten.
- Geben Sie im Textfeld unter der Leiste Daten Ihre SQL-Abfrage mit LookML-Feldern ein.
- Optional können Sie in der Ansichtsliste eine Ansicht auswählen, um sie an der Cursorposition in Ihre Abfrage einzufügen.
- 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 Cursorposition in Ihre Abfrage einzufügen.
- Im Bereich Vorbereitete SQL-Abfrage können Sie die resultierende SQL-Abfrage sehen, die erstellt wurde, nachdem alle LookML-Substitutionen in SQL übersetzt wurden.
- Wählen Sie Ausführen aus, um die Abfrage für Ihr Modell auszuführen.
- Sehen Sie sich die Ergebnisse im Bereich Ergebnisse an. SQL-Runner lädt bis zu 5.000 Zeilen des Ergebnissatzes der Abfrage. Bei SQL-Dialekten, die Streaming unterstützen, können Sie die Ergebnisse herunterladen, um den gesamten Ergebnissatz zu sehen.
Mit SQL-Runner können Sie neue Abfragen testen, vorhandene Abfragen prüfen oder ein neues Explore aus den Ergebnissen öffnen. Die Fehlerhervorhebung in SQL-Runner hilft beim Testen und Debuggen von Abfragen.
Wenn Sie eine Abfrage haben, die Ihnen gefällt, können Sie sie freigeben und sogar einem LookML-Projekt hinzufügen.
LookML-Code eines Feldes in SQL-Runner aufrufen
In der Feldliste 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 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 einen Verlauf der letzten Abfragen sehen, die Sie in SQL-Runner ausgeführt haben.
Wählen Sie oben im Navigationsbereich den Tab Verlauf aus, um Ihren Verlauf aufzurufen. In SQL-Runner werden alle Abfragen angezeigt, die für 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 wählen Sie dann Ausführen aus, um die Abfrage noch einmal auszuführen.
Abfrage sortieren
Die Sortierreihenfolge einer Tabelle wird durch einen Pfeil nach oben oder unten neben dem Namen des sortierten Felds angegeben, je nachdem, ob die Ergebnisse in aufsteigender oder absteigender Reihenfolge vorliegen. Sie können nach mehreren Spalten sortieren, indem Sie die Umschalttaste gedrückt halten und die Spaltenüberschriften in der gewünschten Reihenfolge der Sortierung 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 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 Zugriff auf SQL-Runner hat. Wenn Sie eine Abfrage freigeben möchten, kopieren Sie die URL in der Adressleiste Ihres Browsers.
Ergebnisse herunterladen
Nachdem Sie Ihre SQL-Abfrage ausgeführt haben, können Sie die Ergebnisse in verschiedenen Formaten herunterladen.
- Schreiben Sie eine Abfrage in das Feld SQL-Abfrage. Sie müssen die Abfrage an dieser Stelle nicht in SQL-Runner ausführen.
- Wählen Sie rechts oben im Zahnradmenü die Option Herunterladen aus.
- Wählen Sie das Dateiformat für den Download aus (Textdatei, CSV, JSON usw.).
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 eine Datei auf Ihrem Computer herunterzuladen.
Bei SQL-Dialekten, die Streaming unterstützen, werden mit der Option Herunterladen in SQL-Runner der gesamte Ergebnissatz heruntergeladen. Bei SQL-Dialekten, die kein Streaming 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. Von dort aus können Sie die Spaltenwerte in eine Textdatei, eine Excel-Tabelle oder an einen anderen Ort einfügen.
Wenn Ihr Looker-Administrator die SQL Runner Vis Labs-Funktion aktiviert hat, stehen Ihnen im Zahnradmenü der Spalte auch andere Optionen zur Verfügung:
- Fixieren und Fixierung aufheben
- Alle Spaltenbreiten automatisch anpassen
- Alle Spaltenbreiten zurücksetzen
Sie können Spalten in der Ergebnistabelle auch manuell verschieben, fixieren und ihre Größe ändern.
Kostenschätzungen für SQL-Runner-Abfragen
Für BigQuery, MySQL, Amazon RDS for MySQL, Snowflake, Amazon Redshift, Amazon Aurora, PostgreSQL, Cloud SQL for PostgreSQL und Microsoft Azure PostgreSQL -Verbindungen bietet SQL-Runner eine Schätzung der Kosten der Abfrage. Sobald Sie die SQL-Abfrage eingeben, berechnet SQL-Runner das für die Abfrage erforderliche Datenvolumen 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 Kostenschätzung aktivieren, wenn Sie die Verbindung erstellen. Bei vorhandenen Verbindungen können Sie die Verbindung auf der Seite **Verbindungen** im Bereich **Datenbank** des **Admin** -Bereichs von Looker bearbeiten.
Ad-hoc-Explore erstellen
Mit SQL-Runner können Sie schnell Einblicke in die Daten erhalten, indem Sie ein Ad-hoc-Explore für eine SQL-Abfrage oder eine 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:
- Explore aus den Abfrageergebnissen von SQL-Runner
- Explore aus der Tabellenliste von SQL-Runner
Explore aus den Abfrageergebnissen von SQL-Runner
Mit SQL-Runner können Sie ein Explore aus einer SQL-Abfrage öffnen. Dadurch 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 jede Abfrage verwendet werden, ist aber besonders nützlich, um Abfragen zu testen, die Sie für abgeleitete Tabellen verwenden möchten.
- Erstellen Sie mit SQL-Runner die gewünschte SQL-Abfrage.
- Wählen Sie rechts oben im Zahnradmenü die Option Explore aus. Sie werden zu einem neuen Explore weitergeleitet, in dem Sie die SQL-Abfrage so untersuchen können, als wäre sie eine gespeicherte Tabelle in Ihrem Modell.
- Sie können die URL zu diesem Explore kopieren, um es freizugeben.
- Wenn Sie diese Abfrage direkt von hier aus als abgeleitete Tabelle in Ihrem Projekt hinzufügen möchten, wählen Sie Ansicht zum Projekt hinzufügen aus.
Benutzerdefinierte Felder erstellen, während Sie in SQL-Runner Daten untersuchen
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 Explore aus. Führen Sie dann in der Feldauswahl die folgenden Schritte aus:
- Wählen Sie den Bereich Benutzerdefinierte Felder aus, um ihn zu öffnen, und wählen Sie dann Hinzufügen aus, um eine benutzerdefinierte Dimension, einen benutzerdefinierten Messwert oder eine Tabellenkalkulation zu erstellen. Wenn Sie den Bereich Benutzerdefinierte Felder nicht sehen, haben Sie keinen Zugriff auf die Erstellung benutzerdefinierter Felder.
- Wählen Sie das Dreipunkt-Menü Mehr eines Messwerts und dann Messwert filtern aus, um einen gefilterten benutzerdefinierten Messwert aus einem vorhandenen Messwert zu erstellen.
- Wählen Sie das Dreipunkt-Menü Mehr einer Dimension und dann einen Messwerttyp (z. B. „Summe“ oder „Anzahl“) aus, um einen benutzerdefinierten Messwert aus einer Dimension zu erstellen.
Tabelle untersuchen, die in SQL-Runner aufgeführt ist
Verwenden Sie die Option Tabelle untersuchen auf dem Tab Datenbank , um ein Ad-hoc-Explore 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 die Tabelle wie eine LookML-Ansicht untersuchen.
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 auf dem Tab SQL des Explores die SQL-Abfragen sehen, die Looker an die Datenbank sendet, und dann mit der Schaltfläche In SQL-Runner öffnen die Abfrage wieder in SQL-Runner einfügen.
- Wählen Sie den Tab Datenbank aus.
- Wählen Sie in SQL-Runner das Zahnradmenü für eine Tabelle und dann Tabelle untersuchen aus.
- Looker generiert ein temporäres Modell mit einer Ansicht für die Tabelle und zeigt dann das Explore an.
- Looker stellt für jede Spalte in der Tabelle ein Dimensionsfeld bereit. So generiert Looker auch ein Modell zu Beginn eines Projekts.
- Looker fügt automatisch Zeiträume für alle Datumsfelder ein.
- Looker enthält auch einen Messwert für die Anzahl.
Debuggen mit SQL-Runner
SQL-Runner ist auch ein nützliches Tool zum Prüfen von SQL-Fehlern in Abfragen.
Fehlerhervorhebung in 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 aufweisen.
SQL-Runner hebt auch die Position des ersten Syntaxfehlers im SQL-Befehl hervor, indem er ihn rot unterstreicht und die Zeile mit einem x markiert. 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 prüfen, ob in der Abfrage weitere Fehler vorhanden sind.
SQL-Runner verwenden, um Fehler in Explores zu prüfen
Wenn in einem Explore SQL-Syntaxfehler auftreten, können Sie mit SQL-Runner die Position und den Typ des Fehlers ermitteln, z. B. Rechtschreibfehler oder fehlende Befehle.
- Wählen Sie im Explore in der Leiste Daten den Tab SQL aus.
- 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 gezeigt, 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 noch einmal ausführen, bis Sie die Fehler behoben haben.
SQL-Runner verwenden, um Fehler in abgeleiteten Tabellen zu prüfen
Informationen zur Verwendung von SQL-Runner zum Prüfen von SQL-Fehlern in abgeleiteten Tabellen finden Sie im Using SQL Runner to test derived tables Looker Community-Beitrag.