Explicabilidade dos resultados da pesquisa

Quando você pesquisa recursos de dados por nomes de colunas, sinalizações de dados sensíveis (como um aspecto que indica PII) ou termos do glossário empresarial, os resultados da pesquisa tradicionalmente retornam apenas a tabela ou o conjunto de dados pai. Sem saber por que uma tabela correspondeu à consulta, você precisa abrir cada resultado da pesquisa, navegar pelas guias de esquema ou metadados e inspecionar dezenas ou centenas de colunas para localizar a correspondência.

A explicabilidade dos resultados da pesquisa no Knowledge Catalog (antigo Dataplex Universal Catalog) resolve esse problema mostrando os metadados correspondentes diretamente nos cards de resultados da pesquisa no console doGoogle Cloud . Quando uma consulta de pesquisa corresponde às colunas de esquema de um recurso, aos aspectos no nível da entrada, aos aspectos no nível da coluna ou aos termos do glossário empresarial vinculados, o Knowledge Catalog exibe tags de explicabilidade entre o título e a descrição do recurso. Com essas tags, não é necessário abrir todas as entradas para encontrar campos relevantes. Em vez disso, é possível avaliar por que cada recurso correspondeu à sua consulta e identificar as colunas relevantes rapidamente.

Neste documento, descrevemos como funciona a explicabilidade dos resultados da pesquisa, os benefícios, os tipos de tags de explicabilidade e como visualizar a explicabilidade no console doGoogle Cloud .

Casos de uso e benefícios

A explicabilidade dos resultados da pesquisa oferece contexto e eficiência ao descobrir dados em toda a organização. A explicabilidade pode ajudar você a:

  • Avaliar a relevância rapidamente: é possível determinar se um recurso de dados retornado atende aos seus requisitos sem abrir a página de detalhes da entrada para inspecionar o esquema ou os metadados anexados.
  • Identificar correspondências no nível da coluna: quando você pesquisa sinalizações de dados sensíveis (como informações de identificação pessoal ou PII), termos comerciais ou nomes de colunas específicos, as tags de explicabilidade mostram as colunas exatas do esquema associadas a esses elementos.
  • Reduzir o atrito na pesquisa: mostrar o contexto correspondente diretamente nos cards de resultados da pesquisa reduz a necessidade de navegar entre os resultados da pesquisa e as páginas de recursos individuais.
  • Refinar consultas de pesquisa: o feedback das tags correspondentes ajuda a determinar se a consulta foi muito ampla, permitindo que você refine a pesquisa com qualificadores específicos ou filtros de metadados.

Como funciona a explicabilidade dos resultados da pesquisa

A explicabilidade do resultado da pesquisa é processada no console do Google Cloud , e não pela API de pesquisa.

Quando você envia uma consulta de pesquisa no console do Google Cloud , ocorre o seguinte processo:

  1. A API de pesquisa avalia sua consulta e retorna as entradas correspondentes.
  2. O console do Google Cloud busca a representação do metastore de cada entrada retornada.
  3. O console do Google Cloud faz a correspondência de palavras-chave entre os termos de pesquisa e os metadados da entrada, como esquemas de coluna, aspectos anexados e links de termos do glossário empresarial.
  4. Quando os elementos de metadados correspondem aos termos da consulta, o console do Google Cloud renderiza tags de explicabilidade no card de resultados da pesquisa.

Como as tags de explicabilidade são geradas pela correspondência de palavras-chave com metadados de entrada, elas refletem apenas correspondências diretas com seus termos de pesquisa. Os recursos ou as colunas retornados pela API de pesquisa com base na semelhança semântica não são destacados nas tags de explicabilidade. Por exemplo, se você pesquisar given_name, a API de pesquisa poderá retornar uma tabela com uma coluna chamada first_name com base no significado semântico. No entanto, a coluna first_name não é indicada nas tags de explicabilidade porque a correspondência de palavras-chave não reconhece os dois termos como idênticos.

A tabela a seguir descreve as categorias de tags de explicabilidade:

Categoria de tag Rótulo do console Descrição Exemplo
Colunas no esquema Columns: Corresponde a um ou mais nomes de coluna no esquema do recurso. Columns: customer_id
Aspectos na entrada Aspects: Corresponde aos aspectos anexados ao recurso no nível da entrada. Aspects: Data Governance • confidentiality: Restricted
Colunas com aspectos Columns with aspects: Corresponde aos aspectos anexados a colunas específicas no esquema. Columns with aspects: phone_number / Data Governance • contains_pii: true
Termos na entrada Terms: Corresponde aos termos do glossário empresarial vinculados ao recurso no nível da entrada. Terms: Customer Account
Colunas com termos Columns with terms: Corresponde aos termos do glossário empresarial vinculados a colunas específicas no esquema. Columns with terms: user_email / Personally Identifiable Information

Exibição e limites de tags

As tags de explicabilidade dos resultados da pesquisa incluem os seguintes elementos de interface:

  • Dica de ajuda: um ícone de informações aparece ao lado das tags de explicabilidade. Passe o cursor sobre o ícone para exibir uma dica explicando que a lista mostra quais partes do recurso correspondem à sua pesquisa.
  • Limites e excesso de tags: cada categoria mostra até cinco tags. Se mais de cinco itens corresponderem a uma única categoria, uma tag de estouro vai indicar a contagem restante (por exemplo, ...and 3 more).
  • Detalhes da tag ao passar o cursor: ao passar o cursor sobre uma tag de aspecto ou termo do glossário, uma dica é exibida com o caminho completo do aspecto, o nome do tipo ou os detalhes do termo.

Ver a explicabilidade da pesquisa no console

Para pesquisar recursos de dados e conferir tags de explicabilidade, siga estas etapas:

  1. No console Google Cloud , acesse a página Pesquisa do Knowledge Catalog.

    Acesse Pesquisar

  2. No campo de pesquisa, digite sua consulta. Exemplo:

    • Para encontrar recursos que contêm uma coluna específica, digite o nome dela. Por exemplo, customer_id ou column:customer_id.
    • Para encontrar recursos marcados com metadados de aspecto específicos, insira o valor ou o predicado do aspecto. Por exemplo, PII ou aspect:classification.tier=PII.
    • Para encontrar recursos vinculados a um termo do glossário empresarial, digite o nome do termo.

    Pressione Enter para executar a pesquisa.

  3. Na lista de resultados da pesquisa, observe as tags de explicabilidade renderizadas em cada card de resultado, localizadas entre o nome e a descrição do recurso.

  4. Opcional: passe o cursor sobre uma tag individual para ver mais metadados, como o caminho completo do aspecto ou o nome de exibição do termo.

  5. Para inspecionar o esquema e os metadados completos, clique no nome do recurso para abrir a página de detalhes da entrada.

    Na guia Esquema, as colunas correspondentes e os aspectos ou termos associados aparecem destacados.

A seguir