Questa pagina è stata tradotta dall'API Cloud Translation.

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 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 delle query.
Ripristinare le versioni precedenti della query o creare un ramo da queste.

Le query salvate salvano sia il testo della query sia le impostazioni della query.

Le query salvate sono asset di codice di BigQuery Studio basati su Dataform. Anche i notebook sono asset di codice. Tutti gli asset di codice vengono archiviati in una regione predefinita. L'aggiornamento della regione predefinita modifica la regione per tutti gli asset di codice creati in seguito.

Le funzionalità di query salvate sono disponibili solo nella console Google Cloud.

Sicurezza delle query salvate

Controlla l'accesso alle query salvate utilizzando i ruoli IAM (Identity and Access Management). Per ulteriori informazioni, consulta Concedere l'accesso alle query salvate.

Aree geografiche supportate

BigQuery Studio ti consente di salvare, condividere e gestire le query salvate. La tabella riportata di seguito elenca le regioni in cui BigQuery Studio è disponibile:

	Descrizione della regione	Nome regione	Dettagli
Africa
	Johannesburg	`africa-south1`
Americhe
	Columbus	`us-east5`
	Dallas	`us-south1`	Bassi livelli di CO₂
	Iowa	`us-central1`	Bassi livelli di CO₂
	Los Angeles	`us-west2`
	Las Vegas	`us-west4`
	Montréal	`northamerica-northeast1`	Bassi livelli di CO₂
	N. Virginia	`us-east4`
	Oregon	`us-west1`	Bassi livelli di CO₂
	San Paolo	`southamerica-east1`	Bassi livelli di CO₂
	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 CO₂
	Francoforte	`europe-west3`	Bassi livelli di CO₂
	Londra	`europe-west2`	Bassi livelli di CO₂
	Madrid	`europe-southwest1`	Bassi livelli di CO₂
	Paesi Bassi	`europe-west4`	Bassi livelli di CO₂
	Torino	`europe-west12`
	Zurigo	`europe-west6`	Bassi livelli di CO₂
Medio Oriente
	Doha	`me-central1`
	Dammam	`me-central2`

Quote e limiti

Per ulteriori informazioni, consulta Quote e limiti per le 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 progetto Google Cloud contiene più di 2500 query salvate classiche, non puoi utilizzare la migrazione collettiva (anteprima) 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 query SQL. Le query salvate classiche forniscono il testo della query e l'unica impostazione della query conservata da una query salvata classica è la versione SQL. Questa impostazione regola se la query utilizza SQL precedente o GoogleSQL. Per eseguire query sui dati, gli utenti devono avere accesso ai dati a cui accede la query salvata. Per ulteriori informazioni, consulta Concedere l'accesso alle query salvate.

Esistono tre tipi di query salvate classiche:

Personali. Le query salvate della versione classica personali 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à con le autorizzazioni necessarie. Sono identificati dall'icona .
Pubblico. Le query salvate pubbliche classiche 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 gestirle come query salvate classiche fino al 2025.

La funzionalità di query salvate classica è 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 classiche. Per modificare le query salvate classiche esistenti dopo il 2024, devi eseguire la migrazione delle query classiche alle query salvate di BigQuery Studio.

Se gli utenti, incluso tu, hanno query personali con informazioni che non devono essere messe a disposizione di altri utenti con accesso ai dati del progetto, il proprietario della query deve eliminare le query o le informazioni entro marzo 2025.

Per supportare questa transizione, a febbraio 2024 sono stati aggiornati i seguenti ruoli IAM di BigQuery:

BigQuery Admin (roles/bigquery.admin) ottiene le autorizzazioni di Dataform Admin (roles/dataform.admin).
L'utente job BigQuery (roles/bigquery.jobUser) ottiene le seguenti autorizzazioni:
- dataform.locations.get
- dataform.locations.list
- dataform.repositories.create
- dataform.repositories.list
L'utente BigQuery (roles/bigquery.user) ottiene 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

Per scoprire come creare query salvate, consulta Creare query salvate.
Per scoprire come gestire le query salvate, consulta Gestire le query salvate.