Vorschau von SQL-Abfragen anzeigen

In diesem Dokument erfahren Sie, wie Sie sich eine Vorschau der Ausgabe einer SQL-Abfrage in einem Dataform-Arbeitsbereich 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. Sie können eine Vorschau der Abfrage in Ihrem Dataform-Arbeitsbereich ausführen, um die Ausgabe der kompilierten SQL-Abfrage zu testen, bevor Sie sie in BigQuery 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 überprüfen, bevor Sie die Ausführung zum Veröffentlichen der Tabelle in BigQuery auslösen. Die temporäre Tabelle mit der Vorschau 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 Kosten in BigQuery 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 die Anmeldedaten Ihres Dienstkontos, um Assets in BigQuery zu erstellen oder zu aktualisieren.

Dataform zeigt die Ergebnisse aller Abfragen, die während der aktuellen Browsersitzung als Vorschau angezeigt wurden, im Bereich Abfrageergebnisse in Ihrem Arbeitsbereich an. Im Bereich Abfrageergebnisse sehen Sie die folgenden Informationen zu jeder Abfrage, die während der aktuellen Browsersitzung in der Vorschau angezeigt wurde:

  • Jobinformationen
    • BigQuery-Job-ID
    • Nutzer, der die Vorschau ausführt
    • Standort, an dem der Job ausgeführt wird, entnommen aus der Datei mit den Workfloweinstellungen
    • Erstellungs-, Start- und Endzeiten des BigQuery-Jobs
    • Dauer des BigQuery-Jobs
    • Verarbeitete Byte
    • In BigQuery abgerechnete Byte
    • Priorität des Jobs
    • Verwendung von Legacy-SQL in der Abfrage
    • Temporäre Zieltabelle der Abfrage
  • Ergebnisse der Abfrage
  • JSON-Darstellung der Abfrageausgabe

Darüber hinaus können Sie im Bereich Abfrageergebnisse zur Quelldatei jeder in der Vorschau angezeigten Abfrage und zu BigQuery Studio wechseln, um den Vorschaujob anzuzeigen.

Hinweise

  1. Öffnen Sie in der Google Cloud Console die Seite Dataform.

    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, zum Beispiel, um eine Tabelle zu definieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zu gewähren, damit Sie die Berechtigungen erhalten, die Sie für die Vorschau von Abfragen benötigen:

  • Dataform Editor (roles/dataform.editor) – Arbeitsbereiche
  • BigQuery-Jobnutzer (roles/bigquery.jobUser): das Projekt

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 Abfrageergebnisse in Dataform vor der Ausführung prüfen möchten, führen Sie die Vorschau einer Abfrage in Ihrem Arbeitsbereich aus. Wenn die aktuell bearbeitete Datei mehrere Abfragen enthält, wählen Sie die Abfrage aus, für die Sie eine Vorschau anzeigen möchten. Sie können jeweils nur eine Abfrage in der Vorschau anzeigen.

Das Ausführen der Vorschau für Tabellen mit Assertions ist etwas anders. Weitere Informationen finden Sie unter Tabelle mit Assertions als Vorschau ansehen.

So rufen Sie die Vorschau einer SQL-Abfrage und die Abfrageergebnisse in einem Dataform-Arbeitsbereich auf:

  1. Maximieren Sie im Bereich Dateien den Bereich 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, für die Sie eine Vorschau anzeigen möchten.
  4. Sehen Sie sich die Ergebnisse der Vorschau im Bereich Abfrageergebnisse an.
    1. Zum Prüfen der Jobdetails wählen Sie den Tab Jobinformationen aus.
    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 anzusehen.
    4. Klicken Sie auf das Dreipunkt-Menü > Job in SQL-Arbeitsbereich ansehen, um den Vorschaujob im SQL-Arbeitsbereich anzusehen.

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 zur Tabellenerstellung anzusehen. Wenn Sie eine Vorschau einer Assertion-Abfrage ansehen 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 Vorschau einer Abfrage in einer Tabellendefinitionsdatei mit Assertions in einem Dataform-Arbeitsbereich an:

  1. Maximieren Sie im Bereich Dateien den Bereich definitions/.
  2. Wählen Sie die Definitionsdatei einer Tabelle mit Assertions aus.
  3. Führen Sie eine Vorschau aus:
    • Klicken Sie auf Ausführen, um eine Vorschau der Abfrage zur Tabellenerstellung anzuzeigen.
    • Um eine Assertion-Abfrage als Vorschau anzusehen, 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. Zum Prüfen der Jobdetails wählen Sie den Tab Jobinformationen aus.
    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 anzusehen.
    4. Klicken Sie auf das Dreipunkt-Menü > Job in SQL-Arbeitsbereich ansehen, um den Vorschaujob im SQL-Arbeitsbereich anzusehen.

Nächste Schritte