Gestionar suscripciones

En este documento se describe cómo gestionar las suscripciones en el uso compartido de BigQuery (antes Analytics Hub), y se explican las tareas que deben llevar a cabo tanto los suscriptores como los editores.

Los suscriptores de BigQuery sharing pueden hacer lo siguiente:

  • Suscríbete a una ficha.
  • Consulta tus suscripciones actuales en un Google Cloud proyecto determinado.
  • Eliminar una suscripción.

Los editores de BigQuery sharing pueden hacer lo siguiente:

  • Ver todas las suscripciones a tu ficha.
  • Revocar el acceso a una suscripción específica.

Una suscripción a BigQuery sharing es un recurso regionalizado que reside en el proyecto del suscriptor. Las suscripciones almacenan información relevante sobre el suscriptor y representan el contrato entre el editor y el suscriptor.

Antes de empezar

Para empezar a usar la función de compartir de BigQuery (antes Analytics Hub), debes habilitar la API Analytics Hub en tu Google Cloud proyecto.

Para habilitar la API Analytics Hub, necesitas los siguientes permisos de gestión de identidades y accesos (IAM):

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

El siguiente rol de gestión de identidades y accesos predefinido incluye los permisos que necesita para habilitar la API Analytics Hub:

Para habilitar la API Analytics Hub, selecciona una de las siguientes opciones:

Consola

Ve a la página de la API Analytics Hub y habilítala en tu proyecto. Google Cloud

Habilitar la API Analytics Hub

gcloud

Ejecuta el comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Roles obligatorios

Para obtener los permisos que necesitas para gestionar suscripciones, pide a tu administrador que te conceda el rol de gestión de identidades y accesos Propietario de la suscripción de Analytics Hub (roles/analyticshub.subscriptionOwner) en el proyecto. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Flujos de trabajo de suscriptor para gestionar suscripciones

En esta sección se describe cómo gestionan las suscripciones los suscriptores del uso compartido de BigQuery.

Suscribirse a fichas

Para suscribirte a fichas, sigue los pasos que se indican en Ver y suscribirse a fichas e intercambios de datos.

Mostrar suscripciones

Para enumerar tus suscripciones actuales en un proyecto determinado, usa el método projects.locations.subscriptions.list:

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto de las suscripciones que quieras enumerar. Google Cloud
  • LOCATION: la ubicación de las suscripciones que quieras mostrar.

Eliminar una suscripción

Para eliminar una suscripción, utiliza el método projects.locations.subscriptions.delete:

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto de la suscripción que se va a eliminar.
  • LOCATION: la ubicación de la suscripción que se va a eliminar. Para obtener más información sobre las ubicaciones que admiten el uso compartido, consulta Regiones admitidas.
  • SUBSCRIPTION_ID: ID de la suscripción que se va a eliminar.

El cuerpo de la solicitud debe estar vacío. Si la solicitud se completa correctamente, el cuerpo de la respuesta contiene una instancia de operación.

Cuando un suscriptor de BigQuery sharing elimina una suscripción, también se elimina el conjunto de datos vinculado del proyecto del suscriptor.

Cuando eliminas una suscripción de una ficha multirregional (Vista previa), también se eliminan todas las réplicas de conjuntos de datos vinculados principales y secundarios del proyecto del suscriptor.

Para obtener más información sobre cómo gestionar suscripciones con la API, consulta los métodos projects.locations.subscriptions.

Flujos de trabajo de editores para gestionar suscripciones

En esta sección se describe cómo gestionan las suscripciones los editores del uso compartido de BigQuery. Para obtener más información sobre cómo gestionar las suscripciones a fichas, consulta el artículo Gestionar fichas.

Mostrar suscripciones

Para ver todas las suscripciones, selecciona una de las siguientes opciones.

Consola

  1. En la Google Cloud consola, vaya a la página Compartir (Analytics Hub).

    Ir a Compartir (Analytics Hub)

    En la página se muestran todos los intercambios de datos a los que puede acceder.

  2. Seleccione el nombre del intercambio de datos en el que quiera mostrar las suscripciones.

  3. Seleccione la pestaña Suscripciones para ver todas las suscripciones de las fichas del intercambio de datos.

API

Para enumerar las suscripciones de las fichas de un intercambio de datos concreto, usa el método projects.locations.dataExchanges.listSubscriptions.

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

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto del intercambio de datos para el que se van a enumerar las suscripciones.
  • LOCATION: la ubicación del intercambio de datos del que se van a enumerar las suscripciones.
  • DATAEXCHANGE_ID: ID del intercambio de datos del que se van a enumerar las suscripciones.

Revocar una suscripción

Cuando un editor de BigQuery Sharing revoca una suscripción, el suscriptor ya no puede consultar el conjunto de datos vinculado. Como el editor inicia esta acción en un recurso propiedad del suscriptor, el conjunto de datos vinculado permanece en el proyecto del suscriptor. El suscriptor puede eliminar el conjunto de datos.

Si un editor revoca una suscripción de una ficha multirregional (vista previa), los suscriptores ya no podrán consultar ninguna réplica de conjunto de datos vinculada, ya sea principal o secundaria.

puede que afecte a tus clientes y que infrinjas los términos del servicio de Cloud Marketplace.

Para revocar una suscripción, selecciona una de las siguientes opciones:

Consola

  1. En la Google Cloud consola, vaya a la página Compartir (Analytics Hub).

    Ir a Compartir (Analytics Hub)

    En la página se muestran todos los intercambios de datos a los que puedes acceder.

  2. Selecciona el nombre del intercambio de datos en el que quieras revocar la ficha.

  3. Selecciona la pestaña Suscripciones para ver todas las suscripciones del intercambio de datos.

  4. Selecciona las suscripciones que quieras revocar.

  5. Haz clic en Revocar suscripciones.

API

Para revocar una suscripción, usa el método projects.locations.subscriptions.revoke.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Haz los cambios siguientes:

  • PROJECT_ID: el ID del proyecto de la suscripción que se va a revocar.
  • LOCATION: la ubicación de la suscripción.
  • SUBSCRIPTION_ID: el ID de la suscripción que se va a revocar.

Limitaciones

Las suscripciones tienen las siguientes limitaciones:

  • Solo puedes usar la API para gestionar las suscripciones creadas después del 25 de julio del 2023. Los conjuntos de datos vinculados creados antes de esta fecha no se admiten porque no tienen el recurso de suscripción necesario.

Siguientes pasos