Gestisci query salvate

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

Query salvate

Utilizza le seguenti sezioni 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. Queste API sono abilitate per impostazione predefinita nei nuovi progetti BigQuery. Per scoprire di più, consulta Attivazione automatica delle API BigQuery Studio.

Autorizzazioni obbligatorie

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

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

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

Concedi 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, come eliminarla o condividerla.
   • Editor di codice: può modificare la query.
   • Visualizzatore di codice: può visualizzare la query.
   Nota: l'entità deve avere anche 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 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.

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 divisa, fai clic su Mostra tutto in > Scheda divisa.

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. Guarda il riquadro Riepilogo per vedere le informazioni sulla query salvata, ad esempio 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 della query salvata

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 per la quale vuoi visualizzare l'attività.

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

Confronta le versioni della query salvata

Per confrontare 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 per la quale vuoi confrontare le informazioni sulla versione.

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

4. (Facoltativo) Per confrontare le versioni in linea anziché in riquadri separati, fai clic su Confronta e poi 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 corrente 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 una versione precedente.
2. Seleziona il riquadro Attività.
3. Fai clic su Visualizza azioni accanto alla versione di una query salvata e poi su Confronta. Si apre il riquadro di confronto, che mette a confronto la versione della query salvata selezionata con la versione della query salvata più recente.
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.

Scarica 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 e poi su Elimina.

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

5. Fai clic su Elimina.

Query salvate classiche

Ritirate: le query salvate, disponibili nell'anteprima di BigQuery Studio, sostituiranno completamente le query salvate classiche entro marzo 2025. Per ulteriori informazioni, consulta l'articolo Ritiro delle query classiche salvate. Per informazioni su come eseguire la migrazione alle query salvate, consulta Eseguire la migrazione delle query salvate classiche.

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

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

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.

1. Nel riquadro Explorer, espandi il progetto e la cartella Query(classica), quindi trova la query salvata classica 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.

Esegui la migrazione delle query salvate classiche

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

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto e la cartella Query(classica) e, se necessario, la cartella Query di 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 per la query.

6. Fai clic su Salva.

Elimina le query classiche salvate

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

   Vai a BigQuery

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

3. Trova la query salvata classica che vuoi eliminare.

4. Fai clic su Visualizza azioni accanto alla query e poi su Elimina.

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

6. Fai clic su Elimina.