Este documento está destinado a los consumidores de productos de datos que desean descubrir y usar productos de datos para sus casos de uso.
Para obtener más información sobre la arquitectura y los conceptos clave de los productos de datos, consulta Acerca de los productos de datos.
Antes de comenzar
-
Habilita las APIs de Dataplex y BigQuery.
Roles necesarios para habilitar las APIs
Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (
roles/serviceusage.serviceUsageAdmin), que contiene el permisoserviceusage.services.enable. Obtén más información para otorgar roles.
Roles obligatorios
Para obtener los permisos que necesitas para buscar, acceder y usar productos de datos, pídele a tu administrador que te otorgue los siguientes roles de IAM en el producto de datos o el proyecto:
-
Buscar productos de datos:
Visualizador del 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:
Visualizador de productos de datos de Dataplex (
roles/dataplex.dataProductsViewer)
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.
Como consumidor de productos 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 en un producto de datos,
necesitas el rol de visualizador de metadatos de BigQuery (roles/bigquery.metadataViewer).
Para obtener más información, consulta
Roles obligatorios para acceder a los resultados de la búsqueda.
Busca productos de datos
Console
En la Google Cloud consola de, ve a la página Búsqueda de Dataplex Universal Catalog.
Busca con palabras clave o lenguaje natural. Para obtener más información, consulta Busca recursos.
En los resultados de la búsqueda, haz clic en el producto de datos cuyos detalles deseas ver. Puedes revisar la descripción, los recursos, el contrato, los aspectos y otra documentación asociada con el producto de datos.
REST
Para buscar un producto de datos, usa el
searchEntries
método.
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"
Reemplaza lo siguiente:
- 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 Google Cloud proyecto en el que se crea el producto de datos
Solicita acceso a productos de datos
Como consumidor de productos de datos, si no tienes acceso a un producto de datos, puedes solicitarlo completando los siguientes pasos:
En la Google Cloud consola de, ve a la página Productos de datos de Dataplex Universal Catalog.
Haz clic en el producto de datos al que deseas acceder.
Haz clic en Solicitar acceso.
En el panel Detalles de la solicitud, especifica lo siguiente:
- Tipo de acceso: Selecciona el acceso que buscas.
- Mensaje: Proporciona una justificación para la solicitud de acceso.
Haz clic en Enviar. Se abrirá automáticamente un nuevo borrador de correo electrónico en tu aplicación de correo electrónico predeterminada (como Gmail o Outlook) con la dirección del destinatario y una línea de asunto y un cuerpo del mensaje completados previamente.
Revisa el contenido del correo electrónico generado automáticamente, que contiene los detalles de tu solicitud.
Para enviar la solicitud de acceso al propietario del producto de datos para su aprobación, haz clic en Enviar.
El propietario del producto de datos recibe tu correo electrónico y revisa tu solicitud. Espera una notificación por correo electrónico que confirme que se aprobó o rechazó tu solicitud de acceso.
Una vez que se apruebe, obtendrás acceso al producto de datos y podrás comenzar a usarlo en Dataplex Universal Catalog.
Consume productos de datos
Para usar un producto de datos, asegúrate de tener los permisos necesarios. Consulta Solicita acceso a productos de datos.
Después de que el propietario del producto de datos te otorgue permiso, podrás acceder al producto de datos y a sus recursos. Por ejemplo, si se te otorgan permisos para acceder a una tabla de BigQuery, puedes consultarla directamente en BigQuery para generar estadísticas.
Para acceder a un producto de datos y usarlo, sigue estos pasos:
- Busca el producto de datos.
- En los resultados de la búsqueda, haz clic en el producto de datos que quieres usar.
- Haz clic en la pestaña Recursos.
- Haz clic en el recurso cuyos detalles deseas ver. Se abrirá la página de detalles de la entrada. Puedes acceder a detalles como el esquema, las estadísticas y el linaje. Si el recurso es una tabla o vista de BigQuery, puedes hacer clic en Abrir en BigQuery para navegar a BigQuery Studio y consultar los resultados.
¿Qué sigue?
- Obtén información sobre los conceptos clave de los productos de datos.
- Obtén información para crear un producto de datos.
- Obtén más información sobre la administración de productos de datos.