Creare query salvate

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

Query salvate

Utilizza le seguenti sezioni per scoprire come creare salvataggi query. Query salvate sono codici di BigQuery Studio asset 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 alla pagina Attivare BigQuery Studio per la gestione degli asset per salvare, condividere e gestire versioni degli asset di codice come query salvate.

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 ulteriori informazioni le informazioni, vedi Attivazione automatica delle API BigQuery Studio.

Autorizzazioni obbligatorie

Imposta le autorizzazioni appropriate per creare, modificare o visualizzare le query salvate.

Tutti gli utenti con Ruolo di Amministratore Dataform (roles/dataform.admin) Avere accesso come proprietario a tutte le query salvate create nel progetto.

Per saperne di più su Identity and Access Management (IAM), consulta Controllo dell'accesso con IAM.

Autorizzazioni per creare query salvate

Per creare ed eseguire query salvate, devi disporre dei seguenti IAM autorizzazioni:

• dataform.locations.get
• dataform.locations.list
• dataform.repositories.list

• dataform.repositories.create

  Nota: gli utenti che hanno dataform.repositories.create può eseguire il codice utilizzando il servizio Dataform predefinito e tutte le autorizzazioni concesse a quell'account. Per ulteriori informazioni, consulta Considerazioni sulla sicurezza per le autorizzazioni Dataform.

Puoi ottenere queste autorizzazioni dai seguenti ruoli IAM:

• Utente job BigQuery (roles/bigquery.jobUser)
• Utente sessione di lettura BigQuery (roles/bigquery.readSessionUser)

• Creatore di codice (roles/dataform.codeCreator)

  Nota: gli utenti a cui è stato assegnato il ruolo Creatore di codice in un progetto possono elencare degli asset di codice nel progetto utilizzando l'API Dataform o Interfaccia a riga di comando (CLI) Dataform. Non amministratori con BigQuery Studio puoi visualizzare solo gli asset di codice che hanno creato o che sono state condivise con loro.

Autorizzazioni per modificare le query salvate

Per modificare ed eseguire query salvate, devi disporre dei seguenti IAM ruoli:

• 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 IAM ruoli:

• 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, impostare la regione predefinita per gli asset di codice. Non puoi modificare la regione per un asset di codice dopo averlo creato.

Nota: se crei una query salvata e scegli una regione predefinita diversa da quella della query quella che utilizzi per gli asset di codice, ad esempio us-west1 se hai usato us-central1, per impostazione predefinita quella query e tutti gli asset di codice creati successivamente utilizzano la nuova regione. Gli asset di codice esistenti continuano a utilizzare la regione assegnata al momento della creazione.

Creare query salvate

Per creare una query salvata:

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

   Vai a BigQuery

2. Fai clic su Crea una nuova query.

3. Nell'editor query, inserisci una query SQL valida. Ad esempio, puoi eseguire query public dataset (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;
   

4. Fai clic su Salva query > Salva query.

5. Nella finestra di dialogo Salva query, digita un nome per la query salvata.

6. (Facoltativo) Per cambiare la regione utilizzata dalla query salvata e da tutte in futuro con altri asset di codice, seleziona una nuova regione in Regione.

7. Fai clic su Salva.

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 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.
   Nota: l'entità deve disporre anche 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 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 Visualizza le azioni accanto alla query e poi fai clic su Condividi > Copia link.

4. Condividi il link con altri utenti.

Apri la versione di una query salvata come nuova query

Per aprire qualsiasi versione di una query salvata esistente come nuova query, segui questi passaggi: passaggi:

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. Seleziona una query salvata.

3. Seleziona il riquadro Attività.

4. Fai clic su Visualizza le azioni accanto a una versione della query salvata e fai clic su Apri come nuova query.

Aggiorna query salvate

Se aggiorni una query salvata, puoi salvare le modifiche in una nuova versione di la query.

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. Modifica la query.

4. Per salvare la query modificata, fai clic su Salva query > Salva query.

   Viene creata una nuova versione della query, che puoi vedere nel Riquadro Attività.

Carica query salvate

Puoi caricare una query SQL locale da utilizzare come query salvata in e BigQuery Studio. La query salvata caricata è quindi visibile anche nella pagina BigQuery della console Google Cloud.

Per caricare una query salvata:

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

   Vai a BigQuery

2. Nel riquadro Explorer, espandi il progetto quindi esegui una delle seguenti operazioni:

   • Accanto a Query, fai clic su . Visualizza azioni > Carica query SQL.
   • Accanto al nome del progetto Google Cloud, fai clic su Visualizza azioni > Carica nel progetto > Query SQL.

3. Nella finestra di dialogo Carica SQL, nel campo SQL, fai clic su Sfoglia e seleziona la query che vuoi per il caricamento.

4. (Facoltativo) Nel campo Nome SQL, modifica il nome della query.

5. Nel campo Regione, seleziona la regione in cui vuoi caricare la query salvata.

6. Fai clic su Carica.

La query salvata viene visualizzata nel riquadro Explorer.

Query salvate classiche

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

Utilizza le seguenti sezioni per scoprire come creare e aggiornare query salvate classiche. Per saperne di più su come condividere, migrare ed eliminare le query classiche salvate, vedi Query salvate classiche.

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

Autorizzazioni richieste per le query salvate classiche

Le seguenti autorizzazioni IAM sono necessarie per creare, visualizzare aggiorna ed elimina le query classiche salvate:

• 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, aggiornare o eliminare la query.
• Query salvate classiche a livello di progetto:
  .
  • La creazione di una query salvata classica a livello di progetto richiede Autorizzazioni bigquery.savedqueries.create. Il bigquery.admin predefinito Il ruolo include autorizzazioni bigquery.savedqueries.create.
  • La visualizzazione di una query salvata classica a livello di progetto richiede Autorizzazioni bigquery.savedqueries.get e bigquery.savedqueries.list. I ruoli predefiniti di bigquery.admin e bigquery.user includono Autorizzazioni bigquery.savedqueries.get e bigquery.savedqueries.list.
  • Per aggiornare una query salvata classica a livello di progetto è necessario Autorizzazioni bigquery.savedqueries.update. Il bigquery.admin predefinito Il ruolo include autorizzazioni bigquery.savedqueries.update.
  • Per eliminare una query salvata classica a livello di progetto è necessario Autorizzazioni bigquery.savedqueries.delete. Il bigquery.admin predefinito Il ruolo include autorizzazioni bigquery.savedqueries.delete.
• 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 aggiornare o eliminare la query. Chiunque abbia il link può visualizzare un classico pubblico query salvata.

Nota: utenti a cui è stata concessa l'autorizzazione dataform.repository.list a livello di progetto può vedere tutte le query salvate create nel progetto.

Per ulteriori informazioni sui ruoli IAM in BigQuery, consulta Ruoli e autorizzazioni predefiniti.

Crea query salvate classiche

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

   Vai a BigQuery

2. Fai clic su Crea una nuova query.

3. Nell'editor query, inserisci una query SQL valida. Ad esempio, puoi eseguire query public dataset (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;
   

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

5. Nella finestra di dialogo Salva query, inserisci un nome per la query. e 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 di una query salvata classica a livello di progetto.
   • Pubblico per una query salvata classica pubblica.

6. Fai clic su Salva.

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

Aggiorna le 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. Modifica la query.

5. Per salvare la query modificata, fai clic su Salva query (versione classica) > Salva query (versione classica).

Passaggi successivi

• Scopri come gestire le query salvate.