Administra productos de datos

Versión preliminar

Este producto o función está con sujeción a las "Condiciones de las Ofertas de la Fase Previa a la DG" de la sección de Términos Generales del Servicio de los Términos Específicos del Servicio. Los productos y las funciones de la fase previa a la DG están disponibles sin modificaciones y pueden estar sujetos a asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

Este documento está dirigido a los propietarios de productos de datos que desean actualizar, borrar y otorgar acceso a los productos de datos en Dataplex Universal Catalog.

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

1. 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 the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

Nota: En esta guía, se supone que ya tienes productos de datos existentes para administrar. Para obtener más información sobre cómo crear y configurar productos de datos, consulta Crea productos de datos.

Roles obligatorios

Para obtener los permisos que necesitas para administrar productos de datos, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

• Permisos completos para crear, actualizar, borrar y administrar permisos para productos de datos: Administrador de productos de datos de Dataplex (roles/dataplex.dataProductsAdmin)
• Actualiza y administra los productos de datos existentes: Editor de productos de datos de Dataplex (roles/dataplex.dataProductsEditor)
• Agrega aspectos como schema, overview y contacts: Propietario de entradas y vínculo de entrada de Dataplex (roles/dataplex.entryOwner)
• Busca y agrega recursos: Visualizador del catálogo de Dataplex (roles/dataplex.catalogViewer)
• Edita los tipos de aspectos del sistema, como la documentación y el aspecto del contrato de la cadencia de actualización: Editor de Dataplex Catalog (roles/dataplex.catalogEditor)

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

Estos roles predefinidos contienen los permisos necesarios para administrar los productos de datos. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para administrar productos de datos:

• Edita el tipo de aspecto del sistema overview: dataplex.entryGroups.useOverviewAspect
• Edita el tipo de aspecto del sistema refresh cadence: dataplex.entryGroups.useRefreshCadenceAspect

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Otorga acceso a un producto de datos

Los propietarios de productos de datos deben hacer que sus productos sean detectables y otorgar los roles necesarios, lo que permite que los consumidores busquen, vean y soliciten acceso a los productos de datos.

Para otorgar a los consumidores de productos de datos los permisos que necesitan para interactuar con el producto de datos, otórgales los siguientes roles de IAM en el recurso del producto de datos:

• Buscar productos de datos y acceder a ellos en la búsqueda de Dataplex Universal Catalog: Consumidor de productos de datos de Dataplex (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 (dataplex.dataProductsViewer)
• Solicita acceso a los productos de datos: Consumidor de productos de datos de Dataplex (dataplex.dataProductsConsumer)

Cuando un consumidor de productos de datos solicita acceso a un producto de datos, el propietario del producto de datos recibe una notificación por correo electrónico.

Para otorgar acceso, sigue estos pasos:

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

   Ir a la página Grupos

2. Busca el grupo asociado con el nivel de permiso solicitado y selecciónalo.

3. Haz clic en  Agregar miembros.

4. Agrega la principal.

5. Haz clic en Guardar.

Para obtener más información, consulta Crea y administra grupos de Google en la consola de Google Cloud .

Actualiza un producto de datos

Puedes actualizar los detalles básicos (por ejemplo, el nombre, la descripción y los detalles del propietario del producto de datos), los recursos, los grupos de acceso, los permisos, el contrato, los aspectos y la documentación adicional de un producto de datos existente.

Actualiza los detalles básicos de un producto de datos

Console

1. En la consola de Google Cloud , ve a la página Productos de datos de Dataplex Universal Catalog.

   Ir a Productos de datos

2. Haz clic en el producto de datos que deseas actualizar.

3. Haz clic en Editar producto de datos.

4. Actualiza el Nombre del producto de datos, el Ícono, la Descripción, los Contactos del propietario y las Etiquetas según sea necesario.

5. Haz clic en Actualizar producto de datos.

REST

Para actualizar los detalles básicos de un producto de datos, usa el método dataProducts.patch.

Por ejemplo, para actualizar la descripción de un producto de datos, envía la siguiente solicitud PATCH:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"description": "NEW_DESCRIPTION"}' \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID?update_mask="description"

