Cerca risorse

Utilizza la ricerca nel Catalogo universale di Dataplex per trovare Google Cloud risorse da dentro BigQuery, ad esempio set di dati e tabelle BigQuery.

La ricerca in Dataplex Universal Catalog supporta le query di ricerca in linguaggio naturale (note anche come query di ricerca semantica), che ti consentono di cercare risorse utilizzando un linguaggio di uso quotidiano.

Analogamente alla ricerca per parole chiave, la ricerca in linguaggio naturale mette in evidenza il rilevamento delle risorse analizzando i metadati associati alle risorse all'interno della tua organizzazione. La ricerca prende in considerazione una vasta gamma di metadati che descrive le risorse, inclusi quelli che crei.

La ricerca nel linguaggio naturale si concentra sull'aumento del richiamo anziché sulla precisione.

Per ulteriori informazioni su come cercare i dati delle tabelle in BigQuery, consulta Introduzione alla ricerca in BigQuery.

Registrati per l'anteprima

Per registrarsi alla versione di anteprima, il rappresentante dell'Account Google deve inviare una richiesta compilando il modulo di registrazione. Dopo che avrai inviato il modulo, il team di BigQuery ti contatterà per comunicarti i passaggi successivi.

Prima di iniziare

Prima di utilizzare la ricerca in linguaggio naturale in BigQuery per cercare Google Cloud risorse, completa le attività in questa sezione.

Ruoli obbligatori

Per cercare le risorse, devi disporre di almeno uno dei seguenti ruoli IAM di Catalogo universale Dataplex per il progetto utilizzato per la ricerca: Amministratore di Dataplex Catalog, Editor di Dataplex Catalog o Visualizzatore di Dataplex Catalog. Le autorizzazioni per i risultati di ricerca vengono controllate indipendentemente dal progetto selezionato.

I risultati di ricerca in BigQuery sono definiti in base alle tue autorizzazioni IAM per le risorse sottostanti. Per cercare una risorsa in BigQuery, devi disporre delle autorizzazioni per accedere alla risorsa corrispondente. Per ulteriori informazioni, consulta la sezione Ambito di ricerca di questo documento.

Ad esempio, per cercare set di dati, tabelle, viste e modelli BigQuery, devi disporre delle rispettive autorizzazioni per accedere a queste risorse. Per ulteriori informazioni, consulta Autorizzazioni BigQuery. Il seguente elenco descrive le autorizzazioni minime richieste:

  • Per cercare una tabella, devi disporre dell'autorizzazione bigquery.tables.get per quella tabella.
  • Per cercare un set di dati, devi disporre dell'autorizzazione bigquery.datasets.get per quel set di dati.

Il ruolo Visualizzatore metadati BigQuery (roles/bigquery.metadataViewer) include sia le autorizzazioni bigquery.tables.get sia bigquery.datasets.get, e ti consente di cercare qualsiasi risorsa BigQuery.

Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.

Abilita l'API

