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.

Hinweise

So verwalten Sie gespeicherte BigQuery Studio-Abfragen und migrieren klassische gespeicherte Abfragen zu gespeicherten BigQuery Studio-Abfragen:

1. Aktivieren Sie BigQuery Studio in Ihrem Projekt.

2. Optional: Wenn Sie während der Migration (Vorschau) IAM-Berechtigungen für migrierte öffentliche oder gespeicherte klassische Abfragen auf Projektebene festlegen möchten, erstellen Sie eine gespeicherte BigQuery Studio-Abfrage oder wählen Sie eine aus und gewähren Sie dieser gespeicherten Abfrage die ausgewählten IAM-Berechtigungen.

   1. Wählen Sie bei der Migration klassischer gespeicherter Abfragen für öffentliche oder Projektkonten zu gespeicherten BigQuery Studio-Abfragen eine gespeicherte BigQuery Studio-Abfrage aus, um die zugehörigen Berechtigungen in die migrierten gespeicherten Abfragen zu kopieren.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, für das Sie gespeicherte Abfragen verwalten möchten, um die erforderlichen Berechtigungen dafür zu erhalten:

• So verwalten Sie in der Google Cloud Console gespeicherte BigQuery Studio-Abfragen:
  • BigQuery Jobnutzer (roles/bigquery.jobUser)
  • BigQuery Read Session-Nutzer ()roles/bigquery.readSessionUser
  • Code-Inhaber (roles/dataform.codeOwner)
• So verwalten Sie gespeicherte Abfragen in BigQuery Studio mit der BigQuery API: Code-Inhaber (roles/dataform.codeOwner)
• So migrieren Sie klassische gespeicherte Abfragen eines Projekts zu gespeicherten BigQuery Studio-Abfragen:
  • BigQuery Studio Admin (roles/bigquery.studioAdmin)
  • Projekt-IAM-Administrator (roles/resourcemanager.projectIamAdmin)
• So können authentifizierte Nutzer Abfragen mit öffentlichem Zugriff aufrufen: Code Viewer (roles/dataform.codeViewer)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Verwalten gespeicherter Abfragen erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um gespeicherte Abfragen zu verwalten:

• So verwalten Sie in der Google Cloud Console gespeicherte BigQuery Studio-Abfragen: bigquery.config.get, bigquery.jobs.create, dataform.locations., resourcemanager.projects.get, resourcemanager.projects.list, bigquery.readsessions., dataform.repositories., dataform.workspaces.
• So verwalten Sie mit der BigQuery API gespeicherte Abfragen in BigQuery Studio: dataform.locations., dataform.repositories., dataform.workspaces.*, resourcemanager.projects.get, resourcemanager.projects.list
• So migrieren Sie klassische gespeicherte Abfragen eines Projekts zu gespeicherten BigQuery Studio-Abfragen: bigquery.savedqueries.get, bigquery.savedqueries.list, bigquery.savedqueries.update, resourcemanager.projects.setIamPolicy
• So können authentifizierte Nutzer Abfragen mit öffentlichem Zugriff aufrufen: dataform.locations.*, dataform.repositories.computeAccessTokenStatus, dataform.repositories.fetchHistory, dataform.repositories.fetchRemoteBranches, dataform.repositories.get, dataform.repositories.getIamPolicy, dataform.repositories.list, dataform.repositories.queryDirectoryContents, dataform.repositories.readFile, dataform.workspaces.fetchFileDiff, dataform.workspaces.fetchFileGitStatuses, dataform.workspaces.fetchGitAheadBehind. dataform.workspaces.get, dataform.workspaces.getIamPolicy, dataform.workspaces.list, dataform.workspaces.queryDirectoryContents, dataform.workspaces.readFile, dataform.workspaces.searchFiles, resourcemanager.projects.get, resourcemanager.projects.list

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

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.

Öffentlichen Zugriff auf eine gespeicherte Abfrage gewähren

Sie können öffentlichen Zugriff auf eine gespeicherte BigQuery Studio-Abfrage gewähren, indem Sie dem Hauptkonto allAuthenticatedUsers die Rolle „Code Viewer“ (roles/dataform.codeViewer) für die gespeicherte Abfrage zuweisen.

