Gestisci query salvate

Questo documento descrive come gestire query salvate e query salvate classiche e come gestire i metadati delle query salvate in Dataplex.

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. Abilita BigQuery Studio nel tuo progetto.

2. (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 alla 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.

3. Per gestire i metadati delle query salvate in Dataplex, assicurati che l'API Dataplex sia abilitata nel tuo progetto Google Cloud.

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

Per gestire i metadati delle query salvate in Dataplex, assicurati di disporre dei ruoli Dataplex e dell'autorizzazione dataform.repository.get richiesti.

Condividere le query salvate

Per condividere una query salvata con un utente, devi prima concedere all'utente l'accesso alla query salvata e aggiungerlo a un ruolo IAM appropriato. Poi, genera un link alla query salvata e condividilo con l'utente.

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. Individua e fai clic sulla query salvata a cui vuoi concedere l'accesso.

3. Fai clic su Condividi, quindi su Gestisci autorizzazioni.

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

5. Nel campo Nuovi principali, inserisci un principale.

6. 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: consente di modificare la query.
   • Code Viewer: può visualizzare la query.
   Nota: il principale deve disporre anche del ruolo Utente BigQuery (roles/bigquery.user) per eseguire la query salvata.

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 sulla query salvata, fai clic su Chiudi.

10. Per generare un link alla query salvata, fai clic su Condividi e poi su Ottieni link.

    Il link viene copiato negli appunti.

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.

Attenzione: la concessione di autorizzazioni a livello di amministratore, di modifica o di esecuzione a allAuthenticatedUsers può consentire a malintenzionati di accedere ai tuoi dati. Concedi solo le autorizzazioni minime richieste.

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 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 il ruolo Visualizzatore codice.

7. Fai clic su Salva.

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

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 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 di cui vuoi visualizzare i metadati.

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

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.

Confrontare le versioni delle query salvate

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 la quale vuoi confrontare le informazioni sulle versioni.

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

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

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.

Eliminare le 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

Ritirata: le query salvate, disponibili nella preview di BigQuery Studio, sostituiranno completamente le query salvate classiche entro marzo 2025. Per ulteriori informazioni, consulta la sezione Ritiro delle query classiche salvate. Per scoprire come eseguire la migrazione alle query salvate, consulta Eseguire la migrazione delle query salvate classiche.

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

Nota: se non hai attivato BigQuery Studio, le query salvate classiche vengono visualizzate nella cartella Query salvate (NUMBER) del riquadro Esploratore anziché nella cartella Query(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.

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

Anteprima: questa funzionalità è in anteprima per i progetti con meno di 2500 query salvate classiche.

Questo prodotto o questa funzionalità sono soggetti ai "Termini delle offerte pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. I prodotti e le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Per richiedere assistenza o fornire un feedback su questa funzionalità, invia un'email all'indirizzo [e-mail].

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 . La migrazione delle query salvate della versione classica personale può essere eseguita solo dai relativi proprietari.

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.

Attenzione: una volta avviata, la migrazione non può essere interrotta o annullata.

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:

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 su Esegui la migrazione delle query salvate classiche.

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

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 progetto, nella sezione Esegui la migrazione delle query pubbliche, procedi nel seguente modo:

   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.

      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.

   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, procedi nel seguente modo:

   1. Seleziona la casella di controllo Esegui la migrazione di tutte le query di progetto.
   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.
   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.

   Attenzione: una volta avviata, la migrazione non può essere interrotta o annullata.

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

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

Gestire i metadati in Dataplex

Dataplex ti consente di archiviare e gestire i metadati per le query salvate. Le query salvate sono disponibili in Dataplex per impostazione predefinita, senza configurazione aggiuntiva.

Puoi utilizzare Dataplex per gestire le query salvate in tutte le località delle query salvate. La gestione delle query salvate in Dataplex è soggetta alle quote e ai limiti di Dataplex e ai prezzi di Dataplex.

Dataplex recupera automaticamente i seguenti metadati dalle query salvate:

• Nome dell'asset di dati
• Asset di dati principale
• Posizione dell'asset di dati
• Tipo di asset di dati
• Progetto Google Cloud corrispondente

Dataplex registra le query salvate come entries con i seguenti valori di entry:

Gruppo di voci di sistema

Il gruppo di voci di sistema per le query salvate è @dataform. Per visualizzare i dettagli delle voci di query salvate in Dataplex, devi visualizzare il gruppo di voci di sistema dataform. Per istruzioni su come visualizzare un elenco di tutte le voci in un gruppo di voci, consulta Visualizzare i dettagli di un gruppo di voci nella documentazione di Dataplex.

Tipo di voce del sistema

Il tipo di voce di sistema per le query salvate è dataform-code-asset. Per visualizzare i dettagli delle query salvate, devi visualizzare il tipo di voce di sistema dataform-code-asset, filtrare i risultati con un filtro basato sugli aspetti e impostare il campo type all'interno dell'aspetto dataform-code-asset su SQL_QUERY. Quindi, seleziona una voce della query salvata selezionata. Per istruzioni su come visualizzare i dettagli di un tipo di voce selezionato, consulta Visualizzare i dettagli di un tipo di voce nella documentazione di Dataplex. Per istruzioni su come visualizzare i dettagli di una voce selezionata, consulta Visualizzare i dettagli di una voce nella documentazione di Dataplex.

Tipo di aspetto del sistema

Il tipo di aspetto di sistema per le query salvate è dataform-code-asset. Per fornire un contesto aggiuntivo alle query salvate in Dataplex annotando le voci delle query salvate con gli aspetti, visualizza il tipo di aspetto dataform-code-asset, filtra i risultati con un filtro basato sugli aspetti e imposta il campo type all'interno dell'aspetto dataform-code-asset su SQL_QUERY. Per istruzioni su come annotare le voci con gli aspetti, consulta Gestire gli aspetti e arricchire i metadati nella documentazione di Dataplex.

Tipo

Il tipo di query salvate è SQL_QUERY. Questo tipo ti consente di filtrare le query salvate nel dataform-code-asset tipo di voce di sistema e nel dataform-code-asset tipo di aspetto utilizzando la query aspect:dataplex-types.global.dataform-code-asset.type=SQL_QUERY in un filtro basato sugli aspetti.

Per istruzioni su come cercare gli asset in Dataplex, consulta Cercare asset di dati in Dataplex nella documentazione di Dataplex.

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.