SQL-Abfragen in der Vorschau ansehen

In diesem Dokument wird beschrieben, wie Sie die Ausgabe einer SQL-Abfrage in einem Dataform-Arbeitsbereich in der 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, wird die Abfrage in Dataform in Echtzeit in SQL kompiliert. Wenn Sie die Ausgabe der kompilierten SQL-Abfrage testen möchten, bevor Sie sie in BigQuery ausführen, können Sie eine Vorschau der Abfrage in Ihrem Dataform-Arbeitsbereich erstellen.

Wenn Sie eine Vorschau einer Abfrage ausführen, wird in Dataform ein Job in BigQuery ausgeführt, 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 auslösen, um die Tabelle in BigQuery zu veröffentlichen. Die temporäre Tabelle mit der Vorschau der Abfrage wird nach bis zu 24 Stunden automatisch gelöscht. Weitere Informationen zu BigQuery-Jobs finden Sie unter Jobs verwalten.

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

Bei der Vorschau von Abfragen 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.

In Dataform werden die Ergebnisse aller Abfragen, die während der aktuellen Browsersitzung in der Vorschau angezeigt wurden, im Bereich Abfrageergebnisse in Ihrem Arbeitsbereich angezeigt. Im Bereich Abfrageergebnisse können Sie sich die folgenden Informationen zu jeder Abfrage ansehen, die in 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, aus der Workflow-Einstellungsdatei
    • 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

Außerdem können Sie im Bereich Abfrageergebnisse zur Quelldatei jeder in der Vorschau angezeigten Abfrage und zu BigQuery Studio navigieren, um den Vorschaujob aufzurufen.

Hinweise

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

    Zur Dataform-Seite

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

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

  4. Erstellen Sie eine SQL-Abfrage, z. B. create a table (Tabelle erstellen).

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Vorschauen von Abfragen benötigen:

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

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

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

Vorschau einer Abfrage ansehen

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

Die Vorschau für Tabellen mit Behauptungen wird etwas anders ausgeführt. Weitere Informationen finden Sie unter Tabelle mit Zusicherungen in der Vorschau ansehen.

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

  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 in der 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 aufzurufen.
    2. Wenn Sie die Abfrageergebnisse prüfen möchten, wählen Sie den Tab Ergebnisse aus.
    3. Wenn Sie die JSON-Ausgabe der Abfrage aufrufen möchten, wählen Sie den Tab JSON aus.
    4. Wenn Sie den Vorschaujob im SQL-Arbeitsbereich ansehen möchten, klicken Sie auf das Menü  Mehr > Job im SQL-Arbeitsbereich ansehen.

Vorschau einer Tabelle mit Behauptungen ansehen

In einer SQLX-Tabellendefinitionsdatei mit Zusicherungen können Sie sich eine Vorschau der Abfrage zum Erstellen der Tabelle und der definierten Zusicherungsabfragen ansehen.

Dataform behandelt die Tabellendefinitionsabfrage als Standardabfrage. Wenn Sie eine Vorschau der Abfrage zur Tabellenerstellung aufrufen möchten, klicken Sie in Ihrem Arbeitsbereich auf Ausführen. Wenn Sie sich eine Vorschau einer Assertionsabfrage 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 ansehen.

So rufen Sie eine Vorschau einer Abfrage in einer Tabellendefinitionsdatei mit Zusicherungen in einem Dataform-Arbeitsbereich auf:

  1. Maximieren Sie im Bereich Dateien die Option definitions/.
  2. Wählen Sie eine Definitionsdatei einer Tabelle mit Zusicherungen aus.
  3. Vorschau ansehen:
    • Wenn Sie eine Vorschau der Abfrage zum Erstellen der Tabelle sehen möchten, klicken Sie auf Ausführen.
    • Wenn Sie sich eine Vorschau einer Assertionsabfrage ansehen möchten, klicken Sie neben Ausführen auf das Drop-down-Symbol und wählen Sie die gewünschte Abfrage aus.
  4. Sehen Sie sich die Ergebnisse der Vorschau im Bereich Abfrageergebnisse an.
    1. Wählen Sie den Tab Jobinformationen aus, um die Jobdetails aufzurufen.
    2. Wenn Sie die Abfrageergebnisse prüfen möchten, wählen Sie den Tab Ergebnisse aus.
    3. Wenn Sie die JSON-Ausgabe der Abfrage aufrufen möchten, wählen Sie den Tab JSON aus.
    4. Wenn Sie den Vorschaujob im SQL-Arbeitsbereich ansehen möchten, klicken Sie auf das Menü  > Mehr > Job im SQL-Arbeitsbereich ansehen.

Nächste Schritte