Einführung in gespeicherte Abfragen

Dieses Dokument bietet eine Einführung in gespeicherte Abfragen und klassische gespeicherte Abfragen in BigQuery.

Gespeicherte Abfragen

Dieses Dokument bietet eine Einführung in gespeicherte Abfragen in BigQuery. Sie können gespeicherte Abfragen zum Erstellen und Verwalten von SQL-Skripts verwenden. Gespeicherte Abfragen verbessern die Zusammenarbeit und Abfrageverwaltung mit den folgenden Optionen:

  • Geben Sie Abfragen für bestimmte Nutzer und Gruppen mithilfe von Identity and Access Management (IAM) frei.
  • Prüfen Sie den Abfrageversionsverlauf.
  • Kehren Sie zu vorherigen Versionen der Abfrage zurück oder wechseln Sie zu diesen.

Gespeicherte Abfragen speichern sowohl den Abfragetext als auch die Abfrageeinstellungen.

Gespeicherte Abfragen sind BigQuery Studio-Code-Assets, die auf Dataform basieren. Notebooks sind auch Code-Assets. Alle Code-Assets werden in einer Standardregion gespeichert. Durch das Aktualisieren der Standardregion wird die Region für alle Code-Assets geändert, die danach erstellt werden.

Gespeicherte Abfragen sind nur in der Google Cloud Console verfügbar.

Sicherheit für gespeicherte Abfragen

Sie steuern den Zugriff auf gespeicherte Abfragen mithilfe der Rollen für Identitäts- und Zugriffsverwaltung (IAM). Weitere Informationen finden Sie unter Zugriff auf gespeicherte Abfragen gewähren.

Unterstützte Regionen

Mit BigQuery Studio können Sie gespeicherte Abfragen speichern, freigeben und verwalten. In der folgenden Tabelle sind die Regionen aufgeführt, in denen BigQuery Studio verfügbar ist:

Beschreibung der Region Name der Region Details
Afrika
Johannesburg africa-south1
Amerika
Columbus us-east5
Dallas us-south1 Blattsymbol Niedriger CO2-Wert
Iowa us-central1 Blattsymbol Niedriger CO2-Wert
Los Angeles us-west2
Las Vegas us-west4
Montreal northamerica-northeast1 Blattsymbol Niedriger CO2-Wert
N. Virginia us-east4
Oregon us-west1 Blattsymbol Niedriger CO2-Wert
São Paulo southamerica-east1 Blattsymbol Niedriger CO2-Wert
South Carolina us-east1
Asiatisch-pazifischer Raum
Hongkong asia-east2
Jakarta asia-southeast2
Mumbai asia-south1
Seoul asia-northeast3
Singapur asia-southeast1
Sydney australia-southeast1
Taiwan asia-east1
Tokio asia-northeast1
Europa
Belgien europe-west1 Blattsymbol Niedriger CO2-Wert
Frankfurt europe-west3 Blattsymbol Niedriger CO2-Wert
London europe-west2 Blattsymbol Niedriger CO2-Wert
Madrid europe-southwest1 Blattsymbol Niedriger CO2-Wert
Niederlande europe-west4 Blattsymbol Niedriger CO2-Wert
Turin europe-west12
Zürich europe-west6 Blattsymbol Niedriger CO2-Wert
Naher Osten
Doha me-central1
Dammam me-central2

Kontingente und Limits

Weitere Informationen finden Sie unter Kontingente und Limits für gespeicherte Abfragen.

Beschränkungen

Für gespeicherte Abfragen gelten die folgenden Einschränkungen:

  • Sie können nur dem allAuthenticatedUsersöffentlich Zugriff auf gespeicherte Abfragen gewähren. Sie können dem Hauptkonto allUsers keinen Zugriff auf gespeicherte Abfragen gewähren.
  • Wenn Ihr Google Cloud-Projekt mehr als 2.500 klassische gespeicherte Abfragen enthält, können Sie die Batchmigration (Vorabversion) nicht verwenden, um klassische gespeicherte Abfragen zu gespeicherten Abfragen zu migrieren.

Klassische gespeicherte Abfragen

Klassische gespeicherte Abfragen sind eine frühere Möglichkeit, SQL-Abfragen zu speichern und freizugeben. Klassische gespeicherte Abfragen stellen den Abfragetext bereit. Die einzige von einer klassischen gespeicherten Abfrage beibehaltene Abfrageeinstellung ist die SQL-Version. Diese Einstellung bestimmt, ob die Abfrage Legacy- oder Google SQL-Dialekt verwendet. Zum Abfragen der Daten müssen Nutzer Zugriff auf die Daten haben, auf die die gespeicherte Abfrage zugreift. Weitere Informationen finden Sie unter Zugriff auf gespeicherte Abfragen gewähren.

Es gibt drei Arten von gespeicherten Abfragen:

  • Personal aus. Private, klassisch gespeicherte Abfragen sind nur für den Nutzer sichtbar, der sie erstellt hat. Sie sind durch das Symbol gekennzeichnet.
  • auf Projektebene Auf Projektebene gespeicherte Abfragen sind für Hauptkonten sichtbar, die die erforderlichen Berechtigungen haben. Sie sind mit dem Symbol gekennzeichnet.
  • Öffentlich. Öffentliche, klassisch gespeicherte Abfragen sind über den Abfragelink für alle Nutzer sichtbar. Sie sind durch das Symbol gekennzeichnet.

Sie können klassisch gespeicherte Abfragen in gespeicherte Abfragen migrieren, um die Vorteile der neuen Funktionen zu nutzen, oder sie als klassische gespeicherte Abfragen bis 2025 beibehalten.

Das Feature für klassisch gespeicherte Abfragen ist nur in der Google Cloud Console verfügbar.

Einstellung von klassischen gespeicherten Abfragen

Ab März 2025 werden klassische gespeicherte Abfragen durch die Funktion für gespeicherte Abfragen von BigQuery Studio ersetzt. Wenn Sie vorhandene klassische gespeicherte Abfragen nach 2024 bearbeiten möchten, müssen Sie klassische Abfragen zu gespeicherten BigQuery Studio-Abfragen migrieren.

Wenn Nutzer, einschließlich Ihrer Person, persönliche Abfragen mit Informationen haben, die nicht anderen Personen mit Zugriff auf Daten im Projekt zugänglich gemacht werden sollen, muss der Inhaber der Abfrage die Abfragen oder die Informationen bis März 2025 löschen.

Um diese Umstellung zu unterstützen, wurden die folgenden BigQuery-IAM-Rollen im Februar 2024 aktualisiert:

Damit Nutzer ohne die Rollen „BigQuery-Administrator“, „BigQuery-Jobnutzer“ oder „BigQuery-Nutzer“ gespeicherte Abfragen verwenden können, müssen Sie ihnen die erforderlichen Berechtigungen in IAM erteilen.

Benutzerdefinierte Rollen werden nicht automatisch aktualisiert. Informationen zum Aktualisieren einer benutzerdefinierten Rolle mit den erforderlichen Berechtigungen finden Sie unter Vorhandene benutzerdefinierte Rolle bearbeiten.

Nächste Schritte