Wenn Sie dem allAuthenticatedUsers-Principal eine IAM-Rolle zuweisen, wird diese Rolle Dienstkonten und allen Nutzern im Internet gewährt, die sich mit einem Google-Konto authentifiziert haben. Dies schließt auch Konten ein, die nicht mit einem Google Workspace-Konto oder einer Cloud Identity-Domain verbunden sind, z. B. persönliche Gmail-Konten. Nicht authentifizierte Nutzer, wie anonyme Besucher, sind nicht eingeschlossen. Weitere Informationen finden Sie unter Alle authentifizierten Nutzer.

Wenn Sie beispielsweise allAuthenticatedUsers die Rolle „Code Viewer“ für die gespeicherte Abfrage sales zuweisen, haben alle Dienstkonten und Nutzer im Internet, die sich mit einem Google-Konto authentifiziert haben, Lesezugriff auf die gespeicherte Abfrage sales.

Achtung: Wenn Sie allAuthenticatedUsers Berechtigungen auf Administrator-, Bearbeitungs- oder Ausführungsebene gewähren, können böswillige Akteure auf Ihre Daten zugreifen. Gewähren Sie nur die minimal erforderlichen Berechtigungen.

So gewähren Sie öffentlichen Zugriff auf eine gespeicherte Abfrage in BigQuery Studio:

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 öffentlichen 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 allAuthenticatedUsers ein.

6. Wählen Sie in der Liste Rolle die Rolle Code Viewer aus.

7. Klicken Sie auf Speichern.

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

Öffentlichen Zugriff auf gespeicherte Abfragen verhindern

Damit keine öffentlichen Zugriffe auf gespeicherte Abfragen in BigQuery Studio gewährt werden, beschränken Sie die allAuthenticatedUsers-Principal in Ihrem Projekt.

Wenn Sie allAuthenticatedUsers in Ihrem Projekt einschränken möchten, können Sie die iam.allowedPolicyMemberDomains-Richtlinie festlegen und allAuthenticatedUsers aus der Liste der allowed_values entfernen.

Wenn Sie allAuthenticatedUsers in der iam.allowedPolicyMemberDomains-Richtlinie einschränken, kann das allAuthenticatedUsers-Principal in keiner IAM-Richtlinie in Ihrem Projekt verwendet werden. Dadurch wird verhindert, dass allen Ressourcen, einschließlich gespeicherter Abfragen in BigQuery Studio, öffentlicher Zugriff gewährt wird.

Weitere Informationen zur iam.allowedPolicyMemberDomains-Richtlinie und eine Anleitung zum Festlegen finden Sie unter Identitäten nach Domain einschränken.

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 ansehen

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 aktuellen gespeicherten Abfrageversion verglichen.

4. Optional: Die aktuelle Version der gespeicherten Abfrage enthält auch nicht gespeicherte Änderungen. Klicken Sie auf Überschreiben, um die Änderungen zu speichern.

