Introduzione alle query salvate
Questo documento fornisce un'introduzione alle query salvate e alle query salvate classiche in BigQuery.
Query salvate
Questo documento fornisce un'introduzione alle query salvate in BigQuery. Puoi utilizzare le query salvate per creare e gestire gli script SQL. Le query salvate migliorano la collaborazione e la gestione delle query con le seguenti opzioni:
- Condividi le query con utenti e gruppi specifici utilizzando Identity and Access Management (IAM).
- Esamina la cronologia delle versioni della query.
- Ripristina o ramifica dalle versioni precedenti della query.
Le query salvate salvano sia il testo sia le impostazioni della query.
Le query salvate sono asset di codice di BigQuery Studio basati su Dataform. Anche i blocchi note sono asset di codice. Tutti gli asset di codice vengono archiviati in una regione predefinita. L'aggiornamento della regione predefinita cambia la regione per tutti gli asset di codice creati successivamente.
Le funzionalità di query salvate sono disponibili solo nella console Google Cloud.
Sicurezza della query salvata
Puoi controllare l'accesso alle query salvate utilizzando i ruoli IAM (Identity and Access Management). Per ulteriori informazioni, vedi Concedere l'accesso alle query salvate.
Aree geografiche supportate
BigQuery Studio ti consente di salvare, condividere e gestire le query salvate. La tabella seguente elenca le regioni in cui è disponibile BigQuery Studio:
Descrizione regione | Nome regione | Dettagli | |
---|---|---|---|
Africa | |||
Johannesburg | africa-south1 |
||
Americhe | |||
Columbus | us-east5 |
||
Dallas | us-south1 |
||
Iowa | us-central1 |
|
|
Los Angeles | us-west2 |
||
Las Vegas | us-west4 |
||
Montréal | northamerica-northeast1 |
|
|
N. Virginia | us-east4 |
||
Oregon | us-west1 |
|
|
San Paolo | southamerica-east1 |
|
|
Carolina del Sud | us-east1 |
||
Asia Pacifico | |||
Hong Kong | asia-east2 |
||
Giacarta | asia-southeast2 |
||
Mumbai | asia-south1 |
||
Seul | asia-northeast3 |
||
Singapore | asia-southeast1 |
||
Sydney | australia-southeast1 |
||
Taiwan | asia-east1 |
||
Tokyo | asia-northeast1 |
||
Europa | |||
Belgio | europe-west1 |
|
|
Francoforte | europe-west3 |
|
|
Londra | europe-west2 |
|
|
Madrid | europe-southwest1 |
||
Paesi Bassi | europe-west4 |
||
Torino | europe-west12 |
||
Zurigo | europe-west6 |
|
|
Medio Oriente | |||
Doha | me-central1 |
||
Dammam | me-central2 |
Quote e limiti
Per ulteriori informazioni, consulta Quote e limiti delle query salvate.
Query salvate classiche
Le query salvate classiche sono un modo precedente per salvare e condividere le query SQL. Le query salvate classiche forniscono il testo della query e l'unica impostazione della query mantenuta da una query salvata classica è la versione SQL. Questa impostazione stabilisce se la query utilizza SQL o GoogleSQL precedente. Per eseguire query sui dati, gli utenti devono avere accesso ai dati a cui accedono la query salvata. Per ulteriori informazioni, vedi Concedere l'accesso alle query salvate.
Esistono tre tipi di query salvate classiche:
- Privato. Le query salvate classiche private sono visibili solo all'utente che le crea. Sono identificati con l'icona .
- A livello di progetto. Le query salvate a livello di progetto sono visibili alle entità che dispongono delle autorizzazioni richieste. Sono identificati dall'icona .
- Pubblico. Le query salvate nella versione classica pubblica sono visibili a chiunque abbia un link alla query. Sono identificati con l'icona .
Puoi migrate delle query salvate classiche alle query salvate per sfruttare le nuove funzionalità oppure continuare a gestirle come query salvate classiche fino al 2025.
La funzionalità classica di query salvate è disponibile solo nella console Google Cloud.
Ritiro delle query classiche salvate
Entro marzo 2025, la funzionalità delle query salvate di BigQuery Studio sostituirà le query salvate classiche. Per modificare le query classiche salvate esistenti dopo il 2024, dovrai eseguire la migrazione delle query classiche alle query salvate.
Se gli utenti, incluso te, hanno query personali con informazioni che non dovrebbero essere rese disponibili ad altri utenti che hanno accesso ai dati nel progetto, il proprietario della query deve eliminare le query o le relative informazioni entro marzo 2025.
Per supportare questa transizione, i seguenti ruoli IAM di BigQuery verranno aggiornati a febbraio 2024:
L'amministratore BigQuery (
roles/bigquery.admin
) otterrà le autorizzazioni Amministratore Dataform (roles/dataform.admin
).L'utente job BigQuery (
roles/bigquery.jobUser
) otterrà le seguenti autorizzazioni:dataform.locations.get
dataform.locations.list
dataform.repositories.create
dataform.repositories.list
L'utente BigQuery (
roles/bigquery.user
) otterrà le seguenti autorizzazioni:dataform.locations.get
dataform.locations.list
dataform.repositories.create
dataform.repositories.list
Per consentire agli utenti che non hanno i ruoli Amministratore BigQuery, Utente job BigQuery o Utente BigQuery di utilizzare le query salvate, concedi loro le autorizzazioni richieste in IAM.
I ruoli personalizzati non verranno aggiornati automaticamente. Per aggiornare un ruolo personalizzato con le autorizzazioni richieste, consulta Modificare un ruolo personalizzato esistente.
Passaggi successivi
- Scopri come creare query salvate.
- Scopri come gestire le query salvate.