SQL Runner bietet direkten Datenbankzugriff, mit dem Sie abgeleitete Tabellen für Ihre LookML-Projekte erstellen und debuggen können. Mit SQL Runner können Sie neue abgeleitete Tabellen definieren und Fehler in vorhandenen beheben. So können Sie die Datengenauigkeit sicherstellen und Ihren Entwicklungsablauf verbessern. In dieser Anleitung wird beschrieben, wie Sie SQL Runner für diese Aufgaben verwenden.
Auf dieser Seite wird beschrieben, wie Sie mit SQL Runner eine abgeleitete Tabelle erstellen und wie Sie mit SQL Runner Fehler in abgeleiteten Tabellen beheben. Weitere Informationen finden Sie auf den folgenden Dokumentationsseiten:
- Grundlagen von SQL Runner
- SQL Runner zum Erstellen von Abfragen und Explores verwenden
- Datenbankfunktionen mit SQL Runner verwalten
SQL Runner-Abfrage zu einem LookML-Projekt hinzufügen
SQL Runner ist ein guter Ort, um SQL-Code zu testen, der als abgeleitete Tabelle in Ihrem LookML-Projekt verwendet werden soll. Sie können sogar eine SQL-Abfrage aus einem anderen Tool abrufen, sie in SQL Runner testen und sie dann Ihrem LookML-Projekt hinzufügen.
Nachdem Sie eine SQL-Abfrage in SQL Runner erstellt haben, können Sie mit der Option Zu Projekt hinzufügen oder LookML für abgeleitete Tabelle abrufen eine abgeleitete Tabelle aus der Abfrage erstellen. Mit beiden Optionen können Sie eine Abfrage in SQL Runner verwenden und sie Ihrem LookML-Projekt hinzufügen. Weitere Informationen finden Sie in den folgenden Abschnitten.
Zu Projekt hinzufügen
Die Option Zu Projekt hinzufügen ist die einfachste Möglichkeit, 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 in Ihrem ausgewählten Projekt. Wenn Sie stattdessen die Ansichtsdatei manuell erstellen und die LookML-Abfrage selbst hinzufügen möchten, können Sie die Option LookML für abgeleitete Tabelle abrufen verwenden.
So verwenden Sie die Option Zu Projekt hinzufügen:
- Erstellen Sie mit SQL Runner eine SQL-Abfrage, die Sie für eine abgeleitete Tabelle verwenden möchten.
- Klicken Sie oben rechts im Zahnradmenü auf Zu 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 Ihrem Projekt hinzuzufügen. Looker wechselt in den Entwicklermodus, falls er noch nicht aktiviert ist, erstellt eine neue Ansichtsdatei mit der LookML aus der SQL Runner-Abfrage und öffnet dann den Dateibrowser der IDE für die neue Ansichtsdatei.
- Verschieben Sie die Datei entsprechend der Dateiorganisation Ihres Projekts.
- Validieren Sie die LookML und stellen Sie Ihre Änderungen in der Produktion bereit.
LookML für abgeleitete Tabelle abrufen
Eine weitere Möglichkeit, eine abgeleitete Tabelle aus Ihrer SQL Runner-Abfrage zu erstellen, ist die Option LookML für abgeleitete Tabelle abrufen im Zahnradmenü von SQL Runner. Wie bei der Option Zu Projekt hinzufügen stellt Looker die LookML bereit, die erforderlich ist, um Ihre SQL-Abfrage in eine abgeleitete Tabelle umzuwandeln. Anschließend können Sie die LookML kopieren und selbst in Ihr Projekt einfügen. Das 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 LookML für abgeleitete Tabelle abrufen aus.
Klicken Sie im Pop-up-Fenster LookML für abgeleitete Tabelle 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 im Feld Ansichtsname einen Namen für die neue Ansicht ein. Informationen zu Namenskonventionen für Dateien finden Sie auf der Seite LookML-Dateien und -Ordner verwalten.
Klicken Sie auf die Schaltfläche Hinzufügen. Looker wechselt in den Entwicklermodus, falls er noch nicht aktiviert ist, erstellt eine neue Ansichtsdatei mit der LookML aus der SQL Runner-Abfrage und öffnet dann den Dateibrowser der IDE für die neue Ansichtsdatei.
Verschieben Sie die Datei entsprechend der Dateiorganisation Ihres Projekts.
Validieren Sie die LookML und stellen Sie Ihre Änderungen in der Produktion bereit.
Fehlerbehebung mit SQL Runner
SQL Runner ist auch ein nützliches Tool zum Prüfen von SQL-Fehlern in der Definition einer abgeleiteten Tabelle.
Fehler in SQL Runner hervorheben
SQL Runner hebt die Position von Fehlern im SQL-Befehl hervor und gibt die Position des Fehlers in der Fehlermeldung an.
Die 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, klicken Sie auf Ausführen , um zu prüfen, ob weitere Fehler in der Abfrage vorhanden sind.
Abgeleitete Tabellen mit SQL Runner testen
Wenn ein Fehler in einer abgeleiteten Tabelle auftritt, 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 die Position des Fehlers einzugrenzen. Weitere Informationen finden Sie im Looker Community-Beitrag Using SQL Runner to test derived tables.