Gestionar suscripciones

En este documento se describe cómo gestionar tus suscripciones de BigQuery sharing, así como las tareas de los suscriptores y los editores.

Como suscriptor de uso compartido de BigQuery, puedes hacer lo siguiente:

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

Como editor de BigQuery sharing, puedes 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 necesitas 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 suscriptores para gestionar suscripciones

En las siguientes secciones se describe lo que pueden hacer los suscriptores de BigQuery sharing con las suscripciones.

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 de proyecto de las suscripciones que quieras consultar. 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 las tareas que puedes hacer con las suscripciones mediante la API, consulta los métodos de projects.locations.subscriptions.

Flujos de trabajo de editores para gestionar suscripciones

En las siguientes secciones se describe lo que pueden hacer los editores de BigQuery sharing con las suscripciones. 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. Haga clic en el nombre del intercambio de datos en el que quiera mostrar las suscripciones.

  3. Haga clic en la pestaña Suscripciones para ver todas las suscripciones de las fichas en el 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 mostrar las suscripciones.
  • DATAEXCHANGE_ID: ID del intercambio de datos para el 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.

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. Haga clic en el nombre del intercambio de datos en el que quiera revocar la ficha.

  3. Haga clic en 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