Introduzione alle query salvate

Utilizza le query salvate in BigQuery per archiviare, gestire e collaborare in modo sicuro sugli script SQL. Mentre lavori nell'editor di query, le modifiche vengono salvate automaticamente per evitare la perdita accidentale del lavoro.

Poiché le query salvate sono asset di codice di BigQuery Studio basati su Dataform, offrono funzionalità avanzate di collaborazione e controllo della versione. Puoi:

• Collabora in sicurezza: condividi le query salvate con utenti e gruppi specifici utilizzando Identity and Access Management (IAM).
• Monitora le modifiche:esamina una cronologia delle versioni dettagliata delle modifiche all'editor di query.
• Gestisci le versioni: crea un ramo o ripristina le versioni precedenti di una query per testare le modifiche in sicurezza.

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 saperne di più, consulta Condividi le query salvate e Considerazioni sulla sicurezza per le query salvate.

Aree geografiche supportate

Tutte le query salvate vengono archiviate in una regione predefinita. L'aggiornamento della regione predefinita modifica la località per tutte le query create dopo quel momento. 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
	Finlandia	europe-north1	Bassi livelli di CO2
	Francoforte	europe-west3
	Londra	europe-west2	Bassi livelli di CO2
	Madrid	europe-southwest1	Bassi livelli di CO2
	Milano	europe-west8	Bassi livelli di CO2
	Paesi Bassi	europe-west4	Bassi livelli di CO2
	Torino	europe-west12	Bassi livelli di CO2
	Varsavia	europe-central2	Bassi livelli di CO2
	Zurigo	europe-west6	Bassi livelli di CO2
Medio Oriente
	Dammam	me-central2
	Doha	me-central1
	Tel Aviv	me-west1

Quote e limiti

Per saperne di più, 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 progetto Google Cloud 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 (ritirate)

Ritirate: le query salvate, disponibili in BigQuery Studio, sostituiranno completamente le query salvate classiche in futuro. La cronologia del ritiro è in fase di revisione. Per saperne di più, consulta Ritiro delle query salvate classiche. Per scoprire come eseguire la migrazione alle query salvate, consulta Esegui la migrazione delle query salvate classiche.

Per modificare le query salvate classiche esistenti dopo il loro ritiro completo, devi eseguirne la migrazione a BigQuery Studio.

Le query salvate classiche sono un metodo precedente per salvare e condividere SQL. A differenza delle query salvate di BigQuery Studio, conservano solo il testo della query e la versione SQL (SQL precedente o GoogleSQL).

Nella console Google Cloud , vengono visualizzate nella cartella Query(legacy) all'interno del riquadro Explorer. Se non hai abilitato BigQuery Studio, vengono visualizzate nella cartella Query salvate (NUMBER) nel riquadro Explorer classico.

Esistono tre tipi di query salvate classiche:

• Personali (): visibili solo all'utente che li ha creati.

  • Nota: se una query personale contiene informazioni sensibili, devi eliminarla o rimuovere i dati sensibili prima della migrazione.

• A livello di progetto (): visibile a qualsiasi entità con le autorizzazioni richieste.

• Pubblica (): visibile a chiunque abbia il link alla query.

Ruoli IAM per la migrazione e l'accesso

I seguenti ruoli IAM BigQuery predefiniti includono le autorizzazioni Dataform necessarie per aiutarti a eseguire la transizione alle query salvate di BigQuery Studio:

• Amministratore BigQuery (roles/bigquery.admin) include le autorizzazioni roles/dataform.admin.
• Utente job BigQuery (roles/bigquery.jobUser) e Utente BigQuery (roles/bigquery.user) includono:
  • dataform.locations.get
  • dataform.locations.list
  • dataform.repositories.create
  • dataform.repositories.list

Se non disponi di uno di questi ruoli predefiniti, richiedi le autorizzazioni richieste. I ruoli personalizzati non vengono aggiornati automaticamente e devono essere modificati manualmente.

Passaggi successivi

• Per scoprire come creare query salvate, consulta Crea query salvate.
• Per scoprire come gestire le query salvate, consulta Gestisci le query salvate.