SQL-Abfragen als Vorschau ansehen

In diesem Dokument wird gezeigt, wie Sie die Ausgabe einer SQL-Abfrage in einem Dataform-Arbeitsbereich als Vorschau ansehen, bevor Sie die Abfrage in BigQuery ausführen.

Abfragevorschau in Dataform

Wenn Sie eine Abfrage in einer SQLX- oder JavaScript-Datei mit Dataform Core entwickeln, kompiliert Dataform die Abfrage in Echtzeit in SQL. Wenn Sie die Ausgabe der kompilierten SQL-Abfrage testen möchten, bevor Sie sie in BigQuery ausführen, können Sie in Ihrem Dataform-Arbeitsbereich eine Vorschau der Abfrage ausführen.

Wenn Sie die Vorschau einer Abfrage ausführen, führt Dataform einen Job in BigQuery aus, um die kompilierte Abfrage in einer temporären Zieltabelle auszuführen und die Abfrageergebnisse in Ihrem Arbeitsbereich anzuzeigen. Sie können die Ausgabe der Abfrage prüfen, bevor Sie die Ausführung zum Veröffentlichen der Tabelle in BigQuery auslösen. Die temporäre Tabelle mit der Vorschau der Abfrage wird innerhalb von 24 Stunden automatisch gelöscht. Weitere Informationen zu BigQuery-Jobs finden Sie unter Einführung in BigQuery-Jobs.

Wenn Sie die Abfragevorschau in Dataform ausführen, fallen in BigQuery Kosten an. Weitere Informationen zu den Preisen von BigQuery finden Sie unter BigQuery-Preise.

Während der Abfragevorschau verwendet Dataform Ihre Nutzeranmeldedaten, um Jobs in BigQuery auszuführen. Während der Workflowausführung verwendet Dataform jedoch Ihre Dienstkonto-Anmeldedaten, um Assets in BigQuery zu erstellen oder zu aktualisieren.

Dataform zeigt die Ergebnisse aller Abfragen, die während der aktuellen Browsersitzung in der Vorschau angezeigt wurden, im Bereich Abfrageergebnisse Ihres Arbeitsbereichs an. Im Bereich Abfrageergebnisse können Sie die folgenden Informationen zu jeder Abfrage sehen, die während der aktuellen Browsersitzung als Vorschau angezeigt wird:

  • Jobinformationen
    • BigQuery-Job-ID
    • Nutzer, der die Vorschau ausführt
    • Ort, an dem der Job ausgeführt wird (aus der Datei dataform.json)
    • Erstellungs-, Start- und Endzeit des BigQuery-Jobs
    • Dauer des BigQuery-Jobs
    • Verarbeitete Byte
    • In BigQuery in Rechnung gestellte Byte
    • Priorität des Jobs
    • Verwendung von Legacy-SQL in der Abfrage
    • Temporäre Zieltabelle der Abfrage
  • Ergebnisse der Abfrage
  • JSON-Darstellung der Abfrageausgabe

Außerdem können Sie im Bereich Abfrageergebnisse zur Quelldatei jeder Vorschauabfrage und zu BigQuery Studio wechseln, um den Vorschaujob aufzurufen.

Hinweise

  1. Rufen Sie in der Google Cloud Console die Seite Dataform auf.

    Zur Seite „Dataform“

  2. Wählen Sie ein Repository aus oder erstellen Sie ein Repository.

  3. Wählen Sie einen Entwicklungsarbeitsbereich aus oder erstellen Sie einen.

  4. Erstellen Sie eine SQL-Abfrage, z. B. Definieren Sie eine Tabelle.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zu gewähren, um die Berechtigungen zu erhalten, die Sie für die Vorschau von Abfragen in einem Dataform-Arbeitsbereich benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Vorschau einer Abfrage anzeigen

