Gespeicherte Abfragen verwalten

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

Gespeicherte Abfragen

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

Wichtig: Im März 2024 wurden APIs, die BigQuery Studio-Funktionen unterstützen, automatisch für alle vorhandenen BigQuery-Projekte aktiviert. Für neue BigQuery-Projekte sind diese APIs standardmäßig aktiviert. Weitere Informationen finden Sie unter BigQuery Studio APIs automatisch aktivieren.

Erforderliche Berechtigungen

Zum Verwalten gespeicherter Abfragen benötigen Sie die folgenden IAM-Rollen (Identity and Access Management):

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

Weitere Informationen zu BigQuery IAM finden Sie unter Zugriffssteuerung mit IAM.

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.

Alle gespeicherten Abfragen anzeigen

So rufen Sie eine Liste aller gespeicherten Abfragen in Ihrem Projekt auf:

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

   BigQuery aufrufen

2. Klicken Sie im Bereich Explorer neben Abfragen auf Aktionen anzeigen und führen Sie einen der folgenden Schritte aus:

• Wenn Sie die Liste im aktuellen Tab öffnen möchten, klicken Sie auf Alle anzeigen.
• Wenn Sie die Liste in einem neuen Tab öffnen möchten, klicken Sie auf Alle anzeigen in > Neuer Tab.
• Wenn Sie die Liste in einem geteilten Tab öffnen möchten, klicken Sie auf Alle anzeigen in > Tab aufteilen.

Metadaten gespeicherter Abfragen ansehen

So rufen Sie gespeicherte Abfragemetadaten auf:

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 der gespeicherten Abfrage, für die Sie Metadaten aufrufen möchten.

3. Im Bereich Zusammenfassung finden Sie Informationen zur gespeicherten Abfrage, z. B. die verwendete Region und das Datum der letzten Änderung.

Mit gespeicherten Abfrageversionen arbeiten

In den folgenden Abschnitten erfahren Sie, wie Sie Versionen einer gespeicherten Abfrage aufrufen, vergleichen und wiederherstellen.

Gespeicherte Abfrageversionen aufrufen

So rufen Sie gespeicherte Abfrageversionen auf:

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 der gespeicherten Abfrage, für die Sie die Aktivitäten aufrufen möchten.

3. Klicken Sie auf den Tab Aktivität, um eine Liste der gespeicherten Abfrageversionen in absteigender Reihenfolge nach Datum aufzurufen.

Gespeicherte Abfrageversionen vergleichen

So vergleichen Sie gespeicherte Abfrageversionen:

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 der gespeicherten Abfrage, für die Sie die Versionsinformationen vergleichen möchten.

3. Klicken Sie auf dem Tab Aktivität neben einer gespeicherten Abfrageversion auf Aktionen ansehen und dann auf Vergleichen. Der Vergleichsbereich wird geöffnet. Darin wird die ausgewählte gespeicherte Abfrageversion mit der aktuell gespeicherten Abfrageversion verglichen.

4. Optional: Wenn Sie die Versionen inline und nicht in separaten Bereichen vergleichen möchten, klicken Sie auf Vergleichen und dann auf Inline.

Gespeicherte Abfrageversion wiederherstellen

Verwenden Sie eine der folgenden Optionen, um eine gespeicherte Abfrageversion wiederherzustellen. Durch die Wiederherstellung aus dem Vergleichsbereich können Sie die vorherige Version der gespeicherten Abfrage mit der aktuellen Version vergleichen, bevor Sie auswählen, ob Sie sie wiederherstellen möchten.

Aktivitätsbereich

1. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Abfragen und gegebenenfalls den Ordner Freigegebene Abfragen. Klicken Sie auf den Namen der gespeicherten Abfrage, von der Sie eine vorherige Version wiederherstellen möchten.
2. Wählen Sie den Bereich Aktivität aus.
3. Klicken Sie neben der Version des der gespeicherten Abfrage, die Sie wiederherstellen möchten, auf Aktionen ansehen und dann auf Wiederherstellen.
4. Klicken Sie auf Bestätigen, um die Aktion zu bestätigen.

Vergleichsbereich

1. Maximieren Sie im Bereich Explorer Ihr Projekt und den Ordner Abfragen und gegebenenfalls den Ordner Freigegebene Abfragen. Klicken Sie auf den Namen der gespeicherten Abfrage, von der Sie eine vorherige Version wiederherstellen möchten.
2. Wählen Sie den Bereich Aktivität aus.
3. Klicken Sie neben einer gespeicherten Abfrageversion auf Aktionen ansehen und dann auf Vergleichen. Der Vergleichsbereich wird geöffnet. Darin wird die ausgewählte gespeicherte Abfrageversion mit der zuletzt gespeicherten Abfrageversion verglichen.
4. Wenn Sie die vorherige gespeicherte Abfrageversion nach dem Vergleich wiederherstellen möchten, klicken Sie auf Wiederherstellen.
5. Klicken Sie auf Bestätigen, um die Aktion zu bestätigen.

Gespeicherte Abfragen herunterladen

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 den Ordner Abfragen und gegebenenfalls den Ordner Freigegebene Abfragen. Klicken Sie auf den Namen einer gespeicherten Abfrage, um sie zu öffnen.

3. Klicken Sie auf Herunterladen.

Gespeicherte Abfragen löschen

So löschen Sie eine gespeicherte 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. Suchen Sie die gespeicherte Abfrage, die Sie löschen möchten.

3. Klicken Sie neben der gespeicherten Abfrage auf Aktionen ansehen und dann auf Löschen.

4. Geben Sie delete in das Dialogfeld ein, um den Löschvorgang zu bestätigen.

5. Klicken Sie auf Löschen.

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

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.

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 migrieren

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. Klicken Sie auf (Klassische) Abfrage speichern > Abfrage speichern unter....

5. Geben Sie im Dialogfeld Abfrage speichern einen Namen ein und wählen Sie einen Standort für die Abfrage aus.

6. Klicken Sie auf Speichern.

Klassische gespeicherte Abfragen löschen

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. Suchen Sie die klassische gespeicherte Abfrage, die Sie löschen möchten.

4. Klicken Sie neben der Abfrage auf Aktionen ansehen und dann auf Löschen.

5. Geben Sie delete in das Dialogfeld ein, um den Löschvorgang zu bestätigen.

6. Klicken Sie auf Löschen.