Abfrageergebnisse in eine Datei exportieren

In diesem Dokument wird beschrieben, wie Abfrageergebnisse als Datei wie CSV oder JSON gespeichert werden.

Abfrageergebnisse in eine lokale Datei herunterladen

Das Herunterladen von Abfrageergebnissen in eine lokale Datei wird vom bq-Befehlszeilentool und der API nicht unterstützt.

Verwenden Sie dieGoogle Cloud Console, um Abfrageergebnisse als CSV- oder durch Zeilenumbruch getrennte JSON-Datei herunterzuladen:

  1. Öffnen Sie in der Google Cloud Console die Seite „BigQuery“.

    BigQuery aufrufen

  2. Klicken Sie auf SQL-Abfrage.

  3. Geben Sie im Textbereich des Abfrageeditors eine gültige GoogleSQL-Abfrage ein.

  4. Optional: Klicken Sie auf Mehr und wählen Sie Abfrageeinstellungen aus, um den Verarbeitungsstandort zu ändern. Wählen Sie unter Speicherort der Daten den Standort Ihrer Daten aus.

  5. Klicken Sie auf Ausführen.

  6. Wenn die Ergebnisse zurückgegeben werden, klicken Sie auf Ergebnisse speichern und wählen Sie das Format oder den Ort zum Speichern der Ergebnisse aus.

    Die Datei wird in das Standard-Downloadverzeichnis Ihres Browsers heruntergeladen.

Abfrageergebnisse in Google Drive speichern

Das Speichern von Abfrageergebnissen in Google Drive wird vom bq-Befehlszeilentool und der API nicht unterstützt.

Möglicherweise erhalten Sie eine Fehlermeldung, wenn Sie versuchen, die BigQuery-Ergebnisse in Google Drive zu speichern. Dieser Fehler tritt auf, weil die Drive SDK API nicht auf Google Workspace zugreifen kann. Um das Problem zu beheben, müssen Sie Ihr Nutzerkonto für den Zugriff auf Google Drive über die Drive SDK API aktivieren.

Verwenden Sie die Google Cloud Console, um Abfrageergebnisse in Google Drive zu speichern:

  1. Öffnen Sie in der Google Cloud Console die Seite „BigQuery“.

    BigQuery aufrufen

  2. Klicken Sie auf SQL-Abfrage.

  3. Geben Sie im Textbereich des Abfrageeditors eine gültige GoogleSQL-Abfrage ein.

  4. Klicken Sie auf Ausführen.

  5. Wenn die Ergebnisse zurückgegeben werden, klicken Sie auf Ergebnisse speichern.

  6. Wählen Sie unter Google Drive die Option CSV oder JSON aus. Wenn Sie Ergebnisse in Google Drive speichern, können Sie den Speicherort nicht auswählen. Die Ergebnisse werden immer im Stammverzeichnis „Meine Ablage“ gespeichert.

  7. Es kann einige Minuten dauern, bis die Ergebnisse in Google Drive gespeichert sind. Wenn die Ergebnisse gespeichert sind, erhalten Sie eine Dialogfeldmeldung mit dem Dateinamen bq-results-[TIMESTAMP]-[RANDOM_CHARACTERS].[CSV or JSON].

    Schaltfläche zum Speichern der Ergebnisse

  8. Klicken Sie im Dialogfeld auf Öffnen, um die Datei zu öffnen, oder wechseln Sie zu Google Drive und klicken Sie auf Meine Ablage.

Abfrageergebnisse in Google Sheets speichern

Das Speichern von Abfrageergebnissen in Google Sheets wird vom bq-Befehlszeilentool und der API nicht unterstützt.

Sie erhalten möglicherweise eine Fehlermeldung, wenn Sie versuchen, die BigQuery-Ergebnisse aus Google Sheets zu öffnen. Dieser Fehler tritt auf, weil die Drive SDK API nicht auf Google Workspace zugreifen kann. Um das Problem zu beheben, müssen Sie Ihr Nutzerkonto für den Zugriff auf Google Sheets über die Drive SDK API aktivieren.

