Gespeicherte Abfragen erstellen

In diesem Dokument wird beschrieben, wie Sie gespeicherte Abfragen und klassische gespeicherte Abfragen erstellen.

Gespeicherte Abfragen

In den folgenden Abschnitten erfahren Sie, wie Sie gespeicherte Abfragen erstellen. Gespeicherte Abfragen sind BigQuery Studio-Code-Assets, die auf Dataform basieren.

Weitere Informationen zum Löschen gespeicherter Abfragen und zum Verwalten des gespeicherten Abfrageverlaufs finden Sie unter Gespeicherte Abfragen.

BigQuery Studio aktivieren

Folgen Sie der Anleitung unter BigQuery Studio für die Asset-Verwaltung aktivieren, um Versionen von Code-Assets wie z. B. gespeicherte Abfragen zu sichern, freizugeben und zu verwalten.

Wichtig: Im März 2024 werden APIs, die BigQuery Studio-Funktionen unterstützen, automatisch für alle BigQuery-Projekte aktiviert. Weitere Informationen finden Sie unter BigQuery Studio APIs automatisch aktivieren.

Erforderliche Berechtigungen

Legen Sie die entsprechenden Berechtigungen fest, um gespeicherte Abfragen zu erstellen, zu bearbeiten oder anzuzeigen.

Alle Nutzer mit der Rolle „Dataform-Administrator“ (roles/dataform.admin) haben Inhaberzugriff auf alle gespeicherten Abfragen, die im Projekt erstellt wurden.

Weitere Informationen zu BigQuery Identity and Access Management (IAM) finden Sie unter Zugriffssteuerung mit IAM.

Berechtigungen zum Erstellen gespeicherter Abfragen

Zum Erstellen und Ausführen gespeicherter Abfragen benötigen Sie folgende IAM-Berechtigungen:

• dataform.locations.get
• dataform.locations.list
• dataform.repositories.list

• dataform.repositories.create

  Hinweis: Nutzer mit der Berechtigung dataform.repositories.create können Code mit dem Dataform-Standarddienstkonto und allen diesem Dienstkonto zugewiesenen Berechtigungen ausführen. Weitere Informationen finden Sie unter Sicherheitsaspekte für Dataform-Berechtigungen.

Sie können diese Berechtigungen über die folgenden IAM-Rollen abrufen:

• BigQuery-Jobnutzer(roles/bigquery.jobUser)
• BigQuery Read Session-Nutzer (roles/bigquery.readSessionUser)

• Code Creator (roles/dataform.codeCreator)

  Hinweis: Nutzer, denen die Rolle „Code Creator“ in einem Projekt zugewiesen ist, können die Namen von Code-Assets in diesem Projekt über die Dataform API oder die Dataform-Befehlszeile (CLI) auflisten. Nicht-Administratoren, die BigQuery Studio verwenden, sehen nur Code-Assets, die sie erstellt haben oder für sie freigegeben wurden.

Berechtigungen zum Bearbeiten gespeicherter Abfragen

Zum Bearbeiten und Ausführen von gespeicherten Abfragen benötigen Sie die folgenden IAM-Rollen:

• BigQuery-Jobnutzer(roles/bigquery.jobUser)
• BigQuery Read Session-Nutzer (roles/bigquery.readSessionUser)
• Code Editor (roles/dataform.codeEditor)

Berechtigungen zum Anzeigen gespeicherter Abfragen

Zum Aufrufen und Ausführen von gespeicherten Abfragen benötigen Sie die folgenden IAM-Rollen:

• BigQuery-Jobnutzer(roles/bigquery.jobUser)
• BigQuery Read Session-Nutzer (roles/bigquery.readSessionUser)
• Code Viewer (roles/dataform.codeViewer)

Standardregion für Code-Assets festlegen

Wenn Sie zum ersten Mal ein Code-Asset erstellen, legen Sie die Standardregion für Code-Assets fest. Sie können die Region für ein Code-Asset nicht mehr ändern, nachdem es erstellt wurde.

Hinweis: Wenn Sie eine gespeicherte Abfrage erstellen und eine andere Standardregion als diejenige auswählen, die Sie für Code-Assets verwendet haben (z. B. us-west1 bei Verwendung von us-central1), wird diese neue Region standardmäßig von dieser Abfrage und allen erstellten Code-Assets verwendet. Vorhandene Code-Assets verwenden weiterhin die Region, die bei ihnen bei Erstellung zugewiesen wurde.

