Informazioni sulla ricerca in Knowledge Catalog

La ricerca in Knowledge Catalog (in precedenza Dataplex Universal Catalog) ti consente di scoprire le risorse della tua organizzazione utilizzando query in linguaggio naturale con corrispondenza semantica, parole chiave e predicati strutturati. Puoi cercare asset di dati specifici, esplorare i metadati pertinenti tra i sistemi o recuperare risultati mirati per i flussi di lavoro programmatici e Agentic Workflows.

Casi d'uso

Il seguente elenco descrive i casi d'uso comuni della ricerca, insieme alle descrizioni e alle query di esempio:

  • Ricerca di asset mirata: trova un asset specifico cercando parole chiave correlate al nome, alle colonne o alla descrizione dell'asset.

    Esempi di query

    • retail_transactions_2026
    • customer_id
    • column:customer_id

  • Scoperta di dati su larga scala: identifica gli asset pertinenti all'interno della tua organizzazione utilizzando query con parole chiave o linguaggio naturale aperto.

    Esempi di query

    • quarterly financial reports
    • ad campaign click through rates tables
    • server health metrics
    • audit logs system=bigquery

  • Recupero di asset con ambito per i workflow: enumera gli asset all'interno di un container specifico, ad esempio un progetto, o con proprietà specifiche, ad esempio tipo o sistema. Questo approccio viene spesso utilizzato per i flussi di lavoro programmatici e agentici.

    Esempi di query

    • type=table projectid:banking-prod aspect:classification.tier=PII
    • system=spanner projectid:inventory-service (parent=marketing_analytics OR parent=finance_analytics)

Come funziona

La ricerca indicizza automaticamente tutto il contesto degli asset di dati gestiti in Knowledge Catalog. È incluso quanto segue:

  • Metadati importati automaticamente da Google Cloud origini dati come BigQuery e Cloud SQL
  • Contesto per le risorse che importi tramite connettori e integrazioni
  • Contesto aggiuntivo che crei per le risorse, ad esempio per rappresentare il contesto aziendale o descrivere la semantica dei dati. Il contesto potrebbe anche essere acquisito sotto forma di aspetti o termini aziendali collegati.

Durante l'elaborazione della query, la ricerca applica una combinazione di corrispondenza semantica e delle parole chiave. La tabella seguente descrive i tipi di query che puoi utilizzare con la ricerca di Knowledge Catalog, insieme alle descrizioni e alle query di esempio:

Tipo di query Utilizzo Esempi
Parola chiave singola Per la corrispondenza esatta e di sottostringhe tra elementi di metadati, come nome, descrizione e schema dell'asset. prd_fin_invoices_fct_v02
Parole chiave parziali e frammenti tokenizzati Trova le sottostringhe nei contenuti dei metadati, individuando le risorse anche con termini abbreviati, parole separate o variazioni di nomi. fin transactions 2026 (corrisponde a prd_fin_transactions_fy2026_raw)
Query in linguaggio naturale Utilizza la corrispondenza semantica senza richiedere corrispondenze esatte di nomi o colonne. customer churn prediction features
Predicati strutturati Combina query di testo libero con filtri di predicati espliciti per restringere i risultati di ricerca. audit logs system=bigquery
Sintassi estesa Per una ricerca precisa, limitata a un ambito specifico. La sintassi estesa viene utilizzata più spesso nei casi d'uso agentici e programmatici. Per saperne di più, consulta Sintassi di ricerca. (system:bigquery OR system:spanner) AND column:credit_card_number aspect:classification.tier=PII -projectid:sandbox-project

Per accedere alla ricerca in Knowledge Catalog, hai a disposizione le seguenti opzioni:

Ambito di ricerca

I risultati di ricerca in Knowledge Catalog rispettano le autorizzazioni che hai sulle risorse corrispondenti nei sistemi di origine.

Ad esempio, se hai l'accesso in lettura ai metadati BigQuery per un oggetto, questo viene visualizzato nei risultati di ricerca di Knowledge Catalog. Se hai accesso a una tabella BigQuery, ma non al set di dati che la contiene, la tabella viene comunque visualizzata come previsto nella ricerca di Knowledge Catalog.

Per impostazione predefinita, l'ambito della ricerca è limitato alla tua organizzazione. I risultati includono solo le risorse della stessa organizzazione del progetto in cui stai eseguendo la 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 consoleGoogle Cloud , questo è il progetto selezionato nella console.