Wenn Sie die Abfrageergebnisse in Dataform vor der Ausführung prüfen möchten, führen Sie in Ihrem Arbeitsbereich die Vorschau einer Abfrage aus. Wenn die aktuell bearbeitete Datei mehrere Abfragen enthält, wählen Sie die Abfrage aus, die Sie als Vorschau ansehen möchten. Sie können jeweils nur eine Abfrage in der Vorschau anzeigen.

Das Ausführen der Vorschau bei Tabellen mit Assertions ist etwas anders. Weitere Informationen finden Sie unter Vorschau auf eine Tabelle mit Assertions ansehen.

So können Sie sich eine Vorschau einer SQL-Abfrage anzeigen lassen und Abfrageergebnisse in einem Dataform-Arbeitsbereich ansehen:

  1. Maximieren Sie im Bereich Dateien die Option definitions/.
  2. Wählen Sie eine SQLX- oder JavaScript-Datei aus.
  3. Klicken Sie auf Ausführen.
    1. Wenn die Datei mehrere Abfragen enthält, wählen Sie im Drop-down-Menü die Abfrage aus, die Sie als Vorschau ansehen möchten.
  4. Sehen Sie sich die Ergebnisse der Vorschau im Bereich Abfrageergebnisse an.
    1. Wählen Sie den Tab Jobinformationen aus, um die Jobdetails zu überprüfen.
    2. Wählen Sie den Tab Ergebnisse aus, um die Abfrageergebnisse zu prüfen.
    3. Wählen Sie den Tab JSON aus, um die JSON-Ausgabe der Abfrage aufzurufen.
    4. Zum Aufrufen der Jobvorschau im SQL-Arbeitsbereich klicken Sie auf das Dreipunkt-Menü > Job im SQL-Arbeitsbereich ansehen.

Vorschau einer Tabelle mit Assertions ansehen

In einer SQLX-Tabellendefinitionsdatei mit Assertions können Sie die Abfrage zur Tabellenerstellung und die definierten Assertion-Abfragen als Vorschau ansehen.

Dataform behandelt die Tabellendefinitionsabfrage als Standardabfrage. Klicken Sie in Ihrem Arbeitsbereich auf Ausführen, um eine Vorschau der Abfrage zum Erstellen der Tabelle anzeigen zu lassen. Wenn Sie eine Vorschau einer Assertion-Abfrage anzeigen lassen möchten, müssen Sie sie in einem Drop-down-Menü neben der Schaltfläche Ausführen auswählen. Sie können jeweils nur eine Abfrage in der Vorschau anzeigen.

So zeigen Sie eine Abfrage in einer Tabellendefinitionsdatei mit Assertions in einem Dataform-Arbeitsbereich an:

  1. Maximieren Sie im Bereich Dateien die Option definitions/.
  2. Wählen Sie eine Definitionsdatei einer Tabelle mit Assertions aus.
  3. Vorschau ausführen:
    • Klicken Sie auf Ausführen, um eine Vorschau der Abfrage zum Erstellen der Tabelle anzeigen zu lassen.
    • Wenn Sie eine Vorschau einer Assertion-Abfrage anzeigen lassen möchten, klicken Sie auf das Drop-down-Symbol neben Ausführen und wählen Sie die Abfrage aus, die Sie als Vorschau ansehen möchten.
  4. Sehen Sie sich die Ergebnisse der Vorschau im Bereich Abfrageergebnisse an.
    1. Wählen Sie den Tab Jobinformationen aus, um die Jobdetails zu überprüfen.
    2. Wählen Sie den Tab Ergebnisse aus, um die Abfrageergebnisse zu prüfen.
    3. Wählen Sie den Tab JSON aus, um die JSON-Ausgabe der Abfrage aufzurufen.
    4. Zum Aufrufen der Jobvorschau im SQL-Arbeitsbereich klicken Sie auf das Dreipunkt-Menü > Job im SQL-Arbeitsbereich ansehen.

Nächste Schritte