Einführung in gespeicherte Abfragen

Mit gespeicherten Abfragen können Sie SQL-Skripts in BigQuery erstellen, verwalten und freigeben. Änderungen an einer gespeicherten Abfrage werden automatisch gespeichert, sodass Ihre Arbeit nicht verloren geht, wenn Sie den Abfrageeditor schließen. Gespeicherte Abfragen sind nur in der Google Cloud Console verfügbar.

Gespeicherte Abfragen

Gespeicherte Abfragen verbessern die Zusammenarbeit und Abfrageverwaltung mit den folgenden Optionen:

  • Sie können gespeicherte Abfragen mit Identity and Access Management (IAM) für bestimmte Nutzer und Gruppen freigeben.
  • Prüfen Sie den Abfrageversionsverlauf.
  • Kehren Sie zu vorherigen Versionen der Abfrage zurück oder wechseln Sie zu diesen.

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.

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 Gespeicherte Abfragen freigeben und Sicherheitsaspekte für gespeicherte Abfragen.

Unterstützte Regionen

Alle gespeicherten Abfragen werden in einer Standardregion gespeichert. Durch das Aktualisieren der Standardregion wird der Standort für alle Abfragen geändert, die danach erstellt werden. 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
Finnland europe-north1 Blattsymbol Niedriger CO2-Wert
Frankfurt europe-west3
London europe-west2 Blattsymbol Niedriger CO2-Wert
Madrid europe-southwest1 Blattsymbol Niedriger CO2-Wert
Mailand europe-west8 Blattsymbol Niedriger CO2-Wert
Niederlande europe-west4 Blattsymbol Niedriger CO2-Wert
Turin europe-west12 Blattsymbol Niedriger CO2-Wert
Warschau europe-central2 Blattsymbol Niedriger CO2-Wert
Zürich europe-west6 Blattsymbol Niedriger CO2-Wert
Naher Osten
Dammam me-central2
Doha me-central1
Tel Aviv me-west1

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 nicht verwenden, um klassische gespeicherte Abfragen zu gespeicherten Abfragen zu migrieren.

Klassische gespeicherte Abfragen (eingestellt)

Wenn Sie vorhandene klassische gespeicherte Abfragen nach ihrer vollständigen Einstellung bearbeiten möchten, müssen Sie sie zu BigQuery Studio migrieren.

Klassische gespeicherte Abfragen sind eine ältere Methode zum Speichern und Freigeben von SQL. Im Gegensatz zu gespeicherten BigQuery Studio-Abfragen werden nur der Abfragetext und die SQL-Version (Legacy-SQL oder GoogleSQL) beibehalten.

In der Google Cloud Console werden sie im Ordner (Klassische) Abfragen im Bereich Explorer angezeigt. (Wenn Sie BigQuery Studio nicht aktiviert haben, werden sie im Ordner Gespeicherte Abfragen (NUMBER) im Bereich Klassischer Explorer angezeigt.)

Es gibt drei Arten von klassischen gespeicherten Abfragen:

  • Persönlich (): Nur für den Nutzer sichtbar, der sie erstellt hat.

    • Hinweis: Wenn eine persönliche Abfrage vertrauliche Informationen enthält, müssen Sie die Abfrage löschen oder die vertraulichen Daten vor der Migration entfernen.

  • Auf Projektebene (): Sichtbar für alle Prinzipale mit den erforderlichen Berechtigungen.

  • Öffentlich (): Sichtbar für alle, die den Link zur Abfrage haben.

IAM-Rollen für Migration und Zugriff

Die folgenden vordefinierten BigQuery-IAM-Rollen enthalten die erforderlichen Dataform-Berechtigungen, um Sie bei der Umstellung auf gespeicherte BigQuery Studio-Abfragen zu unterstützen:

  • BigQuery-Administrator (roles/bigquery.admin) enthält roles/dataform.admin-Berechtigungen.
  • BigQuery-Jobnutzer (roles/bigquery.jobUser) und BigQuery-Nutzer (roles/bigquery.user) umfassen:
    • dataform.locations.get
    • dataform.locations.list
    • dataform.repositories.create
    • dataform.repositories.list

Wenn Sie keine dieser vordefinierten Rollen haben, fordern Sie die erforderlichen Berechtigungen an. Benutzerdefinierte Rollen werden nicht automatisch aktualisiert und müssen manuell bearbeitet werden.

Nächste Schritte