SQL-Abfragen in der Vorschau ansehen

In diesem Dokument erfahren Sie, wie Sie eine Vorschau der Ausgabe einer SQL-Abfrage in einer Dataform-Arbeitsbereich, bevor Sie die Abfrage an BigQuery ausführen.

Abfragevorschau in Dataform

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

Wenn Sie die Vorschau einer Abfrage aufrufen, führt Dataform einen Job in BigQuery zum Ausführen der kompilierten Abfrage an einem temporären Ziel und Abfrageergebnisse in Ihrem Arbeitsbereich anzeigen. Sie können sich die Ausgabe bevor Sie die Ausführung zum Veröffentlichen der Tabelle BigQuery Die temporäre Tabelle mit der Vorschauabfrage wird innerhalb von 24 Stunden automatisch gelöscht. Weitere Informationen zu BigQuery-Jobs Siehe 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 auszuführen in BigQuery. 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

Darüber hinaus können Sie im Bereich Abfrageergebnisse zur Quelldatei des und rufen Sie BigQuery Studio auf, um die Vorschau Job.

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

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

  4. Erstellen Sie eine SQL-Abfrage. Beispiel: Definieren Sie ein 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

Um Abfrageergebnisse vor der Ausführung in Dataform zu überprüfen, führen Sie die Vorschau eines Abfrage in Ihrem Arbeitsbereich. 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 Weitere Informationen finden Sie unter Tabelle mit Assertions als Vorschau ansehen.

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 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 lassen 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 prü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 anzusehen.
    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 Assertions können Sie die Tabelle als Vorschau ansehen und die definierten Assertion-Abfragen.

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. So rufen Sie eine Vorschau auf Assertion-Abfrage ausführen, müssen Sie sie in einem Drop-down-Menü neben der Ausführen. Sie können jeweils nur eine Abfrage in der Vorschau anzeigen.

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

  1. Maximieren Sie im Bereich Dateien den Bereich definitions/.
  2. Wählen Sie eine Definitionsdatei einer Tabelle mit Behauptungen aus.
  3. Vorschau anzeigen:
    • Klicken Sie auf Ausführen, um eine Vorschau der Abfrage zum Erstellen der Tabelle aufzurufen.
    • Wenn Sie eine Vorschau einer Assertion-Abfrage ansehen möchten, klicken Sie auf das Drop-down-Symbol neben Ausführen und wählen Sie dann 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 prü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 anzusehen.
    4. Um den Vorschaujob im SQL-Arbeitsbereich anzusehen, klicken Sie auf das Menü Mehr > Job im SQL-Arbeitsbereich ansehen.

Nächste Schritte