Gestisci query salvate
Questo documento descrive come gestire le query salvate e le query classiche salvate.
Query salvate
Consulta le sezioni seguenti per scoprire come gestire le 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:
Abilita BigQuery Studio nel tuo progetto.
(Facoltativo) Per impostare le autorizzazioni IAM sulle query salvate classiche pubbliche o di progetto di cui è stata eseguita la migrazione durante la migrazione (Anteprima), crea o seleziona una query salvata di BigQuery Studio e concedi le Identity and Access Management IAM selezionate a quella query salvata.
- 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 gestire le query salvate di BigQuery Studio nella console Google Cloud:
-
Utente job BigQuery (
roles/bigquery.jobUser
) -
BigQuery Read Session User (
roles/bigquery.readSessionUser
) -
Proprietario del codice (
roles/dataform.codeOwner
)
-
Utente job BigQuery (
-
Per gestire le query salvate di BigQuery Studio utilizzando l'API BigQuery:
Proprietario del codice (
roles/dataform.codeOwner
) -
Per eseguire la migrazione delle query salvate classiche del progetto alle query salvate di BigQuery Studio:
-
Amministratore di BigQuery Studio (
roles/bigquery.studioAdmin
) -
Amministratore IAM del progetto (
roles/resourcemanager.projectIamAdmin
)
-
Amministratore di BigQuery Studio (
-
Per consentire agli utenti autenticati di visualizzare le query di accesso pubblico:
Visualizzatore codice (
roles/dataform.codeViewer
)
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per gestire le query salvate. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
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 ottenere queste autorizzazioni con ruoli personalizzati o 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.
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e la cartella Query e, se necessario, la cartella Query condivise. Trova la query salvata a cui vuoi concedere l'accesso.
Fai clic su > Gestisci autorizzazioni.
Visualizza azioni accanto alla query salvata e poi su CondividiNel riquadro Gestisci autorizzazioni, fai clic su Aggiungi utente/gruppo.
Nel campo Nuovi principali, inserisci un principale.
Nell'elenco Ruolo, seleziona uno dei seguenti ruoli:
- Proprietario codice: può eseguire qualsiasi azione sulla query salvata, inclusa l'eliminazione o la condivisione.
- Editor di codice: può modificare la query.
- Code Viewer: può visualizzare la query.
(Facoltativo) Per visualizzare un elenco completo di ruoli e impostazioni di condivisione avanzate, fai clic su Condivisione avanzata.
Fai clic su Salva.
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 vedere la query salvata che condividi, devi concedergli l'accesso.
Per eseguire una query condivisa, gli utenti devono avere accesso ai dati a cui accede la query. 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.
Nella console Google Cloud, vai alla pagina BigQuery.
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.
Fai clic su > Copia link.
Visualizza azioni accanto alla query, quindi su CondividiCondividi 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 all'entità allAuthenticatedUsers
,
lo stesso viene concesso agli account di servizio e a tutti gli utenti su internet che si sono autenticati con un
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, consulta
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:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e la cartella Query e, se necessario, la cartella Query condivise. Trova la query salvata a cui vuoi concedere l'accesso pubblico.
Fai clic su > Gestisci autorizzazioni.
Visualizza azioni accanto alla query salvata e poi su CondividiNel riquadro Gestisci autorizzazioni, fai clic su Aggiungi utente/gruppo.
Nel campo Nuove entità, inserisci
allAuthenticatedUsers
.Nell'elenco Ruolo, seleziona il ruolo Visualizzatore codice.
Fai clic su Salva.
Per tornare alle informazioni sulla query salvata, fai clic su Chiudi.
Impedire 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
nel criterio iam.allowedPolicyMemberDomains
, il principale allAuthenticatedUsers
non può essere utilizzato in nessun criterio IAM del progetto, il 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:
Nella console Google Cloud, vai alla pagina BigQuery.
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 delle query salvate:
Nella console Google Cloud, vai alla pagina BigQuery.
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 visualizzare i metadati.
Consulta il riquadro Riepilogo per visualizzare informazioni sulla query salvata, ad esempio la regione utilizzata 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:
Nella console Google Cloud, vai alla pagina BigQuery.
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à.
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 delle query salvate:
Nella console Google Cloud, vai alla pagina BigQuery.
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 la quale vuoi confrontare le informazioni sulle versioni.
Nella scheda Attività, fai clic su
Visualizza azioni accanto a una versione della query salvata e poi su Confronta. Si apre il riquadro di confronto, che mostra la versione della query salvata selezionata con la versione corrente della query salvata.(Facoltativo) La versione corrente della query salvata mostra anche le modifiche non salvate. Per salvare queste modifiche, fai clic su Sostituisci.
(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 ti consente di confrontare la versione precedente della query salvata con la versione corrente prima di scegliere se ripristinarla.
Riquadro Attività
- 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.
- Seleziona il riquadro Attività.
- Fai clic su Visualizza azioni accanto alla versione della query salvata che vuoi ripristinare e poi fai clic su Ripristina.
- Fai clic su Conferma per confermare l'azione.
Riquadro di confronto
- 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.
- Seleziona il riquadro Attività.
- Fai clic su Visualizza azioni accanto a una versione della query salvata, quindi fai clic su Confronta. Viene visualizzato il riquadro di confronto, che mostra la versione della query salvata selezionata con la versione più recente della query salvata.
- Se vuoi ripristinare la versione precedente della query salvata dopo il confronto, fai clic su Ripristina.
- Fai clic su Conferma per confermare l'azione.
Scaricare le query salvate
Per scaricare una query salvata:
Nella console Google Cloud, vai alla pagina BigQuery.
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.
Fai clic su Scarica.
Elimina query salvate
Per eliminare una query salvata:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e la cartella Query e, se necessario, la cartella Query condivise. Trova la query salvata che vuoi eliminare.
Fai clic su
Visualizza azioni accanto alla query salvata e poi su Elimina.Per confermare l'eliminazione, digita
delete
nella finestra di dialogo.Fai clic su Elimina.
Query salvate classiche
Consulta le sezioni seguenti per scoprire come gestire le 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 agli 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.
Puoi condividere una query salvata classica con altri utenti generando e condividendo 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 ulteriori informazioni, consulta Concedere l'accesso a un set di dati.
Se prevedi di condividere una query classica salvata, ti consigliamo di includere un commento che descriva lo scopo della query.
- Nel riquadro Explorer, espandi il progetto e la cartella Query(classiche), quindi individua la query salvata classica che vuoi condividere.
- Fai clic su Visualizza azioni accanto alla query, quindi fai clic su Ottieni link.
- Condividi il link con gli utenti a cui vuoi concedere l'accesso alla query.
Salvare una query classica come query salvata
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e la cartella Query(classiche) e, se necessario, la cartella Query progetto.
Fai clic sul nome di una query classica salvata per aprirla.
Fai clic su Salva query (versione classica) > Salva query come….
Nella finestra di dialogo Salva query, digita un nome e scegli la posizione per la query.
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 dei ruoli richiesti. Le autorizzazioni concesse da questi ruoli determinano il tipo di query salvate classiche di cui puoi eseguire la migrazione.
Puoi eseguire la migrazione collettiva delle seguenti query salvate classiche:
- Query salvate classiche personali
- Le query salvate della versione classica personali sono visibili solo all'utente che le crea. Sono identificati dall'icona 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. . La migrazione delle query salvate della versione classica personale può essere eseguita solo dai relativi proprietari. Gli amministratori e gli utenti
- Query salvate classiche pubbliche
Le query salvate pubbliche classiche sono visibili a chiunque abbia un link alla query. Sono identificati dall'icona
. 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 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 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 alle entità con le 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 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 potrai accedere alle query salvate di BigQuery Studio di cui è stata eseguita la migrazione.
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 come query salvate di BigQuery Studio, 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, puoi accedere alle query salvate classiche personali, pubbliche e di progetto sia come query salvate di BigQuery Studio sia come query salvate classiche di sola lettura. Le query classiche salvate in sola lettura sono disponibili fino al 2025.
Rischi di migrazione
Dopo la migrazione collettiva, non potrai modificare le query classiche salvate migrate. Le query classiche salvate di cui è stata eseguita la migrazione, personali, pubbliche e di progetto, 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.
Esegui la migrazione batch delle query salvate classiche
Per eseguire la migrazione collettiva delle query salvate classiche nel progetto alle query salvate di BigQuery Studio, procedi nel seguente modo:
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e fai clic su
Visualizza azioni accanto a Query(classiche), quindi su Esegui la migrazione delle query salvate classiche.Nel riquadro Migrazione delle query salvate classiche, nella sezione Verifica l'idoneità alla migrazione, fai clic su Avanti per verificare di disporre dei ruoli richiesti.
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.
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.
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.
Per eseguire la migrazione di tutte le query pubbliche salvate classiche nel progetto, nella sezione Esegui la migrazione delle query pubbliche, procedi nel seguente modo:
- Seleziona la casella di controllo Esegui la migrazione di tutte le query pubbliche.
- Nel menu a discesa SQL, seleziona una query salvata di BigQuery Studio con i criteri IAM da applicare alle query salvate migrate.
(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 di cui è stata eseguita la migrazione, imposta
allAuthenticatedUsers
come entità e concedile il ruolo Visualizzatore codice. Per saperne di più, consulta Concedere l'accesso pubblico.Fai clic su Avanti.
Per eseguire la migrazione delle query salvate classiche a livello di progetto, nella sezione Esegui la migrazione delle query del progetto, procedi nel seguente modo:
- Seleziona la casella di controllo Esegui la migrazione di tutte le query del progetto.
- Nel menu a discesa SQL, seleziona una query salvata di BigQuery Studio con i criteri IAM da applicare alle query salvate migrate.
- (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.
- Fai clic su Avanti.
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.Fai clic su Invia.
La migrazione può richiedere più di 15 minuti, a seconda del numero di query di migrazione.
Eliminare le query salvate classiche
Nella console Google Cloud, vai alla pagina BigQuery.
Nel riquadro Explorer, espandi il progetto e la cartella Query(classiche) e, se necessario, la cartella Query progetto.
Trova la query classica salvata che vuoi eliminare.
Fai clic su
Visualizza azioni accanto alla query e poi su Elimina.Per confermare l'eliminazione, digita
delete
nella finestra di dialogo.Fai clic su Elimina.
Passaggi successivi
- Per scoprire di più sulle query salvate di BigQuery Studio, consulta Introduzione alle query salvate .
- Per scoprire come creare query salvate, consulta Creare query salvate.