Usa dominios de datos

Vista previa

Este producto o esta función se encuentra sujeto a las "Condiciones de la oferta de la fase previa a la DG" en la sección Condiciones del servicio generales de las Condiciones específicas del servicio. Los productos y las funciones de la fase previa a la DG están disponibles “tal como están” y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Como usuario del dominio de datos, puedes usar dominios de datos para limitar los resultados de la búsqueda a contextos empresariales 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 y las APIs necesarios habilitados.

Habilita las APIs

Habilitar la API de Dataplex

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 Propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol 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:

• Ver metadatos de entradas de dominio para el descubrimiento: Lector de entradas de dominios de datos de Dataplex (roles/dataplex.dataDomainEntryReader)
• Ver configuraciones y vinculaciones de dominio: Visualizador de configuración de dominios de datos de Dataplex (roles/dataplex.dataDomainViewer)

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 mediante 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 Cómo ver dominios y subdominios de datos en una ubicación.

Busca recursos dentro de un dominio de datos

Para buscar recursos con un dominio, sigue estos pasos:

Console

1. En la Google Cloud consola de, 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 de la lista.

5. En el campo Seleccionar dominio, selecciona 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 Google Cloud consola de, ve a la página Dominios de datos.

   Ir a Dominios de datos

2. Selecciona Buscar en el dominio en el menú more_vert. 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 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.

Nota: La ubicación en la ruta de acceso para searchEntries puede ser global (para la distribución completa) o una región específica según la configuración de tu backend de búsqueda.

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

• PROJECT_ID: Es el ID de tu Google Cloud proyecto.
• 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 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:

curl (Linux, macOS o Cloud Shell)

Nota: Con el siguiente comando, se supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login , o a través del uso de Cloud Shell, que accede de forma automática a gcloud CLI . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json, y ejecuta el siguiente comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries"

PowerShell (Windows)

Nota: El siguiente comando supone que accediste a gcloud CLI con tu cuenta de usuario a través de la ejecución de gcloud init o gcloud auth login . Para comprobar la cuenta activa actual, ejecuta gcloud auth list.

Guarda el cuerpo de la solicitud en un archivo llamado request.json, y ejecuta el siguiente comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries" | Select-Object -Expand Content

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 visibilidad del dominio. Solo ves 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 del dominio y no tienes acceso directo en BigQuery.

¿Qué sigue?

• Obtén más información sobre los dominios de datos.
• Obtén información para crear dominios de datos.
• Obtén información para administrar recursos de dominios de datos.