Per ampliare l'ambito dei risultati di ricerca oltre le risorse all'interno del perimetro dei Controlli di servizio VPC del progetto, utilizza le regole in entrata e in uscita dei Controlli di servizio VPC. Queste regole facilitano lo scambio di dati privato ed efficiente all'interno della tua organizzazione. Puoi configurare le regole in entrata e in uscita utilizzando la consoleGoogle Cloud o tramite file JSON o YAML. Fai riferimento al seguente esempio YAML e consulta la documentazione dei Controlli di servizio VPC per personalizzare la regola in base ai tuoi requisiti specifici.

egressPolicies:
  - egressFrom:
      identityType: ANY_USER_ACCOUNT
    egressTo:
      # Specify which resources should be present in the search results. In this example,
      # BigQuery.
      operations:
      - methodSelectors:
        - method: '*'
        serviceName: bigquery.googleapis.com
      # Specify project ids under which the search is performed.
      resources:
      - projects/SEARCH_PROJECT_ID
ingressPolicies:
  - ingressFrom:
      identityType: ANY_USER_ACCOUNT
      sources:
      - accessLevel: '*'
    ingressTo:
      # Specify which resources should be present in the search results. In this example,
      # BigQuery.
      operations:
      - methodSelectors:
        - method: '*'
        serviceName: bigquery.googleapis.com
      # Specify project ids to expose in search results.
      resources:
      - projects/INGRESS_PROJECT_ID

Per saperne di più sui ruoli di Identity and Access Management necessari per utilizzare la ricerca di Knowledge Catalog, consulta Ruoli IAM di Knowledge Catalog.

Isola i risultati di ricerca per ambiente utilizzando i Controlli di servizio VPC

Per isolare i risultati di ricerca di Knowledge Catalog tra ambienti come sviluppo, test e produzione, configura perimetri dei Controlli di servizio VPC separati per ogni ambiente. Assegna sia i progetti che contengono gli asset di dati sia i progetti utilizzati per eseguire le ricerche al perimetro dell'ambiente corrispondente. Le ricerche eseguite da un progetto all'interno di un perimetro specifico restituiscono solo i risultati per gli asset che si trovano all'interno dello stesso perimetro.

Limitazioni del richiamo nella ricerca

La ricerca di Knowledge Catalog ottimizza l'esplorazione anziché il recupero esaustivo dell'inventario, pertanto le query di ricerca non garantiscono un richiamo completo. Una query potrebbe omettere i risultati corrispondenti e i risultati restituiti potrebbero variare tra query ripetute.

Cause della perdita di richiamo

Quando esegui una ricerca, Knowledge Catalog controlla dinamicamente le tue autorizzazioni rispetto a un limite di controllo dell'accesso di 600 restrizioni (regole di valutazione delle autorizzazioni). Se il controllo dell'accesso supera questo limite, il sistema interrompe il controllo in anticipo per mantenere le ricerche rapide. In questo caso, la ricerca potrebbe escludere gli asset corrispondenti.

È più probabile che tu raggiunga questo limite se si verifica una delle seguenti condizioni:

  • Ruoli IAM assegnati direttamente a centinaia di singole risorse.
  • Iscrizioni a molti gruppi Google, ognuno dei quali concede l'accesso a singole risorse.
  • Iscrizioni a gruppi Google a cui è stato concesso l'accesso direttamente a centinaia di singole risorse.

Risolvi le limitazioni di richiamo e i risultati mancanti

Per risolvere i problemi di richiamo o recuperare i metadati completi, scegli l'approccio più adatto al tuo obiettivo:

  • Per correggere i risultati di ricerca mancanti o incoerenti:riduci i controlli di accesso totali per rimanere al di sotto del limite di 600 restrizioni. Concedi l'accesso solo alle risorse di cui hai bisogno e rimuovi l'accesso dalle risorse o dai gruppi Google in cui non hai bisogno di autorizzazioni. Puoi anche concedere ruoli a livello di progetto o cartella anziché su singole risorse.
  • Per recuperare un inventario completo e garantito dei metadati: non utilizzare la ricerca. Invece, esporta i metadati in Cloud Storage ed esegui query sul set di dati completo con BigQuery.

Passaggi successivi