Gestisci query salvate

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

Query salvate

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

Prima di iniziare

Per gestire le query salvate di BigQuery Studio e per eseguire la migrazione delle query salvate classiche alle query salvate di BigQuery Studio, segui questi passaggi:

  1. Attiva BigQuery Studio nel tuo progetto.

  2. (Facoltativo) Per impostare le autorizzazioni IAM sul progetto pubblico o nella versione classica di cui è stata eseguita la migrazione, salvato nella versione classica durante la migrazione (anteprima), crea oppure seleziona una query salvata in BigQuery Studio concedi le autorizzazioni IAM (Identity and Access Management) selezionate alla query salvata.

    1. Durante la migrazione delle query salvate classiche pubbliche o di progetto alle query salvate di BigQuery Studio, seleziona una query salvata di BigQuery Studio per copiare le autorizzazioni concesse alle query salvate di cui è stata eseguita la migrazione.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire le query salvate, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto per cui vuoi gestire le query salvate:

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Questi ruoli predefiniti le autorizzazioni necessarie per gestire le query salvate. Per vedere le autorizzazioni esatte obbligatorie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per gestire le query salvate sono necessarie le seguenti autorizzazioni:

  • Per gestire le query salvate di BigQuery Studio nella console Google Cloud: bigquery.config.get, bigquery.jobs.create, dataform.locations., resourcemanager.projects.get, resourcemanager.projects.list, bigquery.readsessions., dataform.repositories., dataform.workspaces.
  • Per gestire le query salvate di BigQuery Studio utilizzando l'API BigQuery: dataform.locations., dataform.repositories., dataform.workspaces.*, resourcemanager.projects.get, resourcemanager.projects.list
  • Per eseguire la migrazione delle query salvate classiche del progetto alle query salvate di BigQuery Studio: bigquery.savedqueries.get, bigquery.savedqueries.list, bigquery.savedqueries.update, resourcemanager.projects.setIamPolicy
  • Per consentire agli utenti autenticati di visualizzare le query di accesso pubblico: dataform.locations.*, dataform.repositories.computeAccessTokenStatus, dataform.repositories.fetchHistory, dataform.repositories.fetchRemoteBranches, dataform.repositories.get, dataform.repositories.getIamPolicy, dataform.repositories.list, dataform.repositories.queryDirectoryContents, dataform.repositories.readFile, dataform.workspaces.fetchFileDiff, dataform.workspaces.fetchFileGitStatuses, dataform.workspaces.fetchGitAheadBehind. dataform.workspaces.get, dataform.workspaces.getIamPolicy, dataform.workspaces.list, dataform.workspaces.queryDirectoryContents, dataform.workspaces.readFile, dataform.workspaces.searchFiles, resourcemanager.projects.get, resourcemanager.projects.list

Potresti anche riuscire a ottenere queste autorizzazioni con ruoli personalizzati altri ruoli predefiniti.

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 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 delle seguenti opzioni: i seguenti ruoli:

  7. (Facoltativo) Per visualizzare un elenco completo di ruoli e 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, consulta Concedere l'accesso a un set di dati.

Se prevedi di condividere una query salvata, ti consigliamo di includere un commento che descriva lo scopo della 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, espandi la cartella Query condivise. Trova la query salvata che vuoi condividere.

  3. Fai clic su Visualizza azioni accanto alla query, quindi su Condividi > Copia link.

  4. Condividi il link con altri utenti.

Concedere l'accesso pubblico a una query salvata

Puoi concedere l'accesso pubblico a una query salvata di BigQuery Studio concedendo al principale allAuthenticatedUsers il ruolo visualizzatore codice (roles/dataform.codeViewer) per la query salvata.

Quando assegni un ruolo IAM a allAuthenticatedUsers principal, e tutti gli utenti di internet che si sono autenticati con un all'Account Google. Sono inclusi gli account non collegati a un account Google Workspace o a un dominio Cloud Identity, come gli account Gmail personali. Gli utenti non autenticati, come i visitatori anonimi, non sono inclusi. Per ulteriori informazioni, vedi Tutti gli utenti autenticati.

