Gestisci query salvate

Questo documento descrive come gestire le query salvate e le query salvate classiche.

Query salvate

Utilizza le sezioni seguenti per scoprire come gestire le query salvate. Le query salvate sono asset di codice di BigQuery Studio basati su Dataform.

Importante: a marzo 2024, le API che supportano le funzionalità di BigQuery Studio sono state abilitate automaticamente per tutti i progetti BigQuery esistenti. Nei nuovi progetti BigQuery, queste API sono abilitate per impostazione predefinita. Per saperne di più, consulta Attivazione automatica delle API BigQuery Studio.

Autorizzazioni obbligatorie

Per gestire le query salvate, devi disporre dei seguenti ruoli IAM (Identity and Access Management):

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente sessione di lettura BigQuery (roles/bigquery.readSessionUser)
• Proprietario di codice (roles/dataform.codeOwner)

Per maggiori informazioni su BigQuery IAM, consulta Controllo dell'accesso con IAM.

Concedere l'accesso alle query salvate

Per concedere ad altri utenti l'accesso a una query salvata, aggiungili a un ruolo IAM appropriato.

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. 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.

3. Fai clic su Visualizza azioni accanto alla query salvata, quindi fai clic su Condividi > Gestisci autorizzazioni.

4. Nel riquadro Gestisci autorizzazioni, fai clic su Aggiungi utente/gruppo.

5. Nel campo Nuove entità, inserisci un'entità.

6. Nell'elenco Ruolo, seleziona uno dei seguenti ruoli:

   • Proprietario di codice: può eseguire qualsiasi azione sulla query salvata, inclusa l'eliminazione o la condivisione.
   • Editor di codice: può modificare la query.
   • Visualizzatore di codice: può visualizzare la query.
   Nota: l'entità deve anche avere il ruolo Utente BigQuery (roles/bigquery.user) per eseguire la query salvata.

7. (Facoltativo) Per visualizzare un elenco completo dei ruoli e delle impostazioni di condivisione avanzate, fai clic su Condivisione avanzata.

8. Fai clic su Salva.

9. Per tornare alle informazioni sulla query salvata, fai clic su Chiudi.

Condividere 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 concedere loro l'accesso alla query salvata.

Per eseguire una query condivisa, gli utenti devono avere accesso ai dati a cui accede la query. Per maggiori informazioni, consulta Concedere l'accesso a un set di dati.

Se prevedi di condividere una query salvata, valuta la possibilità di includere nella query un commento per descriverne lo scopo.

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. 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.

3. Fai clic su Visualizza azioni accanto alla query e poi su Condividi > Copia link.

4. Condividi il link con altri utenti.

Visualizza tutte le query salvate

Per visualizzare un elenco di tutte le query salvate nel progetto:

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, fai clic su Visualizza azioni accanto a Query, quindi esegui una delle seguenti operazioni:

• Per aprire l'elenco nella scheda corrente, fai clic su Mostra tutto.
• Per aprire l'elenco in una nuova scheda, fai clic su Mostra tutto in > Nuova scheda.
• Per aprire l'elenco in una scheda suddivisa, fai clic su Mostra tutto in > scheda Dividi.

Visualizza i metadati della query salvata

Per visualizzare i metadati della query salvata:

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto, la cartella Query e, se necessario, la cartella Query condivise. Fai clic sul nome della query salvata di cui vuoi visualizzare i metadati.

3. Controlla il riquadro Riepilogo per vedere le informazioni sulla query salvata, come la regione utilizzata e la data dell'ultima modifica.

Utilizzare le versioni delle query salvate

Utilizza le sezioni seguenti per scoprire come visualizzare, confrontare e ripristinare le versioni di una query salvata.

Visualizza le versioni delle query salvate

Per visualizzare le versioni delle query salvate:

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto, la cartella Query e, se necessario, la cartella Query condivise. Fai clic sul nome della query salvata di cui vuoi visualizzare l'attività.

3. Fai clic sulla scheda Attività per visualizzare un elenco delle versioni delle query salvate in ordine decrescente per data.

Confrontare le versioni delle query salvate

Per confrontare le versioni della query salvata:

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto, la cartella Query e, se necessario, la cartella Query condivise. Fai clic sul nome della query salvata di cui vuoi confrontare le informazioni sulla versione.

3. Nella scheda Attività, fai clic su Visualizza azioni accanto a una versione della query salvata, quindi fai clic su Confronta. Si apre il riquadro di confronto, che confronta la versione della query salvata selezionata con l'attuale versione della query salvata.

