Introduzione alle query salvate
Questo documento fornisce un'introduzione alle query salvate e alle query classiche salvate 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:
- Condividere le query con utenti e gruppi specifici utilizzando Identity and Access Management (IAM).
- Esamina la cronologia delle versioni della query.
- Eseguire il ripristino o il ramo dalle versioni precedenti della query.
Le query salvate salvano sia il testo della query sia le relative impostazioni.
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 sono archiviati in una regione predefinita. L'aggiornamento della regione predefinita cambia la regione per tutti gli asset di codice creati successivamente.
Le funzionalità delle query salvate sono disponibili solo nella console Google Cloud.
Sicurezza delle query salvate
Puoi controllare l'accesso alle query salvate utilizzando i ruoli IAM (Identity and Access Management). Per maggiori informazioni, consulta Concedere l'accesso alle query salvate.
Aree geografiche supportate
BigQuery Studio ti permette di salvare, condividere e gestire le query salvate. La seguente tabella 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 |
A basse emissioni di CO2 | |
Los Angeles | us-west2 |
||
Las Vegas | us-west4 |
||
Montréal | northamerica-northeast1 |
A basse emissioni di CO2 | |
N. Virginia | us-east4 |
||
Oregon | us-west1 |
A basse emissioni di CO2 | |
San Paolo | southamerica-east1 |
A basse emissioni di CO2 | |
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 |
A basse emissioni di CO2 | |
Francoforte | europe-west3 |
A basse emissioni di CO2 | |
Londra | europe-west2 |
A basse emissioni di CO2 | |
Madrid | europe-southwest1 |
||
Paesi Bassi | europe-west4 |
||
Torino | europe-west12 |
||
Zurigo | europe-west6 |
A basse emissioni di CO2 | |
Medio Oriente | |||
Doha | me-central1 |
||
Dammam | me-central2 |
Quote e limiti
Per ulteriori informazioni, consulta Quote e limiti delle query salvate.
Query tradizionali salvate
Le classiche query salvate sono un metodo precedente per salvare e condividere le query SQL. Le query classiche salvate forniscono il testo della query e l'unica impostazione di query conservata da una query salvata classica è la versione SQL. Questa impostazione determina se la query utilizza SQL o GoogleSQL precedente. Per eseguire query sui dati, gli utenti devono avere accesso ai dati a cui accede la query salvata. Per maggiori informazioni, consulta Concedere l'accesso alle query salvate.
Esistono tre tipi di query salvate classiche:
- Privato. Le query private salvate nella versione classica sono visibili solo all'utente che le crea. Sono identificati dall'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 classiche pubbliche sono visibili a chiunque abbia un link alla query. Sono identificati dall'icona .
Puoi migrate delle query salvate classiche alle query salvate per sfruttare le nuove funzionalità oppure continuare a mantenerle come query salvate classiche fino al 2025.
La funzionalità classica delle query salvate è disponibile solo nella console Google Cloud.
Ritiro delle query salvate classiche
Entro marzo 2025, la funzionalità delle query salvate di BigQuery Studio sostituirà le query salvate della versione classica. Per modificare le query salvate classiche esistenti dopo il 2024, devi 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 con accesso ai dati nel progetto, il proprietario della query deve eliminare le query o le informazioni entro marzo 2025.
Per supportare questa transizione, i seguenti ruoli IAM di BigQuery verranno aggiornati a febbraio 2024:
Amministratore BigQuery (
roles/bigquery.admin
) riceverà le autorizzazioni Amministratore Dataform (roles/dataform.admin
).BigQuery Job User (
roles/bigquery.jobUser
) otterrà le seguenti autorizzazioni:dataform.locations.get
dataform.locations.list
dataform.repositories.create
dataform.repositories.list
Utente BigQuery (
roles/bigquery.user
) avrà le seguenti autorizzazioni:dataform.locations.get
dataform.locations.list
dataform.repositories.create
dataform.repositories.list
Per consentire agli utenti senza 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.