Cerca risorse

Utilizza la ricerca di Knowledge Catalog per trovare Google Cloud risorse in BigQuery, ad esempio set di dati e tabelle BigQuery.

La ricerca di Knowledge Catalog supporta le query di ricerca in linguaggio naturale (note anche come query di ricerca semantica), che ti consentono di cercare le risorse utilizzando il linguaggio di tutti i giorni.

Analogamente alla ricerca per parole chiave, la ricerca in linguaggio naturale enfatizza la scoperta delle risorse analizzando i metadati associati alle risorse all'interno della tua organizzazione. La ricerca tiene conto di un'ampia gamma di metadati che descrivono le risorse, inclusi i metadati che crei.

La ricerca in linguaggio naturale si concentra sul miglioramento del richiamo anziché della precisione.

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

Registrati per l'anteprima

Per registrarti all'anteprima, il rappresentante Google per l'account deve inviare una richiesta compilando il modulo di registrazione. Dopo aver 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 le Google Cloud risorse, completa le attività descritte in questa sezione.

Ruoli obbligatori

Per cercare le risorse, devi disporre di almeno uno dei seguenti ruoli IAM di Knowledge Catalog 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 limitati 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 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 le autorizzazioni bigquery.tables.get e bigquery.datasets.get, e ti consente di cercare qualsiasi risorsa BigQuery.

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso.

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

Abilita l'API

Per utilizzare la ricerca, assicurati di aver abilitato 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 Knowledge Catalog.

  1. Nella Google Cloud console, vai alla pagina Cerca 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: esegui la ricerca nell'organizzazione (impostazione predefinita), nel progetto corrente, o solo per le risorse contrassegnate con stella. Per ulteriori informazioni, consulta la sezione Ambito di ricerca di questo documento.
    • Sistemi: il Google Cloud servizio a cui appartiene la risorsa, ad esempio BigQuery. Il sistema Knowledge Catalog 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 eseguire 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 di Knowledge Catalog 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 seleziona i valori.

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

    Per ulteriori informazioni su come vengono valutati i 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 di Knowledge Catalog associati a una risorsa, fai clic su Apri in Knowledge Catalog per la risorsa.
    • Se hai risultati di ricerca importanti che vuoi aggiungere ai preferiti, puoi contrassegnarli con una stella. Fai clic su Aggiungi a Speciali per la risorsa. Puoi visualizzare le risorse contrassegnate con stella in BigQuery Studio.
    • Per chiudere il riepilogo delle risorse nel riquadro diviso, fai clic su Chiudi.

In alternativa, puoi cercare le risorse utilizzando Gemini Cloud Assist.

Filtri

I filtri ti consentono di restringere i risultati di ricerca.

Quando fornisci filtri in più sezioni, i filtri vengono valutati utilizzando l'operatore logico AND. I risultati di ricerca contengono risorse che corrispondono ad almeno 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 sia le tabelle.

Ambito di ricerca

Per i progetti che appartengono a un' Google Cloud organizzazione, la ricerca opera nell'ambito di quell'organizzazione.

I risultati di ricerca rispettano le autorizzazioni che hai per le risorse. Ad esempio, se hai 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 che la contiene, 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 cui viene eseguita la ricerca. Quando utilizzi la Google Cloud console, questo è il progetto selezionato nella console.

Passaggi successivi