Verwenden Sie die Google Cloud Console, um Abfrageergebnisse in Google Sheets zu speichern:

  1. Öffnen Sie in der Google Cloud Console die Seite „BigQuery“.

    BigQuery aufrufen

  2. Klicken Sie auf SQL-Abfrage.

  3. Geben Sie im Textbereich des Abfrageeditors eine gültige GoogleSQL-Abfrage ein.

  4. Optional: Klicken Sie auf Mehr und wählen Sie Abfrageeinstellungen aus, um den Verarbeitungsstandort zu ändern. Wählen Sie unter Speicherort der Daten den Standort Ihrer Daten aus.

  5. Klicken Sie auf Ausführen.

  6. Wenn die Ergebnisse zurückgegeben werden, klicken Sie auf Save results (Ergebnisse speichern) und wählen Sie Google Sheets (Google Sheets) aus.

  7. Wenn Sie dazu aufgefordert werden, melden Sie sich bei Ihrem Google-Konto an und klicken Sie auf Zulassen, um BigQuery die Berechtigung zu erteilen, die Daten in den Ordner MY Drive in Google Drive zu schreiben.

    Nachdem Sie den Aufforderungen gefolgt sind, erhalten Sie eine E-Mail, in der bestätigt wird, dass BigQuery-Clienttools mit Ihrem Nutzerkonto verknüpft wurden. Die E-Mail enthält Informationen zu den von Ihnen erteilten Berechtigungen sowie eine Anleitung zum Entziehen der Berechtigungen.

  8. Wenn die Ergebnisse gespeichert wurden, wird unter den Abfrageergebnissen in der Google Cloud Console eine Meldung angezeigt, die in etwa so aussieht: Saved to Sheets as "results-20190225-103531. Open. Klicken Sie in der Meldung auf den Link, um die Ergebnisse in Google Sheets anzuzeigen, oder rufen Sie den Ordner My Drive auf und öffnen Sie die Datei manuell.

    Wenn Sie Abfrageergebnisse in Google Sheets speichern, beginnt der Dateiname mit results-[DATE], wobei [DATE] das aktuelle Datum im Format YYYYMMDD ist.

Fehler beim Speichern von Ergebnissen in Google Sheets beheben

Beim Speichern von Daten aus BigQuery in Google Sheets bemerken Sie möglicherweise einige leere Zellen in den Tabellen. Dies ist der Fall, wenn die Daten, die Sie in die Zelle schreiben, das Google Sheets-Limit von 50.000 Zeichen überschreiten. Verwenden Sie zur Behebung dieses Problems eine Stringfunktion in der SQL-Abfrage, um die Spalte mit den langen Daten in zwei oder mehr Spalten aufzuteilen und das Ergebnis anschließend wieder in Tabellen zu speichern.

Abfrageergebnisse in Cloud Storage speichern

So exportieren Sie Ihre Abfrageergebnisse in der Google Cloud Console nach Cloud Storage:

  1. Öffnen Sie in der Google Cloud Console die Seite „BigQuery“.

    Zur Seite "BigQuery"

  2. Klicken Sie auf SQL-Abfrage.

  3. Geben Sie im Textbereich des Abfrageeditors eine gültige GoogleSQL-Abfrage ein.

  4. Klicken Sie auf Ausführen.

  5. Wenn die Ergebnisse zurückgegeben werden, klicken Sie auf Ergebnisse speichern > Cloud Storage.

  6. Gehen Sie im Dialogfeld Nach Google Cloud Storage exportieren folgendermaßen vor:

    • Wählen Sie unter GCS-Speicherort den Bucket, den Ordner oder die Datei aus, in den bzw. die Sie die Daten exportieren möchten.
    • Wählen Sie unter Exportformat das Format für die exportierten Daten aus: CSV, JSON (durch Zeilenumbruch getrennt), Avro oder Parquet.
    • Wählen Sie unter Komprimierung ein Komprimierungsformat aus oder wählen Sie None für keine Komprimierung aus.
  7. Klicken Sie auf Speichern, um die Abfrageergebnisse zu exportieren.

Wenn Sie den Fortschritt des Jobs prüfen möchten, maximieren Sie den Bereich Jobverlauf und suchen Sie nach dem Job mit dem Typ EXTRACT.

Nächste Schritte