Creare query salvate
Questo documento descrive come creare query salvate e query salvate classiche.
Query salvate
Utilizza le seguenti sezioni per scoprire come creare query salvate. Le query salvate sono asset di codice BigQuery Studio basati su Dataform.
Per ulteriori informazioni sull'eliminazione delle query salvate e sulla gestione della cronologia delle query salvate, consulta Query salvate.
Abilita BigQuery Studio
Segui le istruzioni in Attivare BigQuery Studio per la gestione degli asset per salvare, condividere e gestire le versioni degli asset di codice, come le query salvate.
Autorizzazioni obbligatorie
Imposta le autorizzazioni appropriate per creare, modificare o visualizzare le query salvate.
Tutti gli utenti con il ruolo Amministratore Dataform (roles/dataform.admin
) hanno accesso come proprietario a tutte le query salvate create nel progetto.
Per ulteriori informazioni su Identity and Access Management (IAM) di BigQuery, consulta Controllo dell'accesso con IAM.
Autorizzazioni per creare query salvate
Per creare ed eseguire query salvate, devi disporre delle seguenti autorizzazioni IAM:
dataform.locations.get
dataform.locations.list
dataform.repositories.list
dataform.repositories.create
Puoi ottenere queste autorizzazioni dai seguenti ruoli IAM:
- Utente job BigQuery (
roles/bigquery.jobUser
) - Utente sessione di lettura BigQuery (
roles/bigquery.readSessionUser
)
Autorizzazioni per modificare le query salvate
Per modificare ed eseguire query salvate, devi disporre dei seguenti ruoli IAM:
- Utente job BigQuery (
roles/bigquery.jobUser
) - Utente sessione di lettura BigQuery (
roles/bigquery.readSessionUser
) - Editor di codice (
roles/dataform.codeEditor
)
Autorizzazioni per visualizzare le query salvate
Per visualizzare ed eseguire le query salvate, devi disporre dei seguenti ruoli IAM:
- Utente job BigQuery (
roles/bigquery.jobUser
) - Utente sessione di lettura BigQuery (
roles/bigquery.readSessionUser
) - Visualizzatore di codice (
roles/dataform.codeViewer
)
Impostare la regione predefinita per gli asset di codice
Se è la prima volta che crei un asset di codice, imposta la regione predefinita per gli asset di codice. Non puoi modificare la regione per un asset di codice dopo averlo creato.
Creare query salvate
Per creare una query salvata:
Nella console Google Cloud, vai alla pagina BigQuery.
Fai clic su
Crea una nuova query.Nell'editor query, inserisci una query SQL valida. Ad esempio, puoi eseguire una query su un set di dati pubblico:
SELECT name, SUM(number) AS total FROM `bigquery-public-data.usa_names.usa_1910_2013` GROUP BY name ORDER BY total DESC LIMIT 10;
Fai clic su Salva query > Salva query.
Nella finestra di dialogo Salva query, digita un nome per la query salvata.
(Facoltativo) Per modificare la regione utilizzata da questa query salvata e da tutti gli altri asset di codice in futuro, seleziona una nuova regione in Regione.
Fai clic su Salva.
Concedi l'accesso alle query salvate
Per concedere ad altri utenti l'accesso a una query salvata, aggiungili a un ruolo IAM appropriato.
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto, la cartella Query e, se necessario, la cartella Query condivise. Trova la query salvata a cui vuoi concedere l'accesso.
Fai clic su > Gestisci autorizzazioni.
Visualizza azioni accanto alla query salvata, quindi fai clic su CondividiNel riquadro Gestisci autorizzazioni, fai clic su Aggiungi utente/gruppo.
Nel campo Nuove entità, inserisci un'entità.
Nell'elenco Ruolo, seleziona uno dei seguenti ruoli:
- Proprietario di codice: può eseguire qualsiasi azione sulla query salvata, come eliminarla o condividerla.
- Editor di codice: può modificare la query.
- Visualizzatore di codice: può visualizzare la query.
(Facoltativo) Per visualizzare un elenco completo dei ruoli e delle impostazioni di condivisione avanzate, fai clic su Condivisione avanzata.
Fai clic su Salva.
Per tornare alle informazioni della query salvata, fai clic su Chiudi.
Condividi le query salvate
Puoi condividere una query salvata con altri utenti generando e condividendo un link alla query salvata. Prima che gli utenti possano visualizzare la query salvata che condividi, devi prima concedere loro l'accesso alla query salvata.
Per eseguire una query condivisa, gli utenti devono avere accesso ai dati a cui accedono la query. Per maggiori informazioni, consulta Concedere l'accesso a un set di dati.
Se prevedi di condividere una query salvata, ti consigliamo di includere nella query un commento per descriverne lo scopo.
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e la cartella Query e, se necessario, espandi la cartella Query condivise. Trova la query salvata che vuoi condividere.
Fai clic su > Copia link.
Visualizza azioni accanto alla query e poi su CondividiCondividi il link con altri utenti.
Apri la versione di una query salvata come nuova query
Per aprire una versione qualsiasi di una query salvata esistente come nuova query, segui questi passaggi:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto, la cartella Query e, se necessario, la cartella Query condivise. Seleziona una query salvata.
Seleziona il riquadro Attività.
Fai clic su
Visualizza azioni accanto alla versione di una query salvata, quindi fai clic su Apri come nuova query.
Aggiorna query salvate
Se aggiorni una query salvata, puoi salvare le modifiche in una nuova versione della query.
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto, la cartella Query e, se necessario, la cartella Query condivise. Fai clic sul nome di una query salvata per aprirla.
Modifica la query.
Per salvare la query modificata, fai clic su Salva query > Salva query.
Viene creata una nuova versione della query, che puoi visualizzare nel riquadro Attività.
Carica query salvate
Puoi caricare una query SQL locale da utilizzare come query salvata in BigQuery Studio. La query salvata caricata è quindi visibile anche nella pagina BigQuery della console Google Cloud.
Per caricare una query salvata:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto quindi esegui una delle seguenti operazioni:
- Accanto a Query, fai clic su > Carica query SQL. Visualizza azioni
- Accanto al nome del progetto Google Cloud, fai clic su > Carica nel progetto > Query SQL. Visualizza azioni
Nella finestra di dialogo Carica SQL, nel campo SQL, fai clic su Sfoglia e seleziona la query che vuoi caricare.
(Facoltativo) Nel campo Nome SQL, modifica il nome della query.
Nel campo Regione, seleziona la regione in cui vuoi caricare la query salvata.
Fai clic su Carica.
La query salvata viene visualizzata nel riquadro Explorer.
Query salvate classiche
Utilizza le sezioni seguenti per scoprire come creare e aggiornare le query salvate classiche. Per ulteriori informazioni sulla condivisione, sulla migrazione e sull'eliminazione delle query salvate classiche, vedi Query salvate classiche.
Autorizzazioni richieste per le query salvate classiche
Per creare, visualizzare, aggiornare ed eliminare le query salvate classiche, sono necessarie le seguenti autorizzazioni IAM:
- Query salvate classiche private:
- La creazione di query salvate classiche private non richiede autorizzazioni speciali. Puoi salvare una query privata in qualsiasi progetto, ma solo tu puoi visualizzarla, aggiornarla o eliminarla.
- Query salvate classiche a livello di progetto:
- Per creare una query salvata classica a livello di progetto, sono necessarie le autorizzazioni
bigquery.savedqueries.create
. Il ruolo predefinito dibigquery.admin
include le autorizzazionibigquery.savedqueries.create
. - Per visualizzare una query salvata classica a livello di progetto, sono necessarie le autorizzazioni
bigquery.savedqueries.get
ebigquery.savedqueries.list
. I ruoli predefiniti dibigquery.admin
ebigquery.user
includono le autorizzazionibigquery.savedqueries.get
ebigquery.savedqueries.list
. - Per aggiornare una query salvata classica a livello di progetto, sono necessarie le autorizzazioni
bigquery.savedqueries.update
. Il ruolo predefinito dibigquery.admin
include le autorizzazionibigquery.savedqueries.update
. - Per eliminare una query salvata classica a livello di progetto sono necessarie le autorizzazioni
bigquery.savedqueries.delete
. Il ruolo predefinito dibigquery.admin
include le autorizzazionibigquery.savedqueries.delete
.
- Per creare una query salvata classica a livello di progetto, sono necessarie le autorizzazioni
- Query salvate classiche pubbliche:
- La creazione di query salvate classiche pubbliche non richiede autorizzazioni speciali. Puoi salvare una query salvata in versione classica pubblica in qualsiasi progetto, ma solo tu puoi aggiornarla o eliminarla. Chiunque abbia il link può visualizzare una query salvata in versione classica pubblica.
Per ulteriori informazioni sui ruoli IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.
Crea query salvate classiche
Nella console Google Cloud, vai alla pagina BigQuery.
Fai clic su
Crea una nuova query.Nell'editor query, inserisci una query SQL valida. Ad esempio, puoi eseguire una query su un set di dati pubblico:
SELECT name, SUM(number) AS total FROM `bigquery-public-data.usa_names.usa_1910_2013` GROUP BY name ORDER BY total DESC LIMIT 10;
Fai clic su Salva query (versione classica) > Salva query (versione classica).
Nella finestra di dialogo Salva query, inserisci un nome per la query, quindi imposta Visibilità su una delle seguenti opzioni:
- Personale (modificabile solo da te) per una query condivisa generica privata.
- Progetto (modificabile dalle entità con le autorizzazioni appropriate) per una query salvata classica a livello di progetto.
- Pubblico per una query salvata classica pubblica.
Fai clic su Salva.
Condividi le query salvate classiche
Puoi condividere le query classiche salvate a cui hai dato la visibilità pubblica o a progetto. La visibilità del progetto consente alle entità con le autorizzazioni richieste di visualizzare, aggiornare o eliminare la query. La visibilità pubblica consente a chiunque abbia il link alla query di visualizzarla, ma non di aggiornarla o eliminarla.
Per condividere una query salvata classica con altri utenti, devi generare e condividere un link alla query salvata classica.
Per eseguire una query condivisa classica, gli utenti devono avere accesso ai dati a cui accedono la query. Per maggiori informazioni, consulta Concedere l'accesso a un set di dati.
Se prevedi di condividere una query salvata classica, ti consigliamo di includere nella query un commento che ne descriva lo scopo.
- Nel riquadro Explorer, espandi il progetto e la cartella Query(classica), quindi trova la query salvata classica che vuoi condividere.
- Fai clic su Visualizza azioni accanto alla query e poi su Ottieni link.
- Condividi il link con gli utenti a cui vuoi concedere l'accesso alla query.
Aggiorna le query salvate classiche
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e la cartella Query(classica) e, se necessario, la cartella Query di progetto.
Fai clic sul nome di una query salvata classica per aprirla.
Modifica la query.
Per salvare la query modificata, fai clic su Salva query (versione classica) > Salva query (versione classica).
Passaggi successivi
- Scopri come gestire le query salvate.