Quando cerchi asset di dati in base ai nomi delle colonne, ai flag di dati sensibili (ad esempio un aspetto che indica PII) o ai termini del glossario aziendale, i risultati di ricerca tradizionalmente restituiscono solo la tabella o il set di dati principale. Senza sapere perché una tabella corrisponde alla tua query, devi aprire ogni risultato di ricerca, navigare tra le schede dello schema o dei metadati ed esaminare decine o centinaia di colonne per individuare la corrispondenza.
La spiegabilità dei risultati di ricerca in Knowledge Catalog (in precedenza Dataplex Universal Catalog) risolve questo problema visualizzando i metadati corrispondenti direttamente nelle schede dei risultati di ricerca nella consoleGoogle Cloud . Quando una query di ricerca corrisponde alle colonne dello schema, agli aspetti a livello di voce, agli aspetti a livello di colonna o ai termini del glossario aziendale collegati di un asset, Knowledge Catalog visualizza i tag di spiegabilità tra il titolo e la descrizione dell'asset. Con questi tag, non è necessario aprire ogni voce per trovare i campi pertinenti. Puoi invece valutare il motivo per cui ogni risorsa corrisponde alla tua query e identificare a colpo d'occhio le colonne pertinenti.
Questo documento descrive il funzionamento della spiegabilità dei risultati di ricerca, i suoi vantaggi, i tipi di tag di spiegabilità e come visualizzare la spiegabilità nella consoleGoogle Cloud .
Casi d'uso e vantaggi
La spiegabilità dei risultati di ricerca fornisce contesto ed efficienza durante la scoperta dei dati nell'intera organizzazione. La spiegabilità può aiutarti a:
- Valuta rapidamente la pertinenza: puoi determinare se un asset di dati restituito soddisfa i tuoi requisiti senza aprire la pagina dei dettagli della voce per esaminare lo schema o i metadati allegati.
- Identifica le corrispondenze a livello di colonna: quando cerchi flag di dati sensibili (come informazioni che consentono l'identificazione personale o PII), termini aziendali o nomi di colonne specifici, i tag di spiegabilità mostrano le colonne dello schema esatte associate a questi elementi.
- Riduci gli ostacoli alla ricerca: la visualizzazione del contesto corrispondente direttamente nelle schede dei risultati di ricerca riduce la necessità di spostarsi avanti e indietro tra i risultati di ricerca e le singole pagine degli asset.
- Perfeziona le query di ricerca: il feedback dei tag corrispondenti ti aiuta a determinare se la query era troppo generica, consentendoti di perfezionare la ricerca con qualificatori o filtri dei metadati specifici.
Come funziona la spiegabilità dei risultati di ricerca
La spiegabilità dei risultati di ricerca viene gestita nella console Google Cloud anziché dall'API di ricerca.
Quando invii una query di ricerca nella console Google Cloud , si verifica il seguente processo:
- L'API di ricerca valuta la query e restituisce le voci corrispondenti.
- La console Google Cloud recupera la rappresentazione del metastore di ogni voce restituita.
- La console Google Cloud esegue la corrispondenza delle parole chiave tra i termini di ricerca e i metadati della voce, come gli schemi delle colonne, gli aspetti collegati e i link ai termini del glossario aziendale.
- Quando gli elementi dei metadati corrispondono ai termini della query, la console Google Cloud mostra i tag di spiegabilità nella scheda dei risultati di ricerca.
Poiché i tag di spiegabilità vengono generati tramite la corrispondenza delle parole chiave con i metadati delle voci, riflettono solo le corrispondenze dirette con i termini di ricerca.
Le risorse o le colonne restituite dall'API di ricerca in base alla somiglianza semantica non sono evidenziate nei tag di spiegabilità. Ad esempio, se cerchi given_name, l'API di ricerca potrebbe restituire una tabella contenente una colonna denominata first_name in base al significato semantico. Tuttavia, la colonna first_name non è indicata nei tag di spiegabilità perché la corrispondenza delle parole chiave non riconosce i due termini come identici.
La tabella seguente descrive le categorie di tag di spiegabilità:
| Tag categoria | Etichetta della console | Descrizione | Esempio |
|---|---|---|---|
| Colonne nello schema | Columns: |
Corrisponde a uno o più nomi di colonna nello schema della risorsa. | Columns: customer_id |
| Aspetti della voce | Aspects: |
Corrisponde agli aspetti associati alla risorsa a livello di voce. | Aspects: Data Governance •
confidentiality: Restricted |
| Colonne con aspetti | Columns with aspects: |
Trova corrispondenze con gli aspetti associati a colonne specifiche all'interno dello schema. | Columns with aspects: phone_number / Data Governance •
contains_pii: true |
| Termini di partecipazione | Terms: |
Corrisponde ai termini del glossario aziendale collegati alla risorsa a livello di voce. | Terms: Customer Account |
| Colonne con termini | Columns with terms: |
Corrisponde ai termini del glossario aziendale collegati a colonne specifiche all'interno dello schema. | Columns with terms: user_email /
Personally Identifiable Information |
Visualizzazione e limiti dei tag
I tag di spiegabilità dei risultati di ricerca includono i seguenti elementi dell'interfaccia:
- Tooltip della guida: accanto ai tag di spiegabilità viene visualizzata un'icona di informazioni. Se passi il mouse sopra l'icona, viene visualizzato un tooltip che spiega che l'elenco mostra quali parti della risorsa corrispondono alla tua ricerca.
- Limiti e overflow dei tag: ogni categoria mostra fino a cinque tag. Se più di cinque elementi corrispondono all'interno di una singola categoria, un tag di overflow indica il conteggio rimanente (ad esempio,
...and 3 more). - Dettagli dei tag al passaggio del mouse: se passi il mouse sopra un tag di un aspetto o di un termine del glossario, viene visualizzato un tooltip con il percorso completo dell'aspetto, il nome del tipo o i dettagli del termine.
Visualizza la spiegabilità della ricerca nella console
Per cercare asset di dati e visualizzare i tag di spiegabilità, segui questi passaggi:
Nella console Google Cloud , vai alla pagina Ricerca di Knowledge Catalog.
Nel campo di ricerca, inserisci la query. Ad esempio:
- Per trovare gli asset contenenti una colonna specifica, inserisci il nome della colonna.
Ad esempio:
customer_idocolumn:customer_id. - Per trovare gli asset taggati con metadati di aspetti specifici, inserisci il valore o il predicato dell'aspetto. Ad esempio,
PIIoaspect:classification.tier=PII. - Per trovare gli asset collegati a un termine del glossario aziendale, inserisci il nome del termine.
Premi Invio per eseguire la ricerca.
- Per trovare gli asset contenenti una colonna specifica, inserisci il nome della colonna.
Ad esempio:
Nell'elenco dei risultati di ricerca, osserva i tag di spiegabilità visualizzati su ogni scheda dei risultati, situati tra il nome e la descrizione dell'asset.
(Facoltativo) Passa il mouse sopra un singolo tag per visualizzare metadati aggiuntivi, come il percorso completo dell'aspetto o il nome visualizzato del termine.
Per esaminare lo schema e i metadati completi, fai clic sul nome dell'asset per aprire la pagina dei dettagli della voce.
Nella scheda Schema, le colonne corrispondenti e gli aspetti o i termini associati vengono evidenziati.
Passaggi successivi
- Scopri come cercare asset di dati in Knowledge Catalog.
- Scopri di più sulla ricerca in Knowledge Catalog.
- Comprendi la sintassi di ricerca.
- Scopri come arricchire le voci con i metadati.
- Scopri come gestire i glossari aziendali.