SQL-Abfragen in der Vorschau ansehen

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. 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 ausführen.

Wenn Sie eine Abfrage in der Vorschau 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 auslösen, um die Tabelle in BigQuery zu veröffentlichen. Die temporäre Tabelle mit der Vorschauabfrage 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, wird in BigQuery abgerechnet. 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 Workflow ausgeführt wird, verwendet Dataform jedoch Ihre Anmeldedaten für das Dienstkonto, um Assets in BigQuery zu erstellen oder zu aktualisieren.

In Dataform werden die Ergebnisse aller Abfragen, die während der aktuellen Browser-Sitzung in der Vorschau angezeigt wurden, im Bereich Abfrageergebnisse in Ihrem Arbeitsbereich angezeigt. Im Bereich Abfrageergebnisse finden Sie die folgenden Informationen zu jeder Abfrage, die während der aktuellen Browser-Sitzung in der Vorschau angezeigt wurde:

  • Jobinformationen
    • BigQuery-Job-ID
    • Nutzer, der die Vorschau ausführt
    • Speicherort, an dem der Job ausgeführt wird, aus der Datei mit den Workfloweinstellungen
    • Erstellungs-, Start- und Endzeit 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 die Quelldatei jeder abgefragten Abfrage aufrufen und BigQuery Studio aufrufen, um sich den Vorschaujob anzusehen.

Hinweis

  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 neues.

  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 für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ansehen von Abfragevorschauen benötigen:

  • Dataform-Bearbeiter (roles/dataform.editor) – Arbeitsbereiche
  • BigQuery-Jobnutzer (roles/bigquery.jobUser) für 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 anzeigen

Wenn Sie sich die Abfrageergebnisse in Dataform vor der Ausführung ansehen möchten, führen Sie eine Vorschau der 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 ansehen.

Bei Tabellen mit Behauptungen funktioniert die Vorschau etwas anders. Weitere Informationen finden Sie unter Vorschau einer Tabelle mit Behauptungen.

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

  1. Maximieren Sie im Bereich Dateien 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 lassen möchten.
  4. Die Ergebnisse der Vorschau finden Sie im Bereich Abfrageergebnisse.
    1. Wählen Sie den Tab Jobinformationen aus, um die Jobdetails zu prüfen.
    2. Wählen Sie den Tab Ergebnisse aus, um die Abfrageergebnisse zu prüfen.
    3. Wenn Sie die JSON-Ausgabe der Abfrage aufrufen möchten, wählen Sie den Tab JSON aus.
    4. Wenn Sie sich die Vorschau im SQL-Arbeitsbereich ansehen möchten, klicken Sie auf das Dreipunkt-Menü  > Mehr > Job im SQL-Arbeitsbereich ansehen.

Vorschau einer Tabelle mit Behauptungen

In einer SQLX-Tabellendefinitionsdatei mit Behauptungen können Sie eine Vorschau der Abfrage zum Erstellen der Tabelle und der definierten Behauptungsabfragen aufrufen.

Dataform behandelt die Abfrage der Tabellendefinition als Standardabfrage. Wenn Sie eine Vorschau der Abfrage zum Erstellen der Tabelle aufrufen möchten, klicken Sie in Ihrem Arbeitsbereich auf Ausführen. Wenn Sie eine Vorschau einer Bestätigungsabfrage aufrufen 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 Behauptungen in einem Dataform-Arbeitsbereich auf:

  1. Maximieren Sie im Bereich Dateien definitions/.
  2. Wählen Sie eine Definitionsdatei einer Tabelle mit Behauptungen aus.
  3. Vorschau ansehen:
    • Klicken Sie auf Ausführen, um eine Vorschau der Abfrage zum Erstellen der Tabelle aufzurufen.
    • Wenn Sie eine Vorschau einer Bestätigungsabfrage aufrufen möchten, klicken Sie auf das Drop-down-Symbol neben Ausführen und wählen Sie die Abfrage aus, für die Sie eine Vorschau aufrufen möchten.
  4. Die Ergebnisse der Vorschau finden Sie im Bereich Abfrageergebnisse.
    1. Wählen Sie den Tab Jobinformationen aus, um die Jobdetails zu prüfen.
    2. Wählen Sie den Tab Ergebnisse aus, um die Abfrageergebnisse zu prüfen.
    3. Wenn Sie die JSON-Ausgabe der Abfrage aufrufen möchten, wählen Sie den Tab JSON aus.
    4. Wenn Sie sich die Vorschau im SQL-Arbeitsbereich ansehen möchten, klicken Sie auf das Dreipunkt-Menü  > Mehr > Job im SQL-Arbeitsbereich ansehen.

Nächste Schritte