Reemplaza lo siguiente:

• NEW_DESCRIPTION: Una descripción nueva del producto de datos
• PROJECT_ID: Es el ID de tu proyecto de Google Cloud.
• LOCATION: Es la región en la que existe el producto de datos.
• DATA_PRODUCT_ID: el ID de tu producto de datos

Actualiza los recursos de un producto de datos

Console

1. En la consola de Google Cloud , ve a la página Productos de datos de Dataplex Universal Catalog.

   Ir a Productos de datos

2. Haz clic en el producto de datos para el que deseas actualizar los recursos.

3. Haz clic en la pestaña Activos.

4. Para agregar un recurso nuevo, sigue estos pasos:

   1. Haga clic en +Add.

   2. Busca y selecciona los recursos que deseas agregar a tu producto de datos. Los recursos que selecciones deben residir en la misma región que el producto de datos.

      Si tienes los permisos necesarios, puedes ver los metadatos de los activos haciendo clic en ellos.

   3. Para definir mejor los resultados de la búsqueda, usa Filtros.

   4. Después de seleccionar los recursos, haz clic en Agregar.

5. Para quitar un recurso del producto de datos, sigue estos pasos:

   1. En el recurso que quieras quitar, haz clic en > Quitar.

   2. Para confirmar la acción, haz clic en Quitar.

REST

Para agregar un nuevo activo de datos al producto de datos, usa el método dataAssets.create. Para ver un ejemplo de código, consulta Opcional: Agrega recursos.

Para borrar un activo de datos del producto de datos, usa el método dataAssets.delete. Por ejemplo, envía la siguiente solicitud DELETE:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID/dataAssets/DATA_ASSET_ID"

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID de tu proyecto de Google Cloud.
• LOCATION: La región en la que deseas crear el producto de datos
• DATA_PRODUCT_ID: Es un ID único para tu producto de datos.
• DATA_ASSET_ID: Es el ID del recurso de datos que deseas quitar del producto de datos.

Actualiza los grupos de acceso y los permisos de los recursos

Console

1. En la consola de Google Cloud , ve a la página Productos de datos de Dataplex Universal Catalog.

   Ir a Productos de datos

2. Haz clic en el producto de datos para el que deseas actualizar los grupos de acceso y los permisos.

3. Haz clic en la pestaña Grupos de acceso y permisos.

4. Para actualizar un grupo de acceso, sigue estos pasos:

   1. Haz clic en Editar.

   2. Actualiza el nombre, la descripción y el identificador del grupo de acceso según sea necesario.

   3. Para agregar un grupo de acceso nuevo, haz clic en Agregar grupo de acceso y sigue estos pasos:

      1. En el campo Nombre del grupo de acceso, ingresa un nombre para el nuevo grupo de acceso. Por ejemplo, Analyst

      2. En el campo Descripción del grupo de acceso, ingresa una descripción para el grupo de acceso.

      3. En el campo Identificador del grupo de acceso, ingresa la dirección de correo electrónico de un Grupo de Google que quieras asignar a este grupo de acceso. Los consumidores del producto de datos que soliciten acceso a este grupo de acceso se pueden agregar como miembros al grupo de Google asignado.

         Puedes agregar un máximo de tres grupos de acceso por producto de datos.

   4. Haz clic en Agregar.

5. Para quitar un grupo de acceso, sigue estos pasos:

   1. En el grupo de acceso que deseas quitar, haz clic en > Quitar.

   2. Para confirmar la acción, haz clic en Quitar.

6. Si no hay grupos de acceso configurados para el producto de datos seleccionado, puedes agregar uno nuevo haciendo clic en Agregar grupo de acceso.

7. Para actualizar los permisos de los recursos, sigue estos pasos:

   1. En el activo para el que deseas actualizar los permisos, haz clic en > Permisos.

   2. Actualiza los grupos de acceso y los roles de IAM necesarios.

   3. Haz clic en Configurar.

REST

Para actualizar los grupos de acceso asociados con un producto de datos, usa el método dataProducts.patch. Para ver un ejemplo de código, consulta Configura grupos de acceso.

