Este documento está dirigido a los consumidores de productos de datos que quieran descubrir y usar productos de datos para sus casos prácticos.
Para obtener más información sobre la arquitectura y los conceptos clave de los productos de datos, consulta el artículo Acerca de los productos de datos.
Antes de empezar
-
Enable the Dataplex, BigQuery APIs.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.
Roles obligatorios
Para obtener los permisos que necesitas para buscar, acceder y usar productos de datos, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el producto de datos o en el proyecto:
-
Buscar productos de datos:
Visor de catálogo de Dataplex (
roles/dataplex.catalogViewer) -
Buscar recursos de datos y solicitar acceso:
Consumidor de productos de datos de Dataplex (
roles/dataplex.dataProductsConsumer) -
Acceso de solo lectura para ver las definiciones y los metadatos de los productos de datos:
Visor de productos de datos de Dataplex (
roles/dataplex.dataProductsViewer)
Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.
También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.
Como consumidor de un producto de datos, para ver los metadatos de un recurso, debes tener el permiso viewer para acceder al recurso correspondiente en el sistema de origen. Por ejemplo, para buscar metadatos de un conjunto de datos o una tabla de un producto de datos, necesitas el rol Lector de metadatos de BigQuery (roles/bigquery.metadataViewer). Para obtener más información, consulta Roles necesarios para acceder a los resultados de búsqueda.
Buscar productos de datos
Consola
En la Google Cloud consola, ve a la página Búsqueda de Dataplex Universal Catalog.
Buscar usando palabras clave o lenguaje natural. Para obtener más información, consulta Buscar recursos.
En los resultados de búsqueda, haz clic en el producto de datos del que quieras ver los detalles. Puede consultar la descripción, los recursos, el contrato, los aspectos y otra documentación asociada al producto de datos.
REST
Para buscar un producto de datos, utiliza el método searchEntries.
Por ejemplo, envía la siguiente solicitud POST:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d \
'{
"query": "ADDITIONAL_KEYWORDS (type=(DATA_PRODUCT))",
"pageSize": 10
}' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/global:searchEntries"
Haz los cambios siguientes:
- ADDITIONAL_KEYWORDS (opcional): cualquier palabra clave o criterio de búsqueda adicional para acotar los resultados (por ejemplo,
displayName:'My Data Product'odescription:'sales'). - PROJECT_ID: el ID de tu proyecto de Google Cloud en el que se crea el producto de datos
Solicitar acceso a productos de datos
Si eres consumidor de un producto de datos y no tienes acceso a él, puedes solicitarlo siguiendo estos pasos:
En la Google Cloud consola, ve a la página Productos de datos de Dataplex Universal Catalog.
Haz clic en el producto de datos al que quieras acceder.
Haz clic en Solicitar acceso.
En el panel Detalles de la solicitud, especifica lo siguiente: