Administrar las suscripciones

Puedes administrar tus suscripciones en BigQuery sharing (anteriormente Analytics Hub) para controlar el acceso a los datos y el uso compartido. Como suscriptor, puedes suscribirte a fichas, ver tus suscripciones y borrarlas. Como publicador, puedes supervisar quién tiene acceso a tus fichas y revocar las suscripciones según sea necesario. Una suscripción de BigQuery sharing es un recurso regionalizado que reside en el proyecto del suscriptor. Las suscripciones almacenan información sobre el suscriptor y representan el contrato entre el publicador y el suscriptor.

Antes de comenzar

Para comenzar a usar BigQuery sharing (anteriormente Analytics Hub), debes habilitar la API de Analytics Hub dentro de tu Google Cloud proyecto.

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:

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

Console

Ve a la página de la API de Analytics Hub y habilita la API de Analytics Hub para tu Google Cloud proyecto.

Habilita la API de Analytics Hub

gcloud

Ejecuta el gcloud services enable comando:

gcloud services enable analyticshub.googleapis.com

Roles obligatorios

Para obtener los permisos que necesitas para administrar las suscripciones, pídele a tu administrador que te otorgue el rol de IAM Propietario de la suscripción de Analytics Hub (roles/analyticshub.subscriptionOwner) en el proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Limitaciones

Las suscripciones tienen las siguientes limitaciones:

  • Solo puedes usar la API de Analytics Hub para administrar las suscripciones que se crearon después del 25 de julio de 2023. Los conjuntos de datos vinculados creados antes de esta fecha no son compatibles porque carecen del recurso de suscripción requerido.

Administra las suscripciones como suscriptor

En las siguientes secciones, se describe cómo los suscriptores de BigQuery sharing administran las suscripciones.

Suscríbete a fichas

Para suscribirte a fichas, sigue los pasos que se indican en Visualiza fichas e intercambios de datos y suscríbete a ellos.

Enumera las suscripciones

Para enumerar tus suscripciones en un proyecto, llama al projects.locations.subscriptions.list método:

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

Reemplaza lo siguiente:

  • PROJECT_ID: el Google Cloud ID del proyecto que contiene las suscripciones que deseas enumerar.
  • LOCATION: la ubicación de las suscripciones que deseas enumerar. Para obtener más información sobre las ubicaciones que admiten el uso compartido, consulta Regiones admitidas.

Borra una suscripción

Para borrar una suscripción, llama al projects.locations.subscriptions.delete método:

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

Reemplaza lo siguiente:

  • PROJECT_ID: el Google Cloud ID del proyecto que contiene la suscripción que deseas borrar.
  • LOCATION: la ubicación de la suscripción que deseas borrar.
  • SUBSCRIPTION_ID: el ID de la suscripción que deseas borrar.

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

Cuando borras una suscripción, también se borra el conjunto de datos vinculado de tu proyecto.

Cuando borras una suscripción de una ficha multirregional, también se borran todas las réplicas de conjuntos de datos vinculados primarias y secundarias de tu proyecto.

Para obtener más información sobre la administración de suscripciones con la API de Analytics Hub, consulta los projects.locations.subscriptions métodos.

Administra las suscripciones como publicador

En las siguientes secciones, se describe cómo los publicadores de BigQuery sharing administran las suscripciones. Para obtener más información sobre la administración de suscripciones a fichas, consulta Administra las fichas.

Enumera las suscripciones

Para enumerar todas las suscripciones, selecciona una de las siguientes opciones:

Console

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

    Ir a Uso compartido (Analytics Hub)

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

  2. En la lista de intercambios de datos, haz clic en el nombre del intercambio de datos que contiene las suscripciones que deseas enumerar.

  3. Haz clic en la pestaña Suscripciones.

API

Para enumerar las suscripciones de las fichas en un intercambio de datos en particular, llama al projects.locations.dataExchanges.listSubscriptions método:

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

Reemplaza lo siguiente:

  • PROJECT_ID: el Google Cloud ID del proyecto que contiene el intercambio de datos.
  • LOCATION: la ubicación del intercambio de datos que contiene las suscripciones que deseas enumerar.
  • DATAEXCHANGE_ID: el ID del intercambio de datos para el que se enumerarán las suscripciones.

Cómo revocar una suscripción

Cuando revocas una suscripción como publicador de BigQuery sharing, el suscriptor ya no puede consultar el conjunto de datos vinculado. Debido a que inicias esta acción en un recurso propiedad del suscriptor, el conjunto de datos vinculado permanece en el proyecto del suscriptor. El suscriptor puede quitar el conjunto de datos borrándolo.

Cuando revocas una suscripción de una ficha multirregional, los suscriptores ya no pueden consultar ninguna réplica de conjuntos de datos vinculados primarias o secundarias.

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

Console

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

    Ir a Uso compartido (Analytics Hub)

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

  2. En la lista de intercambios de datos, haz clic en el nombre del intercambio de datos que contiene la suscripción que deseas revocar.

  3. Haz clic en la pestaña Suscripciones.

  4. Selecciona la casilla de verificación junto a cada suscripción que deseas revocar.

  5. Haz clic en Revocar suscripciones.

API

Para revocar una suscripción, llama al projects.locations.subscriptions.revoke método:

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

Reemplaza lo siguiente:

  • PROJECT_ID: el Google Cloud ID del proyecto que contiene la suscripción que deseas revocar.
  • LOCATION: la ubicación de la suscripción que deseas revocar.
  • SUBSCRIPTION_ID: el ID de la suscripción que deseas revocar.

¿Qué sigue?