Usa dominios de datos

Los dominios de datos en Knowledge Catalog (anteriormente, Dataplex Universal Catalog) te permiten limitar los resultados de la búsqueda a contextos empresariales específicos y descubrir metadatos dentro de límites definidos. Como usuario de dominio de datos, puedes explorar la jerarquía del dominio, buscar recursos del dominio y recuperar el contexto del dominio para fundamentar los agentes de IA.

Antes de comenzar

Antes de realizar una búsqueda por dominio, asegúrate de tener habilitados los roles y las APIs necesarios.

Habilita las APIs

Habilita la API de Dataplex si aún no está habilitada.

Roles necesarios para habilitar las APIs

Para habilitar las APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtenerlo a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén información para otorgar roles.

Habilitar la API

Roles obligatorios

Para obtener los permisos que necesitas para buscar y descubrir metadatos con dominios de datos, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto o dominio de datos:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Explora la jerarquía de dominios

Para obtener más información sobre cómo explorar la jerarquía de dominios, consulta Visualiza dominios y subdominios de datos en una ubicación.

Encuentra recursos dentro de un dominio de datos

Puedes buscar dentro de un dominio de datos para encontrar recursos, como conjuntos de datos, tablas y productos de datos de BigQuery, y ver sus metadatos. Para buscar recursos dentro de un dominio, sigue estos pasos:

Console

  1. En la consola de Google Cloud , ve a la página Knowledge Catalog > Búsqueda.

    Ir a Búsqueda

  2. Haz clic en Probar la búsqueda natural para activar la función de búsqueda natural.

  3. Haz clic en Filtros.

  4. En el campo Alcance, selecciona Dominio en la lista.

  5. En el campo Seleccionar dominio, elige el dominio al que deseas limitar los resultados. Agrega filtros adicionales si es necesario.

Como alternativa, puedes usar la opción de menú Buscar en el dominio para encontrar recursos en el dominio:

  1. En la consola de Google Cloud , ve a la página Dominios de datos.

    Ir a Dominios de datos

  2. Selecciona Buscar en el dominio en el menú . Esta acción abre automáticamente una ventana de búsqueda con el filtro domain aplicado.

  3. Usa el campo de búsqueda para encontrar recursos en el dominio.

REST

Para buscar entradas con alcance en un dominio de datos, usa el método projects.locations.searchEntries y proporciona la ruta de acceso del dominio en el parámetro contexts.

Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:

  • PROJECT_ID: Es el ID de tu proyecto de Google Cloud .
  • LOCATION_ID: Es la región de la consulta de búsqueda (o global).
  • QUERY: Es la cadena de consulta de búsqueda.
  • DOMAIN_ID: Es el identificador único del dominio de datos que define el contexto del permiso de búsqueda.

Método HTTP y URL: 

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries

Cuerpo JSON de la solicitud:

{
  "query": "QUERY",
  "contexts": [ "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" ],
  "semantic_search": true,
  "page_size": 100
}

Para enviar tu solicitud, expande una de estas opciones:

Deberías recibir un código de estado exitoso (2xx) y una respuesta vacía.

Recupera el contexto de los dominios de datos

Puedes usar el método lookupContext para fundamentar los agentes de IA en el contexto empresarial que capturan tus dominios de datos. El método lookupContext admite dominios de datos de las siguientes maneras:

  • Contexto para un dominio de datos. Puedes pasar la entrada que representa un dominio de datos en la lista resources. La respuesta contiene los metadatos del dominio de datos, como su descripción y los dominios de datos superiores en la jerarquía de dominios.
  • Pertenencia al dominio de datos de los recursos de datos. Cuando recuperas el contexto de un recurso de datos que se incluye en uno o más dominios de datos, la respuesta contiene un campo dataDomains que enumera los dominios de datos a los que pertenece el recurso, comenzando por el dominio más específico y ascendiendo al dominio de nivel superior.

Para recuperar el contexto de un dominio de datos, envía la siguiente solicitud:

curl --request POST \
  'https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:lookupContext' \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H 'Content-Type: application/json' \
  -d '{
    "resources": [
      "projects/PROJECT_ID/locations/LOCATION/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION/dataDomains/DATA_DOMAIN_ID"
    ],
    "options": {
      "format": "yaml"
    }
  }'

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto que contiene el dominio de datos.
  • PROJECT_NUMBER: Es el número del proyecto que contiene el dominio de datos.
  • LOCATION: Es la ubicación del dominio de datos.
  • DATA_DOMAIN_ID: Es el ID del dominio de datos.

Para obtener más información sobre el método lookupContext, consulta Recupera el contexto de los recursos de datos.

Limitaciones

Cuando buscas recursos fuera del contexto del dominio, por ejemplo, cuando usas una búsqueda global, no se aplican los permisos de visibilidad del dominio. Solo verás los recursos a los que tienes acceso en el sistema subyacente, como BigQuery.

Supongamos que un conjunto de datos de BigQuery se incluye en un dominio de datos. Tienes el rol Dataplex Data Domain Entry Reader para el dominio, pero no tienes permiso directo para ver el conjunto de datos en BigQuery:

  • Búsqueda dentro del dominio: Ves el conjunto de datos en los resultados de la búsqueda porque se aplican los permisos del dominio.
  • Búsqueda fuera del dominio: No ves el conjunto de datos en los resultados de la búsqueda. En una búsqueda general, no se aplican los permisos de dominio y no tienes acceso directo en BigQuery.

¿Qué sigue?