Introduzione alle query salvate
Questo documento fornisce un'introduzione alle query salvate in BigQuery. Puoi utilizzare le query salvate per creare e gestire script SQL. Le modifiche a una query salvata vengono salvate automaticamente, in modo da non perdere il lavoro quando chiudi l'editor di query. Le query salvate migliorano la collaborazione e la gestione delle query con le seguenti opzioni:
- Condividi le query salvate con utenti e gruppi specifici utilizzando Identity and Access Management (IAM).
- Controlla la cronologia delle versioni della query.
- Ripristina o crea una ramificazione dalle versioni precedenti della query.
Le query salvate sono asset di codice BigQuery Studio basati su Dataform. Anche i notebook sono asset di codice. Tutti gli asset di codice sono archiviati in una regione predefinita. L'aggiornamento della regione predefinita modifica la regione per tutti gli asset di codice creati dopo quel momento.
Le funzionalità delle query salvate sono disponibili solo nella Google Cloud console.
Sicurezza delle query salvate
Controlli l'accesso alle query salvate utilizzando i ruoli IAM (Identity and Access Management). Per maggiori informazioni, consulta la sezione Condividere le 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 della regione | Nome regione | Dettagli | |
|---|---|---|---|
| Africa | |||
| Johannesburg | africa-south1 |
||
| Americhe | |||
| Columbus | us-east5 |
||
| Dallas | us-south1 |
 Bassi livelli di CO2
|
|
| Iowa | us-central1 |
Bassi livelli di CO2
|
|
| Los Angeles | us-west2 |
||
| Las Vegas | us-west4 |
||
| Montréal | northamerica-northeast1 |
Bassi livelli di CO2
|
|
| N. Virginia | us-east4 |
||
| Oregon | us-west1 |
Bassi livelli di CO2 |
|
| San Paolo | southamerica-east1 |
Bassi livelli 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 |
Bassi livelli di CO2
|
|
| Francoforte | europe-west3 |
||
| Londra | europe-west2 |
Bassi livelli di CO2
|
|
| Madrid | europe-southwest1 |
Bassi livelli di CO2
|
|
| Paesi Bassi | europe-west4 |
Bassi livelli di CO2
|
|
| Torino | europe-west12 |
||
| Zurigo | europe-west6 |
Bassi livelli di CO2
|
|
| Medio Oriente | |||
| Doha | me-central1 |
||
| Dammam | me-central2 |
||
Quote e limiti
Per ulteriori informazioni, consulta Quote e limiti delle query salvate.
Limitazioni
Le query salvate presentano le seguenti limitazioni:
- Puoi
concedere l'accesso pubblico alle query salvate
solo all'entità
allAuthenticatedUsers. Non puoi concedere l'accesso alle query salvate all'entitàallUsers. - Se il tuo Google Cloud progetto contiene più di 2500 query salvate classiche, non puoi utilizzare la migrazione batch per eseguire la migrazione delle query salvate classiche alle query salvate.
Query salvate classiche
Le query salvate classiche sono un modo precedente per salvare e condividere le query SQL. Le query classiche salvate forniscono il testo della query e l'unica impostazione della query conservata da una query classica salvata è la versione SQL. Questa impostazione determina se la query utilizza SQL precedente o GoogleSQL. Per interrogare i dati, gli utenti devono avere accesso ai dati a cui accede la query salvata.
Puoi visualizzare le query classiche salvate nella cartella Query(classiche) del riquadro Explorer:
Esistono tre tipi di query classiche salvate:
- Personali. Le query salvate classiche personali 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 necessarie. Sono identificati con l'icona .
- Pubblico. Le query classiche salvate pubbliche sono visibili a chiunque abbia un link alla query. Sono identificati con l'icona .
Puoi migrare le query salvate classiche alle query salvate per sfruttare le nuove funzionalità oppure continuare a gestirle come query salvate classiche fino alla deprecazione. La tempistica del ritiro è in fase di revisione.
La funzionalità di query salvate classica è disponibile solo nella consoleGoogle Cloud .
Deprecazione delle query salvate classiche
La funzionalità delle query salvate di BigQuery Studio sostituirà le query salvate classiche. La cronologia del ritiro è in fase di revisione. Per modificare le query salvate classiche esistenti dopo il ritiro, devi eseguire la migrazione delle query classiche alle query salvate di BigQuery Studio.
Se gli utenti, incluso te, hanno query personali con informazioni che non devono essere rese disponibili ad altri utenti con accesso ai dati nel progetto, il proprietario della query deve eliminare le query o le informazioni prima di completare la migrazione.
Per supportare questa transizione, a febbraio 2024 sono stati aggiornati i seguenti ruoli IAM di BigQuery:
BigQuery Admin (
roles/bigquery.admin) otterrà Dataform Admin (roles/dataform.admin) permessi.Utente job BigQuery (
roles/bigquery.jobUser) riceverà le seguenti autorizzazioni:dataform.locations.getdataform.locations.listdataform.repositories.createdataform.repositories.list
Utente BigQuery (
roles/bigquery.user) riceverà le seguenti autorizzazioni:dataform.locations.getdataform.locations.listdataform.repositories.createdataform.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, vedi Modificare un ruolo personalizzato esistente.
Passaggi successivi
- Per scoprire come creare query salvate, consulta Creare query salvate.
- Per scoprire come gestire le query salvate, consulta Gestire le query salvate.