Administra los intercambios de datos en el uso compartido de BigQuery

Como administrador de Analytics Hub, puedes realizar las siguientes tareas:

  • Crear, actualizar, ver, compartir y borrar 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 deGoogle 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 BigQuery sharing (anteriormente Analytics Hub), debes habilitar la API de Analytics Hub en tu Google Cloud proyecto.

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 página de la API de Analytics Hub y habilita la API de Analytics Hub para tu proyecto Google Cloud .

Habilita la API de Analytics Hub

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

  1. Ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

  2. Haz clic en Crear intercambio.

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

  4. En Nombre visible, ingresa un nombre para tu intercambio de datos.

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

  6. Para registrar todos los identificadores principales de los usuarios que ejecutan trabajos y consultas en conjuntos de datos vinculados, haz clic en el botón de activación Registro de correos electrónicos de suscriptores (Versión preliminar). Cuando habilitas esta opción, se habilita el registro de correo electrónico del suscriptor en todas las fichas del intercambio de datos.

  7. Para activar la visibilidad pública, haz clic en el botón de activación Visibilidad pública. Una vez que un intercambio se puede descubrir públicamente, 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 establecerá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 fichas públicas (por ejemplo, puedes establecer el tipo de detectabilidad 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.

  8. Haz clic en Crear intercambio.

  9. Opcional: En la sección Permisos del intercambio, realiza los siguientes pasos:

    1. Ingresa las direcciones de correo electrónico en los siguientes campos para otorgar los roles de usuario de Analytics Hub:

    2. Para guardar los permisos, haz clic en Establecer permisos.

  10. 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 BigQuery sharing (anteriormente 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á los detalles del intercambio de datos. Si habilitaste el registro de correos electrónicos de suscriptores (versión preliminar), la respuesta del intercambio de datos contendrá log_linked_dataset_query_user_email: true.

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

  1. Ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

  2. En la lista de intercambios de datos, haz clic en el intercambio de datos que desees actualizar.

  3. Ve a la pestaña Detalles.

  4. Haz clic en Editar intercambio.

  5. 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 de Visualizador de Analytics Hub (roles/analyticshub.viewer) a allUsers o allAuthenticatedUsers.
      • Si inhabilitas la visibilidad pública, quita el rol de visualizador de Analytics Hub (roles/analyticshub.viewer) de allUsers o allAuthenticatedUsers. Los intercambios públicos no pueden tener fichas privadas, pero los intercambios privados pueden tener fichas públicas.

    • Registro de correos electrónicos de suscriptores (vista previa)

  6. 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
  • Registro de correo electrónico de los suscriptores (vista previa)

Para obtener detalles sobre estos campos, consulta Recurso: DataExchange.

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 los intercambios de datos de tu proyecto o organización a los que tienes acceso, sigue estos pasos:

Console

  1. Ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

  2. Consulta la lista de intercambios de datos dentro de tu proyecto de Google Cloud . Si tienes el permiso resourcemanager.organizations.get, también puedes ver la lista de intercambios de datos dentro de tu organización Google Cloud .

API

Para ver los intercambios de datos en tu proyecto, usa el método projects.locations.dataExchanges.list:

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges

Reemplaza lo siguiente:

  • PROJECT_ID: El ID del proyecto.
  • LOCATION: La ubicación para la que deseas enumerar los intercambios de datos existentes.

Para ver los intercambios de datos en tu organización, 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 tu intercambio de datos en Compartir. Debes compartir un vínculo del intercambio de datos con el publicador.

  1. Ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

  2. En la lista de intercambios de datos, haz clic en Más opciones.

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

  1. En la consola de Google Cloud , ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

  2. Haz clic en el nombre del intercambio de datos para el que deseas establecer permisos.

  3. Ve a la pestaña Detalles.

  4. Haz clic en Establecer permisos.

  5. Para agregar principales, haz clic en Agregar principal.

  6. En el campo Principales nuevos, agrega los IDs de correo electrónico a los que deseas otorgar acceso. También puedes usar allUsers para hacer que un recurso sea público y accesible para todos en Internet, o allAuthenticatedUsers para que solo sea accesible para los usuarios de Google que hayan accedido a su cuenta.

  7. En el menú Selecciona un rol, selecciona Analytics Hub y, luego, elige uno de los siguientes roles de Identity and Access Management (IAM):

    • Administrador de Analytics Hub
    • Administrador de fichas de Analytics Hub
    • Publicador de Analytics Hub
    • Suscriptor de Analytics Hub
    • Propietario de la suscripción a Analytics Hub
    • Visualizador de Analytics Hub

  8. Haz clic en Guardar.

API

  1. Lee la política existente con el método getIamPolicy de la lista mediante el método projects.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. Usa letras minúsculas.
    • DATAEXCHANGE_ID: el ID del intercambio de datos.

    BigQuery sharing (anteriormente Analytics Hub) devuelve la política actual.

  2. 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 a group:subscribers@example.com, agrega la siguiente vinculación a la política:

    {
 "members": [
   "group:subscribers@example.com"
 ],
 "role":"roles/analyticshub.subscriber"
}

  3. 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 deGoogle 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:

  1. Para permitir que los usuarios allAuthenticatedUsers vean fichas, debes otorgarles el rol Analytics Hub Viewer a nivel de intercambio de datos.

  2. Para permitir que allAuthenticatedUsers se suscriban a las fichas, debes otorgarles el rol Analytics Hub Subscriber a nivel de intercambio de datos.

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

Antes de borrar un intercambio de datos, debes seguir estos pasos según la configuración del intercambio de datos:

Para borrar un intercambio de datos, sigue estos pasos:

Console

  1. Ve a la página Uso compartido (Analytics Hub).

    Ir a Uso compartido (Analytics Hub)

  2. En la lista de intercambios de datos, haz clic en el intercambio de datos que deseas borrar.

  3. Ve a la pestaña Detalles.

  4. Haz clic en Borrar intercambio.

  5. En el cuadro de diálogo ¿Borrar intercambio?, escribe delete para confirmar la eliminación.

  6. 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?