4. (Facoltativo) Per confrontare le versioni in linea anziché in riquadri separati, fai clic su Confronta e quindi su In linea.

Ripristinare una versione della query salvata

Utilizza una delle seguenti opzioni per ripristinare una versione della query salvata. Il ripristino dal riquadro di confronto ti consente di confrontare la versione precedente della query salvata con la versione attuale prima di scegliere se ripristinarla.

Riquadro attività

1. Nel riquadro Explorer, espandi il progetto, la cartella Query e, se necessario, la cartella Query condivise. Fai clic sul nome della query salvata di cui vuoi ripristinare una versione precedente.
2. Seleziona il riquadro Attività.
3. Fai clic su Visualizza azioni accanto alla versione della query salvata che vuoi ripristinare, quindi fai clic su Ripristina.
4. Fai clic su Conferma per confermare l'azione.

Riquadro di confronto

1. Nel riquadro Explorer, espandi il progetto, la cartella Query e, se necessario, la cartella Query condivise. Fai clic sul nome della query salvata di cui vuoi ripristinare la versione precedente.
2. Seleziona il riquadro Attività.
3. Fai clic su Visualizza azioni accanto a una versione della query salvata, quindi fai clic su Confronta. Si apre il riquadro di confronto, che confronta la versione della query salvata selezionata con la versione più recente della query salvata.
4. Se vuoi ripristinare la versione precedente della query salvata dopo il confronto, fai clic su Ripristina.
5. Fai clic su Conferma per confermare l'azione.

Scaricare le query salvate

Per scaricare una query salvata:

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. 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.

3. Fai clic su Scarica.

Elimina query salvate

Per eliminare una query salvata:

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto, la cartella Query e, se necessario, la cartella Query condivise. Trova la query salvata che vuoi eliminare.

3. Fai clic su Visualizza azioni accanto alla query salvata, quindi fai clic su Elimina.

4. Per confermare l'eliminazione, digita delete nella finestra di dialogo.

5. Fai clic su Elimina.

Query tradizionali salvate

Ritirati: le query salvate, disponibili nell'anteprima di BigQuery Studio, sostituiranno completamente le query salvate nella versione classica entro marzo 2025. Per saperne di più, consulta Ritiro delle query salvate della versione classica. Per scoprire come eseguire la migrazione alle query salvate, consulta Eseguire la migrazione delle query salvate della versione classica.

Utilizza le sezioni seguenti per scoprire come gestire le query salvate classiche.

Nota: se non hai attivato BigQuery Studio, le query salvate classiche vengono visualizzate nella cartella Query salvate (NUMBER) del riquadro Explorer anziché nella cartella Query(versione classica).

Condividere le query salvate nella versione classica

Puoi condividere le query salvate classiche per cui hai ottenuto la visibilità pubblica o del 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 della query di visualizzarla, ma non di aggiornarla o eliminarla.

Per condividere una query salvata classica con altri utenti, generi e condividi un link alla query salvata classica.

Per eseguire una query condivisa classica, gli utenti devono avere accesso ai dati a cui accede la query. Per maggiori informazioni, consulta Concedere l'accesso a un set di dati.

Se prevedi di condividere una query salvata classica, valuta la possibilità di includere nella query un commento per descriverne lo scopo.

1. Nel riquadro Explorer, espandi il progetto e la cartella Query(classica), quindi trova la query classica salvata che vuoi condividere.
2. Fai clic su Visualizza azioni accanto alla query e poi su Ottieni link.
3. Condividi il link con gli utenti a cui vuoi concedere l'accesso alla query.

Eseguire la migrazione delle query salvate della versione classica

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto, la cartella Query(classica) e, se necessario, la cartella Query del progetto.

3. Fai clic sul nome di una query salvata classica per aprirla.

4. Fai clic su Salva query (versione classica) > Salva query con nome....

5. Nella finestra di dialogo Salva query, digita un nome e scegli la posizione della query.

6. Fai clic su Salva.

Eliminare le query salvate nella versione classica

1. Nella console Google Cloud, vai alla pagina BigQuery.

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto, la cartella Query(classica) e, se necessario, la cartella Query del progetto.

3. Trova la query salvata classica che vuoi eliminare.

4. Fai clic su Visualizza azioni accanto alla query, quindi fai clic su Elimina.

5. Per confermare l'eliminazione, digita delete nella finestra di dialogo.

6. Fai clic su Elimina.