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 los 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 concordancias exactas de nombres o columnas customer churn prediction features
Predicados estructurados Combina consultas de texto libre con filtros de predicados explícitos para limitar los resultados de la búsqueda audit logs system=bigquery
Sintaxis extendida Para una búsqueda precisa, limitada 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 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 Google Cloud consola 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 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 la recuperación en la búsqueda

Las consultas de búsqueda de Knowledge Catalog no garantizan la recuperación completa, lo que significa que es posible que la búsqueda no muestre resultados que coincidan con tu consulta. Además, los resultados mostrados (y no mostrados) pueden variar si repites las consultas de búsqueda.

Para consultar todos los metadatos de Knowledge Catalog, puedes exportarlos a Cloud Storage y, luego, consultarlos desde BigQuery. Para obtener más información, consulta Exporta metadatos.

¿Qué sigue?