Gespeicherte Abfragen erstellen

So erstellen Sie eine gespeicherte Abfrage:

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

   BigQuery aufrufen

2. Klicken Sie auf Neue Abfrage erstellen.

3. Geben Sie im Abfrageeditor eine gültige SQL-Abfrage ein. Sie können beispielsweise ein öffentliches Dataset abfragen:

   SELECT
     name,
     SUM(number) AS total
   FROM
     `bigquery-public-data.usa_names.usa_1910_2013`
   GROUP BY
     name
   ORDER BY
     total DESC
   LIMIT
     10;
   

4. Klicken Sie auf Abfrage speichern > Abfrage speichern.

5. Geben Sie im Dialogfeld Abfrage speichern einen Namen für die gespeicherte Abfrage ein.

6. Optional: Wenn Sie die Region ändern möchten, die von dieser gespeicherten Abfrage und allen anderen Code-Assets in Zukunft verwendet wird, wählen Sie unter Region eine neue Region aus.

7. Klicken Sie auf Speichern.

Zugriff auf gespeicherte Abfragen gewähren

Wenn Sie anderen Nutzern Zugriff auf eine gespeicherte Abfrage gewähren möchten, fügen Sie diese Nutzer einer entsprechenden IAM-Rolle hinzu.

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

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Abfragen und gegebenenfalls den Ordner Freigegebene Abfragen. Suchen Sie die gespeicherte Abfrage, auf die Sie Zugriff gewähren möchten.

3. Klicken Sie neben der gespeicherten Abfrage auf Aktionen ansehen und dann auf Freigeben > Berechtigungen verwalten.

4. Klicken Sie im Bereich Berechtigungen verwalten auf Nutzer/Gruppe hinzufügen.

5. Geben Sie im Feld Neue Hauptkonten ein Hauptkonto ein.

6. Wählen Sie in der Liste Rolle eine der folgenden Rollen aus:

   • Code-Inhaber: Kann alle Aktionen an der gespeicherten Abfrage ausführen, einschließlich Löschen oder Freigeben.
   • Code Editor: Kann die Abfrage bearbeiten.
   • Code Viewer: Kann die Abfrage aufrufen.
   Hinweis: Das Hauptkonto muss auch die Rolle BigQuery-Nutzer (roles/bigquery.user) haben, um die gespeicherte Abfrage auszuführen.

7. Optional: Klicken Sie auf Erweiterte Freigabe, um eine vollständige Liste der Rollen und erweiterten Freigabeeinstellungen aufzurufen.

8. Klicken Sie auf Speichern.

9. Klicken Sie auf Schließen, um zu den gespeicherten Abfrageinformationen zurückzukehren.

Gespeicherte Abfragen freigeben

Sie können eine gespeicherte Abfrage für andere Nutzer freigeben. Erstellen Sie dazu einen Link zur gespeicherten Abfrage und teilen Sie ihn. Damit Nutzer die gespeicherte Abfrage sehen können, die Sie freigeben, müssen Sie ihnen Zugriff auf die gespeicherte Abfrage gewähren.

Zum Ausführen einer freigegebenen Abfrage müssen Nutzer Zugriff auf die Daten haben, auf die die Abfrage zugreift. Weitere Informationen finden Sie unter Zugriff auf ein Dataset gewähren.

Wenn Sie eine gespeicherte Abfrage freigeben möchten, sollten Sie einen Kommentar in die Abfrage aufnehmen, der ihren Zweck beschreibt.

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

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Abfragen und maximieren Sie gegebenenfalls den Ordner Freigegebene Abfragen. Suchen Sie die gespeicherte Abfrage, die Sie freigeben möchten.

3. Klicken Sie neben der Abfrage auf Aktionen ansehen und dann auf Freigeben > Link kopieren.

4. Geben Sie den Link für andere Nutzer frei.

Gespeicherte Abfrageversion als neue Abfrage öffnen

So öffnen Sie eine beliebige Version einer vorhandenen gespeicherten Abfrage als neue Abfrage:

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

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Abfragen und gegebenenfalls den Ordner Freigegebene Abfragen. Wählen Sie eine gespeicherte Abfrage aus.

3. Wählen Sie den Bereich Aktivität aus.

4. Klicken Sie neben einer gespeicherten Abfrageversion auf Aktionen ansehen und dann auf Als neue Abfrage öffnen.