Para actualizar los permisos del activo, usa el método dataAssets.patch. Para ver un ejemplo de código, consulta Cómo configurar permisos de activos.

Actualiza el contrato del producto de datos

Nota: La cadencia de actualización no se puede editar después de que la agregues al contrato. Si intentas modificar este valor, se mostrará el siguiente error: You don't have permission to change contract values.

Console

1. En la consola de Google Cloud , ve a la página Productos de datos de Dataplex Universal Catalog.

   Ir a Productos de datos

2. Haz clic en el producto de datos para el que deseas actualizar el contrato.

3. Haz clic en la pestaña Contrato.

4. Para actualizar el contrato existente, sigue estos pasos:

   1. Haz clic en Editar.

   2. Actualiza los campos necesarios.

   3. Haz clic en Guardar.

5. Si no hay ningún contrato adjunto al producto de datos seleccionado, puedes agregar uno haciendo clic en Agregar contrato.

REST

Para actualizar un contrato, usa el método entries.patch. Para ver un ejemplo de código, consulta Cómo agregar un contrato.

Actualiza aspectos de un producto de datos

Console

1. En la consola de Google Cloud , ve a la página Productos de datos de Dataplex Universal Catalog.

   Ir a Productos de datos

2. Haz clic en el producto de datos para el que deseas actualizar los aspectos.

3. Haz clic en la pestaña Aspectos.

4. Para actualizar un aspecto, sigue estos pasos:

   1. Haz clic en el aspecto que deseas actualizar.

   2. Haz clic en Editar.

   3. Actualiza el Tipo de aspecto, el País y la Región según sea necesario.

   4. Haz clic en Guardar.

5. Para agregar un aspecto nuevo al producto de datos, sigue estos pasos:

   1. Haz clic en + Agregar aspecto.

   2. En el campo Selecciona el tipo de aspecto, busca y selecciona un tipo de aspecto de la lista. Por ejemplo, Geo context

   3. En el campo País, selecciona el país al que pertenece el activo.

   4. En el campo Región, selecciona la región comercial a la que pertenece el activo.

   5. Haz clic en Guardar.

6. Para borrar un aspecto, sigue estos pasos:

   1. Haz clic en el aspecto que deseas borrar.

   2. Haz clic en .

   3. Para confirmar la acción, haz clic en Confirmar.

REST

Para actualizar cualquier aspecto de la entrada del producto de datos, usa el método entries.patch.

Actualiza la documentación del producto de datos

Console

1. En la consola de Google Cloud , ve a la página Productos de datos de Dataplex Universal Catalog.

   Ir a Productos de datos

2. Haz clic en el producto de datos para el que deseas actualizar la documentación.

3. Haz clic en la pestaña Descripción general.

4. Haz clic en Editar junto a Documentación.

5. Actualiza la guía del usuario, las consultas de ejemplo y otros documentos según sea necesario.

6. Haz clic en Guardar.

REST

La documentación forma parte del aspecto overview. Para actualizar la documentación del producto de datos, usa el método entries.patch.

Borra un producto de datos

Para borrar un producto de datos, primero debes quitar todos los recursos del producto de datos.

Console

1. En la consola de Google Cloud , ve a la página Productos de datos de Dataplex Universal Catalog.

   Ir a Productos de datos

2. Haz clic en el producto de datos que quieras borrar.

3. Haz clic en la pestaña Activos.

4. En cada recurso que se muestre en la lista, haz clic en > Quitar. Haz clic en Quitar para confirmar la acción.

5. Después de quitar todos los recursos, haz clic en Borrar para borrar el producto de datos.

6. En el diálogo de confirmación, ingresa delete y haz clic en Borrar.

REST

Para borrar un producto de datos, usa el método dataProducts.delete.

Por ejemplo, envía la siguiente solicitud DELETE:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID de tu proyecto de Google Cloud.
• LOCATION: Es la región en la que existe el producto de datos.
• DATA_PRODUCT_ID: Es el ID del producto de datos que deseas borrar.

¿Qué sigue?

• Obtén más información para buscar productos de datos.
• Obtén más información para solicitar acceso a los productos de datos.