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, kompiliert Dataform die Abfrage in Echtzeit in SQL. Um die Ausgabe der kompilierten SQL-Abfrage zu testen, bevor Sie sie in BigQuery ausführen, können Sie sich die Abfrage in Ihrem Dataform-Arbeitsbereich in der Vorschau ansehen.

Wenn Sie sich eine Abfrage in der Vorschau ansehen, 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 in der Vorschau angezeigten Abfrage wird nach maximal 24 Stunden automatisch gelöscht. Weitere Informationen zu BigQuery-Jobs finden Sie unter Jobs verwalten.

Für die Ausführung der Abfragevorschau in Dataform fallen in BigQuery Kosten an. Weitere Informationen zu den Preisen von BigQuery finden Sie unter BigQuery-Preise.

Während der Abfragevorschau verwendet Dataform die Nutzeranmeldedaten Ihres Google-Kontos, um Jobs in BigQuery auszuführen. Bei der Workflowausführung im strengen Modus „Als Nutzer ausführen“ muss Dataform ein benutzerdefiniertes Dienstkonto oder die Nutzeranmeldedaten eines Google-Kontos verwenden, um Assets in BigQuery zu erstellen oder zu aktualisieren.

Dataform zeigt die Ergebnisse aller Abfragen, die während der aktuellen Browsersitzung in der Vorschau angezeigt wurden, im Bereich Abfrageergebnisse in Ihrem Arbeitsbereich an. Im Bereich Abfrageergebnisse können Sie die folgenden Informationen zu jeder Abfrage sehen, 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, 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 zur Quelldatei jeder in der Vorschau angezeigten Abfrage und zu BigQuery Studio navigieren, um den Vorschaujob anzusehen.

Hinweis

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

    Zu Dataform

  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. eine Tabelle.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Anzeigen von Abfragen in der Vorschau benötigen:

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.

Abfrage in der Vorschau ansehen

Wenn Sie die Abfrageergebnisse in Dataform vor der Ausführung prüfen möchten, führen Sie eine Vorschau der Abfrage in Ihrem Arbeitsbereich aus. Wenn die Datei, die Sie bearbeiten, 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 Ausführung einer Vorschau unterscheidet sich leicht für Tabellen mit Zusicherungen. Weitere Informationen finden Sie unter Tabelle mit Zusicherungen in der Vorschau ansehen.

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

  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 Menü die Abfrage aus, die Sie in der Vorschau ansehen möchten.

  4. Prüfen Sie die Ergebnisse der Vorschau 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. Wählen Sie den Tab JSON aus, um die JSON-Ausgabe der Abfrage aufzurufen.
    4. Wenn Sie den Vorschaujob im SQL-Arbeitsbereich ansehen möchten, klicken Sie auf das Mehr Menü > Job im SQL-Arbeitsbereich ansehen.

Tabelle mit Zusicherungen in der Vorschau ansehen

In einer SQLX-Tabellendefinitionsdatei mit Zusicherungen können Sie sich die Abfrage zur Tabellenerstellung und die definierten Zusicherungsabfragen in der Vorschau ansehen.

Dataform behandelt die Tabellendefinitionsabfrage als Standardabfrage. Wenn Sie sich die Abfrage zur Tabellenerstellung in der Vorschau ansehen möchten, klicken Sie in Ihrem Arbeitsbereich auf Ausführen. Wenn Sie sich eine Zusicherungsabfrage in der Vorschau ansehen möchten, wählen Sie sie im Menü neben der Schaltfläche Ausführen aus. Sie können jeweils nur eine Abfrage in der Vorschau ansehen.

So sehen Sie sich eine Abfrage in einer Tabellendefinitionsdatei mit Zusicherungen in einem Dataform-Arbeitsbereich in der Vorschau an:

  1. Maximieren Sie im Bereich Dateien die Option definitions/.
  2. Wählen Sie eine Definitionsdatei einer Tabelle mit Zusicherungen aus.
  3. Führen Sie eine Vorschau aus:
    • Wenn Sie sich die Abfrage zur Tabellenerstellung in der Vorschau ansehen möchten, klicken Sie auf Ausführen.
    • Wenn Sie sich eine Zusicherungsabfrage in der Vorschau ansehen möchten, klicken Sie auf das Drop-down-Symbol neben Ausführen und wählen Sie dann die Abfrage aus, die Sie in der Vorschau ansehen möchten.
  4. Prüfen Sie die Ergebnisse der Vorschau 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. Wählen Sie den Tab JSON aus, um die JSON-Ausgabe der Abfrage aufzurufen.
    4. Wenn Sie den Vorschaujob im SQL-Arbeitsbereich ansehen möchten, klicken Sie auf das Mehr Menü > Job im SQL-Arbeitsbereich ansehen.

Nächste Schritte