Usa dominios de datos

Como usuario de un dominio de datos, puedes usar los dominios de datos para limitar los resultados de la búsqueda a contextos comerciales específicos, buscar conjuntos de datos, tablas y productos de datos de BigQuery, y descubrir metadatos dentro de límites de dominio específicos.

Antes de comenzar

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

Habilita las APIs

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

Roles necesarios para habilitar las APIs

Para habilitar 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 obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más 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 el 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.

Cómo explorar la jerarquía de dominios

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

Cómo encontrar recursos dentro de un dominio de datos

Para buscar recursos con 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 para el que deseas limitar los resultados. Si es necesario, agrega filtros adicionales.

Como alternativa, puedes usar la opción del 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 dominio aplicado.

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

REST

Para buscar entradas que se limiten a un dominio de datos, usa el método projects.locations.searchEntries y proporciona la ruta de 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 búsqueda (o global).
  • QUERY: Es la cadena de consulta.
  • DOMAIN_ID: Es el identificador único del dominio de datos que define el contexto del alcance de la 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.

Limitaciones

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

Supongamos que se incluye un conjunto de datos de BigQuery 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 del dominio y no tienes acceso directo en BigQuery.

¿Qué sigue?