Ad esempio, quando concedi il ruolo Visualizzatore codice a allAuthenticatedUsers per la query salvata sales, tutti gli account di servizio e gli utenti su internet che si sono autenticati con un Account Google hanno accesso di sola lettura alla query salvata sales.

Per concedere l'accesso pubblico a una query salvata di BigQuery Studio:

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

  3. Fai clic su Visualizza azioni accanto alla query salvata e poi su Condividi > Gestisci autorizzazioni.

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

  5. Nel campo Nuove entità, inserisci allAuthenticatedUsers.

  6. Nell'elenco Ruolo, seleziona la Visualizzatore di codice.

  7. Fai clic su Salva.

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

Impedisci l'accesso pubblico alle query salvate

Per assicurarti che non venga concesso alcun accesso pubblico a nessuna query salvata di BigQuery Studio, limita il principale allAuthenticatedUsers nel tuo progetto.

Per limitare allAuthenticatedUsers nel progetto, puoi impostare il criterio iam.allowedPolicyMemberDomains, e rimuovere allAuthenticatedUsers dall'elenco di allowed_values.

Quando limiti allAuthenticatedUsers in iam.allowedPolicyMemberDomains criterio, l'entità allAuthenticatedUsers non può essere utilizzata in criterio IAM nel tuo progetto, che impedisce di concedere l'accesso pubblico a tutte le risorse, incluse le query salvate di BigQuery Studio.

Per ulteriori informazioni sul criterio iam.allowedPolicyMemberDomains e sulle istruzioni per impostarlo, consulta Limitare le identità per dominio.

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.

Visualizzare i metadati delle query salvate

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.

Lavorare con le versioni delle query salvate

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

Visualizzare 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 e la cartella Query e, se necessario, la cartella Query condivise. Fai clic sul nome della query salvata per 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.

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, la 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 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 con la versione attuale della query salvata.

  4. (Facoltativo) La versione corrente della query salvata mostra anche le modifiche non salvate. Per salvare queste modifiche, fai clic su Sostituisci.

  5. (Facoltativo) Per confrontare le versioni in linea anziché in riquadri separati, Fai clic su Confronta e poi su In linea.

Ripristinare una versione di una query salvata

Utilizza una delle seguenti opzioni per ripristinare una versione di 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.

Riquadro Attività

  1. Nel riquadro Explorer, espandi il progetto e 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 e poi fai clic su Ripristina.
  4. Fai clic su Conferma per confermare l'azione.

Riquadro di confronto

  1. Nel riquadro Explorer, espandi il progetto e la cartella Query e, se necessario, nella cartella Query condivise. Fai clic sul nome della query salvata che di cui vuoi ripristinare una versione precedente.
  2. Seleziona il riquadro Attività.
  3. Fai clic su Visualizza azioni accanto a una versione della query salvata e poi su Confronta. Si apre il riquadro di confronto, che mette a confronto la versione della query salvata selezionato con la versione della query salvata più recente.
  4. Se vuoi ripristinare la versione precedente della query salvata dopo 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 e 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 e 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

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

Condividere le query salvate classiche

Puoi condividere le query salvate classiche a cui hai assegnato visibilità pubblica o del progetto. La visibilità del progetto consente alle entità con autorizzazioni richieste per 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.

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, consulta Concedere 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 (classiche), quindi individua la query salvata classica che vuoi condividere.
  2. Fai clic su Visualizza azioni accanto alla query, quindi fai clic su Ottieni link.
  3. Condividi il link con gli utenti a cui vuoi concedere l'accesso alla query.

Salvare una query classica come 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 (classiche) e, se necessario, la cartella Query progetto.

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

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

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

  6. Fai clic su Salva.

Esegui la migrazione delle query salvate classiche

Per richiedere assistenza o fornire un feedback su questa funzionalità, invia un'email all'indirizzo bigquery-studio-support-alias@google.com.