Gespeicherte Abfragen aktualisieren

Wenn Sie eine gespeicherte Abfrage aktualisieren, können Sie die Änderungen in einer neuen Version der Abfrage speichern.

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

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Abfragen und gegebenenfalls den Ordner Freigegebene Abfragen. Klicken Sie auf den Namen einer gespeicherten Abfrage, um sie zu öffnen.

3. Ändern Sie die Abfrage.

4. Klicken Sie zum Speichern der geänderten Abfrage auf Abfrage speichern > Abfrage speichern.

   Eine neue Version der Abfrage wird erstellt, die Sie im Bereich Aktivität sehen können.

Gespeicherte Abfragen hochladen

Sie können eine lokale SQL-Abfrage hochladen, um sie als gespeicherte Abfrage in BigQuery Studio zu verwenden. Die hochgeladene gespeicherte Abfrage ist dann auch auf der BigQuery-Seite der Google Cloud Console sichtbar.

So laden Sie eine gespeicherte Abfrage herunter:

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

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und führen Sie dann einen der folgenden Schritte aus:

   • Klicken Sie neben Abfragen auf Aktionen ansehen > SQL-Abfrage hochladen.
   • Klicken Sie neben dem Namen des Google Cloud-Projekts auf Aktionen ansehen > In Projekt hochladen > SQL-Abfrage.

3. Klicken Sie im Dialogfeld SQL hochladen im Feld SQL auf Durchsuchen und wählen Sie die Abfrage aus, die Sie ausführen möchten. hochladen möchten.

4. Optional: Bearbeiten Sie im Feld SQL-Name den Namen der Abfrage.

5. Wählen Sie im Feld Region die Region aus, in die Sie die gespeicherte Abfrage hochladen möchten.

6. Klicken Sie auf Hochladen.

Die gespeicherte Abfrage wird im Explorer-Bereich angezeigt.

Klassische gespeicherte Abfragen

Verworfen: Gespeicherte Abfragen, die in der BigQuery Studio-Vorschau verfügbar sind, ersetzen klassische gespeicherte Abfragen ab März 2025 vollständig. Weitere Informationen finden Sie unter Einstellung von klassischen gespeicherten Abfragen. Informationen zum Migrieren zu gespeicherten Abfragen finden Sie unter Klassische gespeicherte Abfragen migrieren.

In den folgenden Abschnitten erfahren Sie, wie Sie klassische gespeicherte Abfragen erstellen und aktualisieren. Weitere Informationen zum Freigeben, Migrieren und Löschen von klassischen gespeicherten Abfragen finden Sie unter Klassische gespeicherte Abfragen.

Hinweis: Wenn Sie BigQuery Studio nicht aktiviert haben, werden klassische gespeicherte Abfragen im Ordner Gespeicherte Abfragen (NUMBER) des Bereichs Explorer anstelle des Ordners (Klassische) Abfragen angezeigt.

Erforderliche Berechtigungen für klassische gespeicherte Abfragen

Zum Erstellen, Anzeigen, Aktualisieren und Löschen klassischer gespeicherter Abfragen sind die folgenden IAM-Berechtigungen erforderlich:

• Private klassische gespeicherte Abfragen:
  • Zum Erstellen privater klassischer gespeicherter Abfragen sind keine speziellen Berechtigungen erforderlich. Sie können eine private Abfrage in jedem beliebigen Projekt speichern. Sie kann jedoch nur von Ihnen angezeigt, aktualisiert oder gelöscht werden.
• Klassische gespeicherte Abfragen auf Projektebene:
  • Zum Erstellen einer klassischen gespeicherten Abfrage auf Projektebene ist die Berechtigung bigquery.savedqueries.create erforderlich. Die vordefinierte Rolle bigquery.admin beinhaltet die Berechtigung bigquery.savedqueries.create.
  • Zum Aufrufen einer klassischen gespeicherten Abfrage auf Projektebene sind die Berechtigungen bigquery.savedqueries.get und bigquery.savedqueries.list erforderlich. Die vordefinierten Rollen bigquery.admin und bigquery.user beinhalten die Berechtigungen bigquery.savedqueries.get und bigquery.savedqueries.list.
  • Zum Aktualisieren einer klassischen gespeicherten Abfrage auf Projektebene ist die Berechtigung bigquery.savedqueries.update erforderlich. Die vordefinierte Rolle bigquery.admin beinhaltet die Berechtigung bigquery.savedqueries.update.
  • Zum Löschen einer klassischen gespeicherten Abfrage auf Projektebene ist die Berechtigung bigquery.savedqueries.delete erforderlich. Die vordefinierte Rolle bigquery.admin beinhaltet die Berechtigung bigquery.savedqueries.delete.
