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 mit SQL Runner eine abgeleitete Tabelle erstellen und mit SQL Runner Fehler in abgeleiteten Tabellen beheben. Auf diesen anderen Dokumentationsseiten finden Sie Informationen zu folgenden Themen:
- SQL Runner-Grundlagen
- Mit SQL Runner Abfragen und Explores erstellen
- Datenbankfunktionen mit SQL Runner verwalten
SQL-Runner-Abfrage zu einem LookML-Projekt hinzufügen
SQL Runner eignet sich hervorragend zum Testen von SQL, um es als abgeleitete Tabelle in Ihrem LookML-Projekt zu verwenden. Sie können sogar eine SQL-Abfrage von einem anderen Tool abrufen, sie in SQL Runner testen und dann Ihrem LookML-Projekt hinzufügen.
Nachdem Sie eine SQL-Abfrage in SQL Runner erstellt haben, können Sie aus der Abfrage eine abgeleitete Tabelle erstellen. Verwenden Sie dazu die Option Add to Project (Zu Projekt hinzufügen) oder die Option Get Derived Table LookML. Mit beiden Optionen können Sie eine Abfrage in SQL Runner in Ihr LookML-Projekt einfügen. Weitere Informationen finden Sie in den folgenden Abschnitten.
Zum Projekt hinzufügen
Die Option Zum Projekt hinzufügen ist die einfachste Methode, um eine SQL-Runner-Abfrage zu Ihrem Projekt hinzuzufügen:
Mit der Option Zu Projekt hinzufügen können Sie ein LookML-Projekt auswählen. Looker erstellt dann automatisch eine Ansichtsdatei mit der Abfrage im ausgewählten Projekt. Wenn Sie die Ansichtsdatei stattdessen manuell erstellen und den LookML-Code der Abfrage selbst hinzufügen möchten, können Sie die Option Look Abgeleitete Tabelle abrufen verwenden.
So verwenden Sie die Option Zum Projekt hinzufügen:
- Erstellen Sie mit SQL Runner eine SQL-Abfrage, die Sie für eine abgeleitete Tabelle verwenden möchten.
- Klicken Sie rechts oben im Zahnradmenü auf Zum Projekt hinzufügen.
- Wählen Sie das Projekt aus, dem Sie diese abgeleitete Tabelle hinzufügen möchten.
- Geben Sie einen Ansichtsnamen für die abgeleitete Tabelle ein.
- Klicken Sie auf Hinzufügen, um die Abfrage als abgeleitete Tabelle in Ihr Projekt einzufügen. Looker wechselt in den Entwicklungsmodus, wenn er noch nicht vorhanden ist, erstellt eine neue Ansichtsdatei mit dem LookML-Code aus der SQL-Runner-Abfrage und öffnet dann den IDE-Dateibrowser für die neue Ansichtsdatei.
- Verschieben Sie die Datei entsprechend der Dateiorganisation Ihres Projekts.
- Validieren Sie den LookML-Code und stellen Sie Ihre Änderungen für die Produktion bereit.
LookML für abgeleitete Tabelle abrufen
Eine andere Möglichkeit zum Erstellen einer abgeleiteten Tabelle aus Ihrer SQL Runner-Abfrage ist die Option Get Abgeleitete Tabelle LookML im SQL Runner-Zahnradmenü. Genau wie bei der Option Zum Projekt hinzufügen stellt Looker den LookML-Code bereit, der erforderlich ist, um Ihre SQL-Abfrage in eine abgeleitete Tabelle umzuwandeln. Von dort aus können Sie den LookML-Code kopieren und selbst in Ihr Projekt einfügen. Dies ist nützlich, wenn Sie eine vorhandene abgeleitete Tabelle ersetzen möchten.
So erstellen Sie eine abgeleitete Tabelle aus einer SQL Runner-Abfrage:
- Erstellen Sie mit SQL Runner eine SQL-Abfrage, die Sie für eine abgeleitete Tabelle verwenden möchten.
- Klicken Sie auf das Zahnradmenü und wählen Sie Abgeleitete Tabelle in LookML abrufen aus.
Klicken Sie im Pop-up-Fenster Abgeleitete Tabelle in LookML abrufen auf den Link Zu Projekt hinzufügen.
Wählen Sie in der Drop-down-Liste Projekt das Projekt aus, dem Sie die abgeleitete Tabelle hinzufügen möchten.
Geben Sie in das Feld Name der Datenansicht einen Namen für die neue Datenansicht ein. Weitere Informationen zu Dateinamenskonventionen finden Sie auf der Seite LookML-Dateien und -Ordner verwalten.
Klicken Sie auf Hinzufügen. Looker wechselt in den Entwicklungsmodus, wenn er noch nicht vorhanden ist, erstellt eine neue Ansichtsdatei mit dem LookML-Code aus der SQL-Runner-Abfrage und öffnet dann den IDE-Dateibrowser für die neue Ansichtsdatei.
Verschieben Sie die Datei entsprechend der Dateiorganisation Ihres Projekts.
Validieren Sie den LookML-Code und stellen Sie Ihre Änderungen für die Produktion bereit.
Fehlerbehebung mit SQL-Runner
SQL Runner ist außerdem ein nützliches Tool zum Überprüfen von SQL-Fehlern in der Definition einer abgeleiteten Tabelle.
SQL Runner-Fehlermarkierung
SQL Runner hebt die Fehlerstelle im SQL-Befehl hervor und fügt die Fehlerposition in die Fehlermeldung auf.
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 das „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.
SQL-Runner zum Testen abgeleiteter Tabellen verwenden
Wenn Sie einen Fehler sehen, der aus einer abgeleiteten Tabelle stammt, können Sie die Ursache des Fehlers ermitteln, indem Sie die SQL-Anweisung in SQL Runner kopieren und verschiedene Teile des SQL-Codes testen, um den Ort des Fehlers einzugrenzen. Weitere Informationen finden Sie im Looker-Community-Beitrag zum Testen abgeleiteter Tabellen mit SQL Runner.