Administra intercambios de datos
Como administrador de Analytics Hub, puedes realizar las siguientes tareas:
- Crea, actualiza, visualiza, comparte y borra intercambios de datos.
- Crear, actualizar, borrar y compartir fichas.
- Administrar los administradores de Analytics Hub, los administradores de fichas, los publicadores, los suscriptores y los visualizadores.
De forma predeterminada, un intercambio de datos es privado y solo los usuarios o grupos que tienen acceso a ese intercambio pueden ver los datos o suscribirse a ellos. Sin embargo, si quieres que los usuarios de Google Cloud (allAuthenticatedUsers
) descubran fichas y se suscriban a ellas, puedes solicitar hacer público tu intercambio de datos.
Antes de comenzar
Para comenzar a usar Analytics Hub, debes habilitar la API de Analytics Hub dentro de tu proyecto de Google Cloud.
Permisos necesarios
Para habilitar la API de Analytics Hub, necesitas los siguientes permisos de Identity and Access Management (IAM):
serviceUsage.services.get
serviceUsage.services.list
serviceUsage.services.enable
El siguiente rol predefinido de IAM incluye los permisos que necesitas para habilitar la API de Analytics Hub:
roles/serviceusage.serviceUsageAdmin
Para obtener más información de los roles de IAM en BigQuery, consulta Funciones y permisos predefinidos.
Habilita la API de Analytics Hub
Para habilitar la API de Analytics Hub, haz lo siguiente:
Console
Ve a la API de Analytics Hub para tu proyecto de Google Cloud y habilítala.
gcloud
Ejecuta el comando gcloud services enable:
gcloud services enable analyticshub.googleapis.com
Permisos necesarios
Para administrar los intercambios de datos, debes tener el rol Analytics Hub Admin (roles/analyticshub.admin
). Para obtener más información, consulta el rol Analytics Hub Admin. Para obtener información sobre cómo otorgar este rol a otros usuarios, consulta Crea administradores de Analytics Hub.
Crea un intercambio de datos
Para crear un intercambio de datos, sigue estos pasos:
Console
Ve a la página Analytics Hub.
Haz clic en
Crear intercambio.En el cuadro de diálogo Crear intercambio, selecciona un Proyecto y una Región para tu intercambio de datos. No puedes actualizar el proyecto y la región después de crear el intercambio de datos.
En Nombre visible, ingresa un nombre para tu intercambio de datos.
Opcional: Ingresa valores en los siguientes campos:
- Contacto principal: Ingresa la URL o la dirección de correo electrónico del contacto principal para el intercambio de datos.
- Descripción: Ingresa una descripción para el intercambio de datos.
Para activar la visibilidad pública, haz clic en el botón de activación Visibilidad pública. Una vez que un intercambio es detectable de forma pública, todas las fichas del intercambio se muestran y se pueden buscar en el catálogo. Si habilitas la visibilidad pública, debes configurar los permisos de intercambio. Debido a la herencia de permisos, todas las fichas se configurarán de forma predeterminada con el mismo tipo de visibilidad pública del intercambio. Por lo tanto, los intercambios públicos no pueden tener fichas privadas, pero los intercambios privados pueden tener listas públicas (por ejemplo, puedes configurar el tipo de visibilidad pública a nivel de la ficha individual). El proyecto en el que creas el intercambio de datos debe tener una organización y una cuenta de facturación asociadas.
Haz clic en Crear intercambio.
Opcional: En la sección Permisos del intercambio, realiza los siguientes pasos:
Ingresa las direcciones de correo electrónico en los siguientes campos para otorgar los roles de usuario de Analytics Hub:
- Administradores: A estos usuarios se les asigna el rol Analytics Hub Admin.
- Publicadores: A estos usuarios se les asigna el rol Analytics Hub Publisher. Para obtener información sobre las tareas que pueden realizar los publicadores, consulta Administra fichas.
- Suscriptores: A estos usuarios se les asigna el rol Analytics Hub Subscriber. Si deseas obtener información sobre las tareas que pueden realizar los suscriptores, consulta Visualiza fichas y suscríbete a ellas.
- Visualizadores: A estos usuarios se les asigna el rol Analytics Hub Viewer.
Los visualizadores pueden ver fichas.
- Si la visibilidad pública está habilitada, otorga el rol Analytics Hub Viewer (
roles/analyticshub.viewer
) aallUsers
oallAuthenticatedUsers
.
- Si la visibilidad pública está habilitada, otorga el rol Analytics Hub Viewer (
Para guardar los permisos, haz clic en Establecer permisos.
Si no estableciste permisos para tu intercambio de datos, haz clic en Omitir.
API
Usa el método projects.locations.dataExchanges.create
.
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges?dataExchangeId=DATAEXCHANGE_ID
Reemplaza lo siguiente:
PROJECT_ID
: El ID del proyecto en el que deseas crear el intercambio de datos.LOCATION
: la ubicación de tu intercambio de datos. Para obtener más información sobre las ubicaciones compatibles con Analytics Hub, consulta Regiones admitidas.DATAEXCHANGE_ID
: El ID de tu intercambio de datos.
En el cuerpo de la solicitud, proporciona los detalles del intercambio de datos. Si la solicitud se realiza de forma correcta, el cuerpo de la respuesta contendrá detalles del intercambio de datos.
Para obtener más información sobre las tareas que puedes realizar en los intercambios de datos mediante las API, consulta Métodos projects.locations.dataExchanges
.
Actualiza un intercambio de datos
Para actualizar un intercambio de datos, sigue estos pasos:
Console
Ve a la página Analytics Hub.
En la lista de intercambios de datos, haz clic en el intercambio de datos que desees actualizar.
Haz clic en
Editar intercambio.En el diálogo Editar intercambio, actualiza los siguientes campos:
- Nombre visible
- Contacto principal
- Descripción
- Visibilidad pública
- Si habilitas la visibilidad pública, otorga el rol Analytics Hub Viewer (
roles/analyticshub.viewer
) aallUsers
oallAuthenticatedUsers
. - Si inhabilitas la visibilidad pública, quita el rol Analytics Hub Viewer (
roles/analyticshub.viewer
) deallUsers
oallAuthenticatedUsers
. Los intercambios públicos no pueden tener fichas privadas, pero los intercambios privados pueden tener fichas públicas.
- Si habilitas la visibilidad pública, otorga el rol Analytics Hub Viewer (
Haz clic en Guardar.
API
Usa el método projects.locations.dataExchanges.patch
.
PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID?updateMask=UPDATEMASK
Reemplaza UPDATEMASK
por la lista de campos que deseas actualizar. Si deseas actualizar varios valores, usa una lista separada por comas. Por ejemplo, para actualizar el nombre visible y el contacto principal de un intercambio de datos, ingresa displayName,primaryContact
.
En el cuerpo de la solicitud, especifica los valores actualizados para los siguientes campos:
- Nombre visible
- Descripción
- Documentación
- Ícono
- Contacto principal
- Visibilidad pública
Para obtener más información sobre las tareas que puedes realizar en los intercambios de datos mediante las API, consulta Métodos projects.locations.dataExchanges
.
Ve los intercambios de datos
Para ver todos los intercambios de datos de tu organización a los que tienes acceso, sigue estos pasos:
Console
Ve a la página Analytics Hub.
Consulta la lista de intercambios de datos dentro de tu organización de Google Cloud.
API
Usa el método organizations.locations.dataExchanges.list
.
GET https://analyticshub.googleapis.com/v1/organizations/ORGANIZATION_ID/location/LOCATION/dataExchanges
Reemplaza lo siguiente:
- ORGANIZATION_ID: El ID de la organización. Para obtener más información, consulta Obtén el ID de tu organización.
- LOCATION: La ubicación para la que deseas enumerar los intercambios de datos existentes.
Comparte un intercambio de datos
Si el publicador de Analytics Hub pertenece a una organización diferente a la que contiene el intercambio de datos, el publicador no puede ver el intercambio de datos en Analytics Hub. Debes compartir un vínculo del intercambio de datos con el publicador.
Ve a la página Analytics Hub.
En la lista de intercambios de datos, haz clic en
Más opciones.Haz clic en
Copiar vínculo para compartir.
Otorga a los usuarios acceso a un intercambio de datos
Para otorgar a los usuarios acceso a un intercambio de datos, debes establecer la política de IAM para ese intercambio. Para obtener información sobre los roles de usuario predefinidos de IAM, consulta Roles de los usuarios de Analytics Hub. Para hacerlo, sigue estos pasos:
Console
En la consola de Google Cloud, ve a la página Analytics Hub.
Haz clic en el nombre del intercambio de datos para el que deseas establecer permisos.
Haz clic en
Establecer permisos.Para agregar principales, haz clic en
Agregar principal.En el campo Principales nuevos, agrega los correos electrónicos a los que desees otorgar acceso.
En Selecciona un rol, mantén el puntero sobre Analytics Hub y, luego, selecciona una de los siguientes roles de Identity and Access Management (IAM):
- Administrador de Analytics Hub
- Publicador de Analytics Hub
- Administrador de fichas de Analytics Hub
- Suscriptor de Analytics Hub
- Visualizador de Analytics Hub
Haz clic en Guardar.
API
Lee la política existente con el método
getIamPolicy
de la lista mediante el métodoprojects.locations.dataExchanges.getIamPolicy
:POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:getIamPolicy
Reemplaza lo siguiente:
PROJECT_ID
: es el ID del proyecto, por ejemplo,my-project-1
.LOCATION
: la ubicación de tu intercambio de datos.DATAEXCHANGE_ID
: el ID del intercambio de datos.
Analytics Hub muestra la política actual.
Para agregar o quitar miembros y sus roles asociados de Identity and Access Management (IAM), edita la política con un editor de texto. Usa el siguiente formato para agregar miembros:
user:test-user@gmail.com
group:admins@example.com
serviceAccount:test123@example.domain.com
domain:example.domain.com
Por ejemplo, para otorgar la función
roles/analyticshub.subscriber
agroup:subscribers@example.com
, agrega la siguiente vinculación a la política:{ "members": [ "group:subscribers@example.com" ], "role":"roles/analyticshub.subscriber" }
Escribe la política actualizada mediante el método
projects.locations.dataExchanges.setIamPolicy
. En el cuerpo de la solicitud, proporciona la política de IAM actualizada del paso anterior.POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:setIamPolicy
En el cuerpo de la solicitud, proporciona los detalles de la ficha. Si la solicitud se realiza de forma correcta, el cuerpo de la respuesta contendrá detalles de la ficha.
Crea administradores de Analytics Hub
Para administrar intercambios de datos, debes crear administradores de Analytics Hub. Para crear administradores de intercambio, debes otorgar a los usuarios el rol Analytics Hub Admin (roles/analyticshub.admin
) a nivel de proyecto o de intercambio de datos.
Si quieres que los administradores gestionen todos los intercambios de datos de un proyecto, otorga el rol Analytics Hub Admin para ese proyecto. Si deseas que los administradores gestionen un intercambio de datos específico, otorga el rol Analytics Hub Admin para ese intercambio de datos.
Haz que un intercambio de datos sea público
De forma predeterminada, un intercambio de datos es privado y solo los usuarios o grupos que tienen acceso a ese intercambio pueden ver sus fichas o suscribirse a ellas. Sin embargo, puedes optar por hacer público un intercambio de datos. Los usuarios de Google Cloud (allAuthenticatedUsers
) pueden descubrir las fichas en los intercambios de datos públicos y suscribirse a ellas.
Para hacer público un intercambio de datos, sigue estos pasos:
Para permitir que los usuarios
allAuthenticatedUsers
vean fichas, debes otorgarles el rol Analytics Hub Viewer a nivel de intercambio de datos.Para permitir que
allAuthenticatedUsers
se suscriban a las fichas, debes otorgarles el rol Analytics Hub Subscriber a nivel de intercambio de datos.Activa la visibilidad pública cuando crees o actualices un intercambio de datos. Especifica los permisos adecuados cuando hagas público un intercambio de datos.
Borra un intercambio de datos
Cuando se borra un intercambio de datos, también se borran todas las fichas que contiene. Sin embargo, los conjuntos de datos compartidos y los vinculados no se borran. Además, cuando se borra un proyecto, no se borran los intercambios de datos dentro de él. Debes borrar estos intercambios de datos antes de borrar el proyecto. Si borras un intercambio de datos, no podrás deshacerlo.
Para borrar un intercambio de datos, sigue estos pasos:
Console
Ve a la página Analytics Hub.
En la lista de intercambios de datos, haz clic en el intercambio de datos que deseas borrar.
Haz clic en
Borrar intercambio.En el cuadro de diálogo ¿Borrar intercambio?, escribe delete para confirmar la eliminación.
Haz clic en Borrar.
API
Usa el método projects.locations.dataExchanges.delete
.
DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID
Para obtener más información sobre las tareas que puedes realizar en los intercambios de datos mediante las API, consulta Métodos projects.locations.dataExchanges
.
¿Qué sigue?
- Obtén información sobre cómo administrar fichas.
- Obtén información sobre cómo otorgar roles de usuario de Analytics Hub.
- Obtén información sobre cómo ver fichas y suscribirte a ellas.
- Obtén más información sobre el registro de auditoría de Analytics Hub.