Acerca de la búsqueda en Knowledge Catalog

Usa la búsqueda de Knowledge Catalog (antes Dataplex Universal Catalog) para descubrir recursos en tu organización con consultas en lenguaje natural con concordancia semántica, palabras clave y predicados estructurados.

Casos de uso

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

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

    Consultas de ejemplo

    • retail_transactions_2026
    • customer_id
    • column:customer_id

  • Descubrimiento de datos amplios: Identifica recursos relevantes en tu organización con consultas de lenguaje natural o de palabras clave de respuesta abierta.

    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 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 Google Cloud fuentes de datos como BigQuery y Cloud SQL
  • Contexto para los recursos que transfieres a través de conectores e integraciones
  • Contexto adicional que creas para los recursos, por ejemplo, que representa el contexto empresarial o describe la semántica de los datos. El contexto también se puede capturar en forma de aspectos o términos comerciales vinculados.

Cuando 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 la concordancia exacta y de subcadenas en los elementos de metadatos, como el nombre, la descripción y el esquema del recurso prd_fin_invoices_fct_v02
Palabras clave parciales y fragmentos tokenizados Coincide con las 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 en lenguaje natural Usa la concordancia semántica sin requerir coincidencias exactas de nombres o columnas customer churn prediction features
Predicados estructurados Combina consultas de texto libre con filtros de predicados explícitos para restringir los resultados de la búsqueda. audit logs system=bigquery
Sintaxis extendida Para una búsqueda precisa, restringida a un alcance específico. La sintaxis extendida se usa con mayor frecuencia en casos de uso programáticos y de agentes. 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 de metadatos de BigQuery a un objeto, ese objeto 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 contiene esa tabla, 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 incluyen solo recursos de la misma organización que el proyecto en el que realizas la búsqueda.

Los resultados de la búsqueda incluyen solo aquellos 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 se usa la Google Cloud consola, 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 Controles del servicio de VPC de tu proyecto, usa las reglas de entrada y salida de 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 Google Cloud consola o a través de archivos JSON o YAML. Consulta el siguiente ejemplo de YAML y la documentación de 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 el desarrollo, la prueba y la producción, configura perímetros de Controles del servicio de VPC separados 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 muestran resultados para los recursos que se encuentran dentro de ese mismo perímetro.

Limitaciones de 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 consultas de búsqueda no garantizan la recuperación completa. Una consulta puede omitir resultados coincidentes, y los resultados que se muestran pueden variar en las consultas repetidas.

Causas de la pérdida de recuperación

Cuando buscas, 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 deja de verificar antes para mantener la velocidad de las búsquedas. Cuando eso sucede, la búsqueda puede omitir recursos coincidentes.

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

Resuelve 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 resultados de la búsqueda faltantes o incoherentes: Reduce tus verificaciones de acceso totales para mantenerte por debajo del límite de 600 restricciones. Otorga acceso solo a los recursos que necesites y quita el acceso de los recursos o Grupos de Google en los que no necesites permisos. También puedes otorgar roles a nivel de proyecto o carpeta en lugar de 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?