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 gli script SQL. Le query salvate migliorano la collaborazione e la gestione delle query con quanto segue 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 della query sia le impostazioni della query.

Le query salvate sono BigQuery Studio asset di codice basati su Dataform. Anche i notebook sono asset di codice. Tutti gli asset di codice sono archiviati in un region. 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 La seguente tabella 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`	A basse emissioni 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`	A basse emissioni di CO₂
	San Paolo	`southamerica-east1`	A basse emissioni 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`	A basse emissioni di CO₂
	Londra	`europe-west2`	A basse emissioni di CO₂
	Madrid	`europe-southwest1`	A basse emissioni di CO₂
	Paesi Bassi	`europe-west4`	A basse emissioni di CO₂
	Torino	`europe-west12`
	Zurigo	`europe-west6`	A basse emissioni di CO₂
Medio Oriente
	Doha	`me-central1`
	Dammam	`me-central2`

Quote e limiti

Per ulteriori informazioni, vedi 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 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 le 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 con Icona di .
A livello di progetto. Le query salvate a livello di progetto sono visibili alle entità con le autorizzazioni richieste. Sono identificati dall'icona .
Pubblico. Le query salvate nella versione classica pubblica sono visibili a chiunque abbia un link a la query. Sono identificati dall'icona .

Puoi eseguire la migrazione delle query salvate classiche alle query salvate per sfruttare le nuove funzionalità oppure continuare a gestirle come query salvate classiche fino al 2025.

La funzione classica di query salvate è disponibile solo in 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, tra cui te, hanno query personali con Informazioni che non dovrebbero essere messe a disposizione di altre persone che hanno accesso ai dati in progetto, il proprietario della query deve eliminare le query o le informazioni entro marzo 2025.

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

BigQuery Admin (roles/bigquery.admin) ottiene Dataform Admin (roles/dataform.admin) autorizzazioni.
L'utente job BigQuery (roles/bigquery.jobUser) ottiene le seguenti autorizzazioni:
- dataform.locations.get
- dataform.locations.list
- dataform.repositories.create
- dataform.repositories.list
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 senza Amministratore BigQuery, Utente job BigQuery o Utente BigQuery i ruoli usano query salvate, concedi loro le autorizzazioni richieste in IAM.

I ruoli personalizzati non saranno aggiornate automaticamente. Per aggiornare un ruolo personalizzato con le autorizzazioni richieste, consulta Modificare un ruolo personalizzato esistente.

Passaggi successivi

Per informazioni su come creare query salvate, consulta Crea query salvate.
Per scoprire come gestire le query salvate, consulta Gestire le query salvate.