5. 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 Abfrage als gespeicherte 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 (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 migrieren

Vorschau: Diese Funktion befindet sich in der Vorschau für Projekte mit weniger als 2.500 klassisch gespeicherten Abfragen.

Dieses Produkt oder Feature unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt "Allgemeine Dienstbedingungen" der Dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und ‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Markteinführungsphase.

Wenn Sie Support anfordern oder Feedback zu dieser Funktion geben möchten, senden Sie eine E-Mail an [e-mail].

Wenn Sie klassische gespeicherte Abfragen im Batch migrieren möchten, müssen Sie die erforderlichen Berechtigungen haben. Diese Berechtigungen bestimmen, welche Art von klassischen gespeicherten Abfragen Sie migrieren können.

Sie können die folgenden klassischen gespeicherten Abfragen im Batch migrieren:

Persönliche klassische gespeicherte Abfragen

Private, klassisch gespeicherte Abfragen sind nur für den Nutzer sichtbar, der sie erstellt hat. Sie sind durch das Symbol gekennzeichnet. Private, klassisch gespeicherte Abfragen können nur von ihren Inhabern migriert werden. Administratoren und Nutzer, die Zugriff auf die migrierten gespeicherten BigQuery Studio-Abfragen erhalten haben, können möglicherweise auf gespeicherte persönliche Abfragen zugreifen, sie ändern oder löschen.

Klassische öffentliche gespeicherte Abfragen:

Öffentliche, klassisch gespeicherte Abfragen sind über den Abfragelink für alle Nutzer sichtbar. Sie sind durch das Symbol gekennzeichnet. Klassische öffentliche gespeicherte Abfragen können nur von ihren Inhabern migriert werden.

IAM-Berechtigungen für öffentliche klassische gespeicherte Abfragen werden nicht auf Berechtigungen für in BigQuery Studio gespeicherte Abfragen angewendet. Das bedeutet, dass gespeicherte Abfragen in BigQuery Studio, die aus öffentlichen klassischen gespeicherten Abfragen migriert wurden, standardmäßig nicht öffentlich verfügbar sind. Sie müssen IAM-Berechtigungen für migrierte gespeicherte BigQuery Studio-Abfragen entweder während oder nach der Migration festlegen.

Wenn Sie während der Migration IAM-Berechtigungen für die migrierten gespeicherten BigQuery Studio-Abfragen festlegen möchten, können Sie eine vorhandene gespeicherte BigQuery Studio-Abfrage mit Berechtigungen auswählen, die Sie auf die migrierten gespeicherten Abfragen anwenden möchten. In BigQuery werden die für die ausgewählte gespeicherte BigQuery Studio-Abfrage gewährten Berechtigungen kopiert und auf die migrierten gespeicherten Abfragen angewendet. Sie können auch Nutzer oder Gruppen manuell hinzufügen, für die Sie die migrierten gespeicherten Abfragen freigeben möchten.

Wenn Sie während der Migration keine IAM-Berechtigungen festlegen, haben nur Sie Zugriff auf die migrierten gespeicherten BigQuery Studio-Abfragen.

Klassische gespeicherte Abfragen in Projekte einfügen

Auf Projektebene gespeicherte Abfragen sind für Hauptkonten sichtbar, die die erforderlichen Berechtigungen haben. Sie sind durch das Symbol gekennzeichnet. Sie können alle klassischen gespeicherten Abfragen in Ihrem Projekt im Batch migrieren.

IAM-Berechtigungen für gespeicherte Abfragen im klassischen Projekttyp werden nicht direkt auf Berechtigungen für gespeicherte Abfragen in BigQuery Studio angewendet. Sie müssen IAM-Berechtigungen für migrierte gespeicherte BigQuery Studio-Abfragen entweder während oder nach der Migration festlegen.

Wenn Sie während der Migration IAM-Berechtigungen für die migrierten gespeicherten BigQuery Studio-Abfragen festlegen möchten, können Sie eine vorhandene gespeicherte BigQuery Studio-Abfrage mit Berechtigungen auswählen, die Sie auf die migrierten gespeicherten Abfragen anwenden möchten. In BigQuery werden die für die ausgewählte gespeicherte BigQuery Studio-Abfrage gewährten Berechtigungen kopiert und auf die migrierten gespeicherten Abfragen angewendet. Sie können auch Nutzer oder Gruppen manuell hinzufügen, für die Sie die migrierten gespeicherten Abfragen freigeben möchten.

Wenn Sie während der Migration keine IAM-Berechtigungen festlegen, haben nur Sie Zugriff auf die migrierten gespeicherten Abfragen in BigQuery Studio.

Bei der Batchmigration klassischer gespeicherter Abfragen führt BigQuery Folgendes aus:

• Alle migrierten klassischen gespeicherten Abfragen werden als gespeicherte BigQuery Studio-Abfragen in der ausgewählten Region gespeichert.
• Alle migrierten klassischen gespeicherten Abfragen werden in klassische gespeicherte Abfragen im Lesemodus umgewandelt, die bis 2025 verfügbar sind.

Nach der Migration können Sie auf Ihre privaten, öffentlichen und projektspezifischen klassischen gespeicherten Abfragen sowohl als gespeicherte BigQuery Studio-Abfragen als auch als schreibgeschützte klassische gespeicherte Abfragen zugreifen. Klassisch gespeicherte Abfragen im Lesemodus sind noch bis 2025 verfügbar.

Migrationsrisiken

Nach der Batchmigration können Sie migrierte klassische gespeicherte Abfragen nicht mehr ändern. Ihre migrierten klassischen privat, öffentlich und im Projekt gespeicherten Abfragen werden schreibgeschützt. Die schreibgeschützten klassischen privat, öffentlich und im Projekt gespeicherten Abfragen sind noch bis 2025 verfügbar.

In BigQuery werden Ihrem Google Cloud-Projekt über die Dataform API migrierte gespeicherte BigQuery Studio-Abfragen hinzugefügt. Das Rückgängigmachen dieser Änderungen würde eine manuelle Bereinigung erfordern.

Warnung: Die Migration kann nach dem Start weder angehalten noch abgebrochen werden.

Klassische gespeicherte Abfragen im Batch migrieren

So migrieren Sie klassische gespeicherte Abfragen in Ihrem Projekt im Batch zu gespeicherten BigQuery Studio-Abfragen:

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

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und klicken Sie neben (Klassische) Abfragen auf Aktionen anzeigen und dann auf Klassische gespeicherte Abfragen migrieren.

3. Klicken Sie im Bereich Migration klassischer gespeicherter Abfragen unter Migrationsbereitschaft prüfen auf Weiter, um zu bestätigen, dass Sie die erforderlichen Berechtigungen haben.

   Ihre IAM-Berechtigungen bestimmen, welche Art von klassischen gespeicherten Abfragen Sie migrieren können und welche Bereiche des Bereichs Migration klassischer gespeicherter Abfragen für Sie sichtbar sind.

4. Wählen Sie im Bereich Region im Drop-down-Menü Region eine Region aus, in der BigQuery die migrierten gespeicherten Abfragen speichert.

   Wir empfehlen, Ihre Standardregion für Code-Assets in BigQuery Studio auszuwählen. Weitere Informationen finden Sie unter Standardregion für Code-Assets festlegen.

5. Wenn Sie alle Ihre privaten klassischen gespeicherten Abfragen migrieren möchten, klicken Sie im Bereich Private Abfragen migrieren auf das Kästchen Alle privaten Abfragen migrieren und dann auf Weiter.

6. So migrieren Sie alle klassischen öffentlichen gespeicherten Abfragen in Ihrem Projekt: Gehen Sie dazu im Abschnitt Öffentliche Abfragen migrieren so vor:

   1. Klicken Sie das Kästchen Alle öffentlichen Abfragen migrieren an.
   2. Wählen Sie im Drop-down-Menü SQL eine in BigQuery Studio gespeicherte Abfrage mit den IAM-Richtlinien aus, die Sie auf die migrierten gespeicherten Abfragen anwenden möchten.

   3. Optional: Wenn Sie einen Nutzer oder eine Gruppe hinzufügen möchten, mit dem bzw. der Sie die migrierten gespeicherten Abfragen teilen möchten, klicken Sie auf Nutzer/Gruppe hinzufügen und dann auf Zugriff auf gespeicherte Abfragen gewähren.

      Wenn Sie die migrierten gespeicherten Abfragen öffentlich freigeben möchten, legen Sie allAuthenticatedUsers als Hauptkonto fest und weisen Sie ihm die Rolle „Code-Betrachter“ zu. Weitere Informationen finden Sie unter Öffentlichen Zugriff gewähren.

   4. Klicken Sie auf Weiter.

7. So migrieren Sie klassische gespeicherte Abfragen auf Projektebene: Gehen Sie im Abschnitt Projektabfragen migrieren so vor:

   1. Klicken Sie auf das Kästchen Alle Projektabfragen migrieren.
   2. Wählen Sie im Drop-down-Menü SQL eine in BigQuery Studio gespeicherte Abfrage mit den IAM-Richtlinien aus, die Sie auf die migrierten gespeicherten Abfragen anwenden möchten.
   3. Optional: Wenn Sie einen Nutzer oder eine Gruppe hinzufügen möchten, mit dem bzw. der Sie die migrierten gespeicherten Abfragen teilen möchten, klicken Sie auf Nutzer/Gruppe hinzufügen und dann auf Zugriff auf gespeicherte Abfragen gewähren.
   4. Klicken Sie auf Weiter.

8. Bestätigen Sie, dass Ihnen die Migrationsrisiken bekannt sind und dass Sie klassische gespeicherte Abfragen im Batch migrieren möchten. Geben Sie dazu im Abschnitt Bestätigen im Feld Bestätigen die Zahl confirm ein und klicken Sie dann auf Weiter.

   Warnung: Die Migration kann nach dem Start weder angehalten noch abgebrochen werden.

9. Klicken Sie auf Senden.

Je nach Anzahl der migrierten Abfragen kann die Migration mehr als 15 Minuten dauern.

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.

Nächste Schritte

• Weitere Informationen zu gespeicherten Abfragen in BigQuery Studio finden Sie unter Einführung in gespeicherte Abfragen .
• Weitere Informationen zum Erstellen gespeicherter Abfragen