Per eseguire la migrazione collettiva delle query salvate classiche, devi disporre delle autorizzazioni richieste. Queste autorizzazioni determinano il tipo di query salvate classiche di cui è possibile eseguire la migrazione.

Puoi eseguire la migrazione in batch delle seguenti query salvate classiche:

Query salvate classiche personali
Le query salvate nella versione classica personale sono visibili solo all'utente che li crei. Sono identificati dal tipo Icona di . La migrazione delle query salvate della versione classica personale può essere eseguita solo dai relativi proprietari. Gli amministratori e gli utenti a cui è stato concesso l'accesso alle query salvate di BigQuery Studio di cui è stata eseguita la migrazione potrebbero essere in grado di accedere, modificare o eliminare le query salvate personali.
Query salvate classiche pubbliche

Le query salvate pubbliche classiche sono visibili a chiunque abbia un link alla query. Sono identificati dal tipo Icona di . La migrazione delle query salvate classiche pubbliche può essere eseguita solo dai relativi proprietari.

Le autorizzazioni IAM per le query salvate classiche pubbliche non vengono mappate alle autorizzazioni per le query salvate di BigQuery Studio. Ciò significa che le query salvate di BigQuery Studio migrate dalle query salvate classiche pubbliche non sono disponibili pubblicamente per impostazione predefinita. Devi impostare IAM autorizzazioni per le query salvate di BigQuery Studio migrate, durante o dopo la migrazione.

Per impostare le autorizzazioni IAM per le query salvate di BigQuery Studio migrate durante la migrazione, puoi selezionare una query salvata di BigQuery Studio esistente con le autorizzazioni che vuoi applicare alle query salvate migrate. BigQuery copierà le autorizzazioni concesse alla query salvata di BigQuery Studio selezionata e le applicherà alle query salvate di cui è stata eseguita la migrazione. Puoi anche aggiungere manualmente gli utenti o i gruppi con cui vuoi condividere le query salvate di cui è stata eseguita la migrazione.

Se non imposti le autorizzazioni IAM durante la migrazione, solo tu avrai accesso alle query salvate di BigQuery Studio di cui è stata eseguita la migrazione.

Query salvate classiche del progetto

Le query salvate a livello di progetto sono visibili a che hanno autorizzazioni richieste. Sono identificati dall'icona . Puoi eseguire la migrazione collettiva di tutte le query salvate classiche del progetto.

Le autorizzazioni IAM per le query salvate del progetto classico non mappano direttamente alle autorizzazioni per le query salvate di BigQuery Studio. Devi impostare le autorizzazioni IAM per le query salvate di BigQuery Studio di cui è stata eseguita la migrazione, durante o dopo la migrazione.

Per impostare le autorizzazioni IAM per le query salvate di BigQuery Studio migrate durante la migrazione, puoi selezionare una query salvata di BigQuery Studio esistente con le autorizzazioni che vuoi applicare alle query salvate migrate. BigQuery copierà le autorizzazioni concesse nella alla query salvata di BigQuery Studio selezionata e applicarla è stata eseguita la migrazione delle query salvate. Puoi anche aggiungere manualmente gli utenti o i gruppi con cui vuoi condividere le query salvate di cui è stata eseguita la migrazione.

Se non imposti le autorizzazioni IAM durante la migrazione, solo tu potrai avranno accesso alle query salvate di BigQuery Studio migrate.

Durante la migrazione batch delle query salvate classiche, BigQuery esegue le seguenti operazioni:

  • Salva tutte le query salvate classiche di cui viene eseguita la migrazione in BigQuery Studio query salvate, archiviate nella regione selezionata.
  • Converte tutte le query classiche salvate di cui è stata eseguita la migrazione in query classiche salvate di sola lettura, disponibili fino al 2025.

Dopo la migrazione, potrai accedere alla versione classica personale, pubblica e di progetto salvata sia come query salvate in BigQuery Studio sia come query classiche di sola lettura salvate query. Le query salvate classiche di sola lettura sono disponibili fino al 2025.

