Vorschau von SQL-Abfragen anzeigen

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 Abfragevorschau innerhalb von 24 Stunden 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-Ausführung verwendet Dataform jedoch Ihre Dienstkonto-Anmeldedaten, um Assets in BigQuery

Dataform zeigt die Ergebnisse aller Abfragen, die während der aktuellen Browsersitzung im Bereich Abfrageergebnisse in Ihrem Arbeitsbereich. Geben Sie im Feld Query Ergebnisse können Sie die folgenden Informationen zu jeder Abfrage aufrufen, in der aktuellen Browsersitzung als Vorschau angezeigt:

  • Jobinformationen <ph type="x-smartling-placeholder">
      </ph>
    • BigQuery-Job-ID
    • Nutzer, der die Vorschau ausführt
    • Standort, an dem der Job ausgeführt wird, übernommen von Ihrem Datei mit Workflow-Einstellungen
    • 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 des und rufen Sie BigQuery Studio auf, um die Vorschau Job.

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. Beispiel: Definieren Sie ein Tabelle.

Erforderliche Rollen

Um die Berechtigungen zu erhalten, die Sie für die Vorschau von Abfragen benötigen, bitten Sie Ihren Administrator, Ihnen folgende IAM-Rollen für Ihr Projekt:

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

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff 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. Enthält die aktuell bearbeitete Datei mehrere Abfragen, 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 zeigen Sie eine Vorschau einer SQL-Abfrage und Abfrageergebnisse in einem Dataform-Objekt an: zu öffnen, gehen Sie so vor:

  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 Option die Sie sich in der 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. Um den Vorschaujob im SQL-Arbeitsbereich anzusehen, klicken Sie auf das Menü Mehr > Job im SQL-Arbeitsbereich ansehen.

Vorschau einer Tabelle mit Assertions ansehen

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

Dataform behandelt die Tabellendefinitionsabfrage als Standardabfrage. Bis Sehen Sie sich eine Vorschau der Abfrage zur Tabellenerstellung an und klicken Sie im 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 können Sie eine Vorschau einer Abfrage in einer Tabellendefinitionsdatei mit Assertions in einem Dataform-Arbeitsbereich:

  1. Maximieren Sie im Bereich Dateien den Bereich definitions/.
  2. Wählen Sie die Definitionsdatei einer Tabelle mit Assertions aus.
  3. Vorschau anzeigen: <ph type="x-smartling-placeholder">
      </ph>
    • Klicken Sie auf Ausführen, um eine Vorschau der Abfrage zur Tabellenerstellung anzuzeigen.
    • 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, 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. Um den Vorschaujob im SQL-Arbeitsbereich anzusehen, klicken Sie auf das Menü Mehr > Job im SQL-Arbeitsbereich ansehen.

Nächste Schritte