Gestisci query salvate

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

Query salvate

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

Autorizzazioni obbligatorie

Per gestire le query salvate, è necessario quanto segue Identity and Access Management (IAM) ruoli:

• 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, aggiungi tali utenti al ruolo IAM.

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, la cartella Query condivise. Trova la query salvata che a cui vuoi concedere l'accesso.

3. Fai clic su more_vert Visualizza le azioni accanto alla query salvata e 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 una di i seguenti ruoli:

   • Proprietario del codice: Can eseguire qualsiasi azione sulla query salvata, compresa la sua eliminazione o la sua condivisione.
   • Editor di codice: Can modificare la query.
   • Visualizzatore di codice: può visualizza la query.

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 vedere la query salvata che condividi, devi Innanzitutto, concedi loro l'accesso alla query salvata.

Per eseguire una query condivisa, gli utenti devono avere accesso ai dati della query di accesso. Per ulteriori informazioni, vedi Concedi l'accesso a un set di dati.

Se prevedi di condividere una query salvata, valuta la possibilità di includere una commento nella query che ne descriva 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 more_vert Visualizza le azioni accanto alla query e poi fai clic 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 more_vert Visualizza le azioni accanto a Query ed 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 e la cartella Query e, se necessario, nella 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 utilizzato 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 e la cartella Query e, se necessario, nella cartella Query condivise. Fai clic sull' 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 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 e la cartella Query e, se necessario, nella cartella Query condivise. Fai clic sul nome della query salvata per cui vuoi confrontare le informazioni sulla versione.

3. Nella scheda Attività, fai clic su more_vert Visualizza le azioni accanto a una versione della query salvata e poi fai clic su Confronta. Si apre il riquadro di confronto, che mette a confronto 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 consente di confrontare la versione precedente di la query salvata alla versione corrente prima di scegliere se ripristinarla.

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 e la cartella Query e, se necessario, nella 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 e la cartella Query e, se necessario, nella cartella Query condivise. Trova la query salvata che vuoi eliminare.

3. Fai clic su more_vert Visualizza le azioni accanto alla query salvata e poi fai clic su Elimina.

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

5. Fai clic su Elimina.

Query salvate classiche

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

Condividi le query salvate classiche

Puoi condividere le query salvate classiche che hai fornito a progetto o pubbliche visibilità. La visibilità del progetto consente alle entità con autorizzazioni richieste per visualizzare, aggiornare o eliminare la query. La visibilità pubblica consente a chiunque il link della query per visualizzare ma non aggiornare o eliminare la query.

Puoi condividere una query salvata classica con altri utenti generandola e condividendola un link alla query salvata classica.

Per eseguire una query condivisa classica, gli utenti devono avere accesso ai dati con cui la query di accesso. Per ulteriori informazioni, vedi Concedi l'accesso a un set di dati.

Se prevedi di condividere una query salvata classica, valuta la possibilità di includere una commento nella query che ne descriva lo scopo.

1. Nel riquadro Explorer, espandi il progetto e la cartella Query(classica), quindi trova alla query salvata classica che vuoi condividere.
2. Fai clic su more_vert Visualizza le azioni accanto alla query e poi fai clic 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, nella 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, nella cartella Query di progetto.

3. Trova la query salvata classica che vuoi eliminare.

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

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

6. Fai clic su Elimina.