Gestionar productos de datos

Vista previa

Este producto o función está sujeto a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Los productos y las funciones previos a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Este documento está dirigido a los propietarios de productos de datos que quieran actualizar, eliminar y conceder acceso a 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 el artículo Acerca de los productos de datos.

Antes de empezar

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 presupone que ya tiene productos de datos que gestionar. Para obtener más información sobre cómo crear y configurar productos de datos, consulte Crear productos de datos.

Roles obligatorios

Para obtener los permisos que necesitas para gestionar productos de datos, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto:

• Permisos completos para crear, actualizar, eliminar y gestionar permisos de productos de datos: Administrador de productos de datos de Dataplex (roles/dataplex.dataProductAdmin)
• Actualizar y gestionar productos de datos: Editor de productos de datos de Dataplex (roles/dataplex.dataProductEditor)
• Añade aspectos como schema, overview y contacts: Propietario de Entry y EntryLink de Dataplex (roles/dataplex.entryOwner)
• Buscar y añadir recursos: Visor de Dataplex Catalog (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 catálogo de Dataplex (roles/dataplex.catalogEditor)

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para gestionar los productos de datos. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Para gestionar productos de datos, se necesitan los siguientes permisos:

• Edita el overviewtipo de aspecto del sistema dataplex.entryGroups.useOverviewAspect: dataplex.entryGroups.useOverviewAspect
• Edita el refresh cadencetipo de aspecto del sistema dataplex.entryGroups.useRefreshCadenceAspect: dataplex.entryGroups.useRefreshCadenceAspect

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

Conceder acceso a un producto de datos

Los propietarios de productos de datos deben hacer que sus productos sean visibles y conceder los roles necesarios para que los consumidores puedan buscar, ver y solicitar acceso a los productos de datos.

Para conceder a los consumidores de productos de datos los permisos que necesitan para interactuar con el producto de datos, concédales los siguientes roles de gestión de identidades y accesos 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: Visor de productos de datos de Dataplex (dataplex.dataProductViewer)
• Solicitar acceso a productos de datos: consumidor de productos de datos de Dataplex (dataplex.dataProductsConsumer)

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

Para conceder acceso, sigue estos pasos:

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

   Ir a la página Grupos

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

3. Haz clic en  Añadir miembros.

4. Añade la entidad de seguridad.

5. Haz clic en Guardar.

Para obtener más información, consulta el artículo sobre cómo crear y gestionar grupos de Google en la consola de Google Cloud .

Actualizar un producto de datos

Puede 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.

Actualizar los detalles básicos de un producto de datos

Consola

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

   Ir a Productos de datos

2. Haga clic en el producto de datos que quiera actualizar.

3. Haga clic en Editar producto de datos.

4. Actualice el nombre del producto de datos, el icono, 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, utilice el método dataProducts.patch.

Por ejemplo, para actualizar la descripción de un producto de datos, envíe 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"

Haz los cambios siguientes:

• NEW_DESCRIPTION: una nueva descripción del producto de datos
• PROJECT_ID: el ID de tu Google Cloud proyecto
• LOCATION: región en la que se encuentra el producto de datos
• DATA_PRODUCT_ID: el ID de su producto de datos

Actualizar los recursos de un producto de datos

Consola

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

   Ir a Productos de datos

2. Haga clic en el producto de datos cuyos recursos quiera actualizar.

3. Haz clic en la pestaña Recursos.

4. Para añadir un recurso, sigue estos pasos:

   1. Haz clic en +Add (Añadir).

   2. Busca y selecciona los recursos que quieras añadir a tu producto de datos. Los recursos que seleccione deben estar en la misma región que el producto de datos.

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

   3. Para acotar los resultados de búsqueda, usa Filtros.

   4. Cuando hayas seleccionado los recursos, haz clic en Añadir.

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 añadir un nuevo recurso de datos al producto de datos, utilice el método dataAssets.create. Para ver un ejemplo de código, consulta Opcional: añade recursos.

Para eliminar un recurso de datos de un producto de datos, utilice 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"

Haz los cambios siguientes:

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

Actualizar grupos de acceso y permisos de recursos

Consola

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

   Ir a Productos de datos

2. Haga clic en el producto de datos del que quiera 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 añadir un grupo de acceso, haz clic en Añadir grupo de acceso y sigue estos pasos:

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

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

      3. En el campo Access group identifier (Identificador del grupo de acceso), introduce la dirección de correo de un grupo de Google que quieras asignar a este grupo de acceso. Los consumidores de productos de datos que soliciten acceso a este grupo de acceso se pueden añadir como miembros al grupo de Google asignado.

         Puede añadir un máximo de tres grupos de acceso por producto de datos.

   4. Haz clic en Añadir.

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

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

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

6. Si no hay ningún grupo de acceso configurado para el producto de datos seleccionado, puedes añadir uno haciendo clic en Añadir grupo de acceso.

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

   1. En el recurso cuyos permisos quieras actualizar, haz clic en > Permisos.

   2. Actualiza los grupos de acceso y los roles de gestión de identidades y accesos necesarios.

   3. Haz clic en Configurar.

REST

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

Para actualizar los permisos del recurso, usa el método dataAssets.patch. Para ver un ejemplo de código, consulta Configurar permisos de elementos.

Actualizar el contrato de producto de datos

Nota: La frecuencia de actualización no se puede editar después de añadirla al contrato. Si intentas modificar este valor, se muestra el siguiente error: You don't have permission to change contract values.

Consola

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

   Ir a Productos de datos

2. Haga clic en el producto de datos cuyo contrato quiera actualizar.

3. Haga clic en la pestaña Contrato.

4. Para actualizar el contrato, 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 añadir uno haciendo clic en Añadir contrato.

REST

Para actualizar un contrato, usa el método entries.patch. Para ver un ejemplo de código, consulta Añadir un contrato.

Actualizar aspectos de un producto de datos

Consola

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

   Ir a Productos de datos

2. Haga clic en el producto de datos del que quiera 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 quieras actualizar.

   2. Haz clic en Editar.

   3. Actualice los campos Tipo de aspecto, País y Región según sea necesario.

   4. Haz clic en Guardar.

5. Para añadir un nuevo aspecto al producto de datos, sigue estos pasos:

   1. Haz clic en + Añadir aspecto.

   2. En el campo Select aspect type (Seleccionar tipo de aspecto), busca y selecciona un tipo de aspecto de la lista. Por ejemplo, Geo context.

   3. En el campo País, seleccione el país al que pertenece el recurso.

   4. En el campo Región, selecciona la región empresarial a la que pertenece el recurso.

   5. Haz clic en Guardar.

6. Para eliminar un aspecto, sigue estos pasos:

   1. Haz clic en el aspecto que quieras eliminar.

   2. Haz clic en .

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

REST

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

Actualizar la documentación del producto de datos

Consola

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

   Ir a Productos de datos

2. Haga clic en el producto de datos cuya documentación quiera actualizar.

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

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

5. Actualizar la guía de usuario, las consultas de ejemplo y otra documentación 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.

Eliminar un producto de datos

Para eliminar un producto de datos, primero debe quitar todos los recursos del producto de datos.

Consola

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

3. Haz clic en la pestaña Recursos.

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

5. Una vez que hayas quitado todos los recursos, elimina el producto de datos haciendo clic en Eliminar.

6. En el cuadro de diálogo de confirmación, introduce delete y haz clic en Eliminar.

REST

Para eliminar un producto de datos, utiliza 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

Haz los cambios siguientes:

• PROJECT_ID: el ID de tu Google Cloud proyecto
• LOCATION: región en la que se encuentra el producto de datos
• DATA_PRODUCT_ID: el ID del producto de datos que quiere eliminar

Siguientes pasos

• Consulte cómo buscar productos de datos.
• Consulte cómo solicitar acceso a productos de datos.