Acerca de la búsqueda en Knowledge Catalog

La búsqueda en Knowledge Catalog (anteriormente, Dataplex Universal Catalog) te permite descubrir recursos en toda tu organización con consultas en lenguaje natural con coincidencias semánticas, palabras clave y predicados estructurados. Puedes buscar recursos de datos específicos, explorar metadatos relevantes en todos los sistemas o recuperar resultados con alcance para los flujos de trabajo programáticos y de agentes.

Casos de uso

En la siguiente lista, se describen casos de uso de búsqueda comunes, junto con descripciones y consultas de ejemplo:

  • Búsqueda de recursos segmentados: Busca un recurso específico con palabras clave relacionadas con el nombre, las columnas o la descripción del recurso.

    Consultas de ejemplo

    • retail_transactions_2026
    • customer_id
    • column:customer_id

  • Detección de datos amplia: Identifica los recursos relevantes en toda tu organización con consultas de lenguaje natural o palabras clave abiertas.

    Consultas de ejemplo

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

  • Recuperación de recursos con alcance para flujos de trabajo: Enumera los recursos dentro de un contenedor específico, como un proyecto, o con propiedades específicas, como el tipo o el sistema. Este enfoque se usa con frecuencia para los flujos de trabajo programáticos y de agentes.

    Consultas de ejemplo

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

Cómo funciona

La búsqueda indexa automáticamente todo el contexto de los recursos de datos que se mantienen en Knowledge Catalog. Estas son algunas de ellas:

  • Metadatos transferidos automáticamente desde fuentes de datos de Google Cloud , como BigQuery y Cloud SQL
  • Contexto de los recursos que transfieres a través de conectores e integraciones
  • Es el contexto adicional que creas para los recursos, por ejemplo, para representar el contexto empresarial o describir la semántica de los datos. El contexto también se puede capturar en forma de aspectos o términos comerciales vinculados.

Cuando se procesa tu consulta, la búsqueda aplica una combinación de concordancia semántica y de palabras clave. En la siguiente tabla, se describen los tipos de consultas que puedes usar con la búsqueda de Knowledge Catalog, junto con descripciones y consultas de ejemplo:

Tipo de consulta Uso Ejemplos
Palabra clave única Para coincidencias exactas y de subcadena en elementos de metadatos, como el nombre, la descripción y el esquema del recurso. prd_fin_invoices_fct_v02
Palabras clave parciales y fragmentos con asignación de token Busca coincidencias de subcadenas en el contenido de los metadatos y encuentra recursos incluso con términos abreviados, palabras separadas o variaciones de nombres. fin transactions 2026 (coincide con prd_fin_transactions_fy2026_raw)
Consultas de lenguaje natural Usa la coincidencia semántica sin requerir coincidencias exactas de nombres o columnas. customer churn prediction features
Predicados estructurados Combina consultas de texto libre con filtros de predicado explícitos para reducir los resultados de la búsqueda. audit logs system=bigquery
Sintaxis extendida Para realizar una búsqueda precisa, limitada a un alcance específico La sintaxis extendida se usa con mayor frecuencia en casos de uso de agentes y programáticos. Para obtener más información, consulta Sintaxis de búsqueda. (system:bigquery OR system:spanner) AND column:credit_card_number aspect:classification.tier=PII -projectid:sandbox-project

Tienes las siguientes opciones para acceder a la búsqueda en Knowledge Catalog:

Alcance de la búsqueda

Los resultados de la búsqueda en Knowledge Catalog respetan los permisos que tienes sobre los recursos correspondientes en los sistemas de origen.

Por ejemplo, si tienes acceso de lectura a los metadatos de BigQuery de un objeto, este aparecerá en los resultados de la búsqueda de Knowledge Catalog. Si tienes acceso a una tabla de BigQuery, pero no al conjunto de datos que la contiene, la tabla seguirá apareciendo como se espera en la búsqueda de Knowledge Catalog.

De forma predeterminada, la búsqueda se limita a tu organización. Los resultados solo incluyen recursos de la misma organización que el proyecto en el que realizas la búsqueda.

Los resultados de la búsqueda solo incluyen los recursos que pertenecen al mismo perímetro de Controles del servicio de VPC que el proyecto en el que se realiza la búsqueda. Cuando usas la consola deGoogle Cloud , este es el proyecto que se selecciona en la consola.

Para ampliar el alcance de los resultados de la búsqueda más allá de los recursos dentro del perímetro de los Controles del servicio de VPC de tu proyecto, usa las reglas de entrada y salida de los Controles del servicio de VPC. Estas reglas facilitan el intercambio de datos privado y eficiente en toda tu organización. Puedes configurar reglas de entrada y salida con la consola deGoogle Cloud o a través de archivos JSON o YAML. Consulta el siguiente ejemplo de YAML y la documentación de los Controles del servicio de VPC para adaptar la regla a tus requisitos específicos.

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

Para obtener más información sobre los roles de Identity and Access Management que necesitas para usar la búsqueda de Knowledge Catalog, consulta Roles de IAM de Knowledge Catalog.

Aísla los resultados de la búsqueda por entorno con los Controles del servicio de VPC

Para aislar los resultados de la búsqueda de Knowledge Catalog entre entornos, como desarrollo, prueba y producción, configura perímetros de Controles del servicio de VPC independientes para cada entorno. Asigna los proyectos que contienen los recursos de datos y los proyectos que se usan para realizar búsquedas al perímetro del entorno correspondiente. Las búsquedas que se realizan desde un proyecto dentro de un perímetro específico solo devuelven resultados para los recursos que se encuentran dentro de ese mismo perímetro.

Limitaciones de la recuperación en la búsqueda

La búsqueda de Knowledge Catalog se optimiza para el descubrimiento exploratorio en lugar de la recuperación exhaustiva del inventario, por lo que las búsquedas no garantizan una recuperación completa. Una consulta puede omitir resultados coincidentes, y los resultados devueltos pueden variar en las consultas repetidas.

Causas de la pérdida de recuperación

Cuando realizas una búsqueda, Knowledge Catalog verifica de forma dinámica tus permisos en función de un límite de control de acceso de 600 restricciones (reglas de evaluación de permisos). Si tu verificación de acceso supera este límite, el sistema detiene la verificación antes de tiempo para que las búsquedas sean rápidas. Cuando esto sucede, es posible que la búsqueda omita los recursos que coinciden.

Es más probable que alcances este límite si se cumple alguna de las siguientes condiciones:

  • Roles de IAM asignados directamente en cientos de recursos individuales.
  • Membresías en muchos Grupos de Google que otorgan acceso a recursos individuales.
  • Membresías en Grupos de Google que tienen acceso otorgado directamente en cientos de recursos individuales.

Cómo resolver las limitaciones de recuperación y los resultados faltantes

Para resolver problemas de recuperación o recuperar metadatos completos, elige el enfoque que coincida con tu objetivo:

  • Para corregir los resultados de la búsqueda faltantes o incoherentes, reduce las verificaciones de acceso totales para mantenerte por debajo del límite de 600 restricciones. Otorga acceso solo a los recursos que necesitas y quita el acceso de los recursos o Grupos de Google en los que no necesitas permisos. También puedes otorgar roles a nivel de proyecto o de carpeta, en lugar de hacerlo en recursos individuales.
  • Para recuperar un inventario de metadatos completo y garantizado, no uses la búsqueda. En su lugar, exporta metadatos a Cloud Storage y consulta el conjunto de datos completo con BigQuery.

¿Qué sigue?