• Klassische öffentliche gespeicherte Abfragen:
  • Zum Erstellen einer klassischen öffentlichen gespeicherten Abfrage sind keine speziellen Berechtigungen erforderlich. Sie können eine klassische öffentliche gespeicherte Abfrage in einem beliebigen Projekt speichern. Sie kann jedoch nur von Ihnen aktualisiert oder gelöscht werden. Klassische öffentliche gespeicherte Abfragen können von allen Nutzern angezeigt werden, die den Link haben.

Hinweise Nutzer mit der dataform.repository.list-Berechtigung auf Projektebene können alle gespeicherten Abfragen angezeigt werden, die im Projekt erstellt wurden.

Weitere Informationen zu IAM-Rollen in BigQuery finden Sie unter Vordefinierte Rollen und Berechtigungen.

Klassische gespeicherte Abfragen erstellen

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

   BigQuery aufrufen

2. Klicken Sie auf Neue Abfrage erstellen.

3. Geben Sie im Abfrageeditor eine gültige SQL-Abfrage ein. Sie können beispielsweise ein öffentliches Dataset abfragen:

   SELECT
     name,
     SUM(number) AS total
   FROM
     `bigquery-public-data.usa_names.usa_1910_2013`
   GROUP BY
     name
   ORDER BY
     total DESC
   LIMIT
     10;
   

4. Klicken Sie auf Abfrage speichern (klassisch) > Abfrage speichern (klassisch).

5. Geben Sie im Dialogfeld Abfrage speichern einen Namen für die Abfrage ein und legen Sie dann für Sichtbarkeit eine der folgenden Optionen fest:

   • Persönlich (kann nur durch Sie bearbeitet werden) für eine klassische private freigegebene Abfrage.
   • Projekt (kann von Hauptkonten mit entsprechenden Berechtigungen bearbeitet werden) für eine klassische gespeicherte Abfrage auf Projektebene.
   • Öffentlich für eine klassische öffentliche gespeicherte Abfrage.

6. Klicken Sie auf Speichern.

Klassische gespeicherte Abfragen freigeben

Sie können klassische gespeicherte Abfragen freigeben, für die Sie Projekt- oder öffentliche Sichtbarkeit gewährt haben. Durch die Projektsichtbarkeit können Hauptkonten mit den erforderlichen Berechtigungen die Abfrage aufrufen, aktualisieren oder löschen. Durch die öffentliche Sichtbarkeit kann jeder beliebige Nutzer die Abfrage über den Abfragelink aufrufen, sie jedoch nicht aktualisieren oder löschen.

Sie geben eine klassische gespeicherte Abfrage für andere Nutzer frei, indem Sie einen Link zur klassischen gespeicherten Abfrage generieren und freigeben.

Zum Ausführen einer klassischen freigegebenen Abfrage müssen Nutzer Zugriff auf die Daten haben, auf die die Abfrage zugreift. Weitere Informationen finden Sie unter Zugriff auf ein Dataset gewähren.

Wenn Sie eine klassische gespeicherte Abfrage freigeben möchten, sollten Sie einen Kommentar in die Abfrage aufnehmen, der ihren Zweck beschreibt.

1. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner (Klassische) Abfragen und suchen Sie dann die klassische gespeicherte Abfrage, die Sie freigeben möchten.
2. Klicken Sie neben der Abfrage auf Aktionen ansehen und dann auf Link abrufen.
3. Geben Sie den Link für die Nutzer frei, denen Sie Zugriff auf die Abfrage gewähren möchten.

Klassische gespeicherte Abfragen aktualisieren

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

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner (Klassische) Abfragen und gegebenenfalls den Ordner Projektabfragen.

3. Klicken Sie auf den Namen einer klassischen gespeicherten Abfrage, um sie zu öffnen.

4. Ändern Sie die Abfrage.

5. Klicken Sie zum Speichern der geänderten Abfrage auf Abfrage speichern (klassisch) > Abfrage speichern (klassisch).

Nächste Schritte

• Gespeicherte Abfragen verwalten