Per utilizzare la ricerca, assicurati di aver attivato l'API Dataplex. L'API Dataplex è abilitata per impostazione predefinita per tutti i nuovi Google Cloud progetti con BigQuery. Se l'API Dataplex non è abilitata nel tuo progetto, consulta Abilitare il catalogo universale Dataplex.

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

    Vai a Cerca

  2. Nel campo di ricerca, inserisci la query in linguaggio naturale e premi Invio. Di seguito sono riportate alcune query di esempio:

    • Show me the datasets that contain taxi information
    • Find data on vaccine distribution across different countries
    • Get tables with historical temperature data for major world cities
    • Search for hurricane tracking and storm activity datasets
    • Population data by country

  3. Per filtrare la ricerca, fai clic su Filtri. Sono disponibili i seguenti filtri:

    • Ambito: cerca nell'organizzazione (valore predefinito), nel progetto corrente o solo per le risorse speciali. Per ulteriori informazioni, consulta la sezione Ambito di ricerca di questo documento.
    • Systems: il Google Cloud servizio a cui appartiene la risorsa, come BigQuery. Il sistema del Catalogo universale Dataplex contiene gruppi di voci.
    • Progetti: i progetti in cui eseguire la ricerca.
    • Tipo: il tipo di risorsa, ad esempio connessione BigQuery, bucket Cloud Storage o database. A seconda del tipo di risorsa, puoi anche filtrare per sottotipo, ad esempio il tipo di connessione o il dialetto SQL.
    • Seleziona località: le località in cui effettuare la ricerca.
    • Seleziona set di dati: limita i risultati di ricerca alle risorse BigQuery che appartengono ai set di dati BigQuery selezionati. Nel campo Digita per filtrare, inserisci il nome del set di dati.
    • Annotazioni: i tipi di aspetto del Catalogo universale Dataplex associati alla risorsa che stai cercando. Per filtrare in base ai valori degli aspetti, fai clic su Filtra in base ai valori delle annotazioni e poi seleziona i valori.

    Per rimuovere un filtro, fai clic su Cancella accanto al filtro specifico da rimuovere. In alternativa, per rimuovere tutti i filtri, fai clic su Cancella filtri.

    Per ulteriori informazioni sulla modalità di valutazione dei filtri, consulta la sezione Filtri di questo documento.

  4. (Facoltativo) Per visualizzare ulteriori informazioni su una risorsa, fai clic sul nome della risorsa nei risultati di ricerca.

    Si aprirà un riepilogo delle risorse in un riquadro diviso. Esegui una delle seguenti operazioni:

    • Per aprire la risorsa nel servizio a cui appartiene, fai clic su Apri in PRODUCT_NAME per la risorsa. Ad esempio, per aprire un set di dati BigQuery in BigQuery Studio, fai clic su Apri in Studio. Le opzioni disponibili dipendono dalla risorsa.
    • Per visualizzare i metadati del Catalogo universale Dataplex associati a una risorsa, fai clic su Apri in Dataplex Catalog per la risorsa.
    • Se hai risultati di ricerca importanti che vuoi aggiungere ai preferiti, puoi metterli tra le stelle. Fai clic su Aggiungi a Speciali per la risorsa. Puoi visualizzare le risorse contrassegnate come preferite in BigQuery Studio.
    • Per chiudere il riepilogo delle risorse nel riquadro diviso, fai clic su Chiudi.

Filtri

I filtri ti consentono di restringere i risultati di ricerca.

Quando fornisci filtri in più sezioni, questi vengono valutati utilizzando l'operatore logico AND. I risultati di ricerca contengono risorse che corrispondono almeno a una condizione di ogni sezione selezionata. Ad esempio, se selezioni il sistema BigQuery e il tipo di risorsa dataset, i risultati di ricerca includono i set di dati BigQuery, ma non i set di dati Vertex AI.

Se selezioni più filtri all'interno di una singola sezione, i filtri vengono valutati utilizzando l'operatore logico OR. Ad esempio, se selezioni il tipo di risorsa dataset e il tipo di risorsa table, i risultati di ricerca includono sia i set di dati che le tabelle.

Ambito di ricerca

Per i progetti che appartengono a un' Google Cloud organizzazione, la ricerca viene eseguita nell'ambito dell'organizzazione.

I risultati di ricerca rispettano le autorizzazioni di cui disponi sulle risorse. Ad esempio, se disponi dell'accesso in lettura ai metadati BigQuery di una risorsa, questa viene visualizzata nei risultati di ricerca. Se hai accesso a una tabella BigQuery, ma non al set di dati contenente la tabella, la tabella viene comunque visualizzata come previsto nei risultati di ricerca.

I risultati di ricerca includono solo le risorse che appartengono allo stesso perimetro dei Controlli di servizio VPC del progetto in base al quale viene eseguita la ricerca. Quando utilizzi la Google Cloud console, si tratta del progetto selezionato nella console.

Passaggi successivi