Cuando buscas recursos de datos por nombres de columnas, marcas de datos sensibles (como un aspecto que indica PII) o términos del glosario empresarial, los resultados de la búsqueda suelen devolver solo la tabla o el conjunto de datos superiores. Sin saber por qué una tabla coincidió con tu consulta, debes abrir cada resultado de la búsqueda, navegar por sus pestañas de esquema o metadatos, y revisar decenas o cientos de columnas para encontrar la coincidencia.
La explicabilidad de los resultados de la búsqueda en Knowledge Catalog (antes conocido como Dataplex Universal Catalog) aborda este problema mostrando los metadatos coincidentes directamente en las tarjetas de resultados de la búsqueda en la consola deGoogle Cloud . Cuando una búsqueda coincide con las columnas del esquema de un recurso, los aspectos a nivel de entrada, los aspectos a nivel de columna o los términos vinculados del glosario empresarial, Knowledge Catalog muestra etiquetas de explicabilidad entre el título y la descripción del recurso. Con estas etiquetas, no tienes que abrir cada entrada para encontrar los campos relevantes. En cambio, puedes evaluar por qué cada recurso coincidió con tu consulta y, además, identificar las columnas relevantes de un vistazo.
En este documento, se describe cómo funciona la explicabilidad de los resultados de la búsqueda, sus beneficios, los tipos de etiquetas de explicabilidad y cómo ver la explicabilidad en la consola deGoogle Cloud .
Casos de uso y beneficios
La explicabilidad de los resultados de la búsqueda proporciona contexto y eficiencia cuando se descubren datos en toda la organización. La explicabilidad puede ayudarte a hacer lo siguiente:
- Evalúa la relevancia con rapidez: Puedes determinar si un recurso de datos devuelto cumple con tus requisitos sin abrir la página de detalles de la entrada para inspeccionar su esquema o los metadatos adjuntos.
- Identifica coincidencias a nivel de columna: Cuando buscas marcas de datos sensibles (como información de identificación personal o IIP), términos comerciales o nombres de columnas específicos, las etiquetas de explicabilidad muestran las columnas de esquema exactas asociadas con esos elementos.
- Reduce la fricción de la búsqueda: Mostrar el contexto coincidente directamente en las tarjetas de resultados de la búsqueda reduce la necesidad de navegar de un lado a otro entre los resultados de la búsqueda y las páginas de recursos individuales.
- Define mejor las búsquedas: Los comentarios de las etiquetas coincidentes te ayudan a determinar si tu búsqueda fue demasiado amplia, lo que te permite definir mejor tu búsqueda con calificadores específicos o filtros de metadatos.
Cómo funciona la explicabilidad de los resultados de la búsqueda
La explicabilidad de los resultados de la búsqueda se controla en la consola de Google Cloud , no en la API de Search.
Cuando envías una búsqueda en la consola de Google Cloud , se produce el siguiente proceso:
- La API de búsqueda evalúa tu consulta y devuelve las entradas que coinciden.
- La consola de Google Cloud recupera la representación del almacén de metadatos de cada entrada que se devuelve.
- La consola de Google Cloud realiza una concordancia de palabras clave entre tus términos de búsqueda y los metadatos de la entrada, como los esquemas de columnas, los aspectos adjuntos y los vínculos de términos del glosario empresarial.
- Cuando los elementos de metadatos coinciden con los términos de tu consulta, la consola de Google Cloud renderiza etiquetas de explicabilidad en la tarjeta de resultados de la búsqueda.
Debido a que las etiquetas de explicabilidad se generan a través de la concordancia de palabras clave con
los metadatos de entrada, solo reflejan las coincidencias directas con tus términos de búsqueda.
Los recursos o las columnas que devuelve la API de búsqueda en función de la similitud semántica
no se destacan en las etiquetas de explicabilidad. Por ejemplo, si buscas
given_name, la API de Search podría devolver una tabla que contenga una columna llamada
first_name según el significado semántico. Sin embargo, la columna first_name no se indica en las etiquetas de explicabilidad porque la concordancia de palabras clave no reconoce los dos términos como idénticos.
En la siguiente tabla, se describen las categorías de las etiquetas de explicabilidad:
| Categoría de la etiqueta | Etiqueta de la consola | Descripción | Ejemplo |
|---|---|---|---|
| Columnas en el esquema | Columns: |
Coincide con uno o más nombres de columna en el esquema del recurso. | Columns: customer_id |
| Aspectos de la entrada | Aspects: |
Coincide con los aspectos adjuntos al recurso a nivel de la entrada. | Aspects: Data Governance •
confidentiality: Restricted |
| Columnas con aspectos | Columns with aspects: |
Coincide con los aspectos adjuntos a columnas específicas dentro del esquema. | Columns with aspects: phone_number / Data Governance •
contains_pii: true |
| Condiciones de entrada | Terms: |
Coincide con los términos del glosario empresarial vinculados al recurso a nivel de la entrada. | Terms: Customer Account |
| Columnas con términos | Columns with terms: |
Coincide con los términos del glosario empresarial vinculados a columnas específicas dentro del esquema. | Columns with terms: user_email /
Personally Identifiable Information |
Visualización y límites de las etiquetas
Las etiquetas de explicabilidad de los resultados de la búsqueda incluyen los siguientes elementos de la interfaz:
- Cuadro de información de ayuda: Aparece un ícono de información junto a las etiquetas de explicabilidad. Si colocas el cursor sobre el ícono, se muestra un cuadro de información que explica que la lista muestra qué partes del recurso coincidieron con tu búsqueda.
- Límites y desbordamiento de etiquetas: Cada categoría muestra hasta cinco etiquetas. Si coinciden más de cinco elementos en una sola categoría, una etiqueta de desbordamiento indica el recuento restante (por ejemplo,
...and 3 more). - Detalles de la etiqueta cuando se coloca el cursor sobre ella: Cuando se coloca el cursor sobre una etiqueta de aspecto o término del glosario, se muestra un cuadro de información con la ruta de acceso completa del aspecto, el nombre del tipo o los detalles del término.
Consulta la explicabilidad de la búsqueda en la consola
Para buscar recursos de datos y ver las etiquetas de explicabilidad, sigue estos pasos:
En la consola de Google Cloud , ve a la página Búsqueda de Knowledge Catalog.
En el campo de búsqueda, ingresa tu consulta. Por ejemplo:
- Para encontrar recursos que contengan una columna específica, ingresa el nombre de la columna.
Por ejemplo,
customer_idocolumn:customer_id. - Para encontrar recursos etiquetados con metadatos de aspectos específicos, ingresa el valor o el predicado del aspecto. Por ejemplo,
PIIoaspect:classification.tier=PII. - Para encontrar los recursos vinculados a un término del glosario empresarial, ingresa el nombre del término.
Presiona Intro para ejecutar la búsqueda.
- Para encontrar recursos que contengan una columna específica, ingresa el nombre de la columna.
Por ejemplo,
En la lista de resultados de la búsqueda, observa las etiquetas de explicabilidad que se renderizan en cada tarjeta de resultado, ubicadas entre el nombre y la descripción del recurso.
Opcional: Coloca el cursor sobre una etiqueta individual para ver metadatos adicionales, como la ruta de acceso completa del aspecto o el nombre visible del término.
Para inspeccionar el esquema y los metadatos completos, haz clic en el nombre del recurso para abrir la página de detalles de la entrada.
En la pestaña Esquema, aparecen destacadas las columnas coincidentes y los aspectos o términos asociados.
¿Qué sigue?
- Aprende a buscar recursos de datos en Knowledge Catalog.
- Obtén más información sobre la búsqueda en Knowledge Catalog.
- Comprende la sintaxis de búsqueda.
- Obtén información para enriquecer entradas con metadatos.
- Obtén más información para administrar glosarios empresariales.