Rischi di migrazione

Dopo la migrazione collettiva, non potrai modificare le query classiche salvate migrate. Il tuo progetto personale, pubblico e di cui hai eseguito la migrazione le query classiche salvate diventano di sola lettura. Le query salvate classiche personali, pubbliche e di progetto in sola lettura sono disponibili fino al 2025.

BigQuery aggiungerà le query salvate di BigQuery Studio migrate al tuo progetto Google Cloud utilizzando l'API Dataform. Il ripristino di queste modifiche richiede una pulizia manuale.

Eseguire la migrazione batch delle query classiche salvate

Per eseguire la migrazione in batch delle query classiche salvate nel tuo progetto a BigQuery Studio query salvate, procedi nel seguente modo:

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

    Vai a BigQuery

  2. Nel riquadro Explorer, espandi il progetto e fai clic su Visualizza azioni accanto a Query (classiche), quindi fai clic su Esegui la migrazione delle query salvate classiche.

  3. Nel riquadro Migrazione classica delle query salvate, Controlla l'idoneità della migrazione fai clic su Avanti per confermare di avere autorizzazioni richieste.

    Le tue autorizzazioni IAM determinano il tipo di query salvate classiche di cui puoi eseguire la migrazione e le sezioni del riquadro Migrazione delle query salvate classiche che sono visibili.

  4. Nella sezione Regione, nel menu a discesa Regione, seleziona una regione in cui BigQuery memorizzerà le query salvate migrate.

    Ti consigliamo di selezionare la regione predefinita per gli asset di codice di BigQuery Studio. Per ulteriori informazioni, consulta Impostare la regione predefinita per gli asset di codice.

  5. Per eseguire la migrazione di tutte le query personali salvate classiche, nella sezione Esegui la migrazione delle query personali, seleziona la casella di controllo Esegui la migrazione di tutte le query personali e poi fai clic su Avanti.

  6. Per eseguire la migrazione di tutte le query pubbliche salvate classiche nel tuo progetto, Nella sezione Esegui la migrazione delle query pubbliche, segui questi passaggi:

    1. Seleziona la casella di controllo Esegui la migrazione di tutte le query pubbliche.
    2. Nel menu a discesa SQL, seleziona una query salvata di BigQuery Studio con i criteri IAM da applicare alle query salvate migrate.
    3. (Facoltativo) Per aggiungere un utente o un gruppo con cui vuoi condividere le query salvate sottoposte a migrazione, fai clic su Aggiungi utente/gruppo e su Concede l'accesso alle query salvate.

      Per condividere pubblicamente le query salvate migrate, imposta allAuthenticatedUsers come entità e assegnarle il ruolo Visualizzatore di codice. Per saperne di più, consulta Concedere l'accesso pubblico.

    4. Fai clic su Avanti.

  7. Per eseguire la migrazione delle query salvate classiche a livello di progetto, Nella sezione Esegui la migrazione delle query del progetto, segui questi passaggi:

    1. Seleziona la casella di controllo Esegui la migrazione di tutte le query del progetto.
    2. Nel menu a discesa SQL, seleziona una query salvata in BigQuery Studio che contiene i criteri IAM che vuoi applicare alle query salvate migrate.
    3. (Facoltativo) Per aggiungere un utente o un gruppo con cui vuoi condividere le query salvate sottoposte a migrazione, fai clic su Aggiungi utente/gruppo e su Concede l'accesso alle query salvate.
    4. Fai clic su Avanti.
  8. Per confermare di aver compreso i rischi della migrazione e di voler eseguire la migrazione collettiva delle query classiche salvate, nella sezione Conferma, nel campo Conferma, inserisci confirm, quindi fai clic su Avanti.

  9. Fai clic su Invia.

La migrazione può richiedere più di 15 minuti, a seconda del numero di query di migrazione.

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

Passaggi successivi