Administrar las suscripciones

Puedes administrar tus suscripciones en BigQuery sharing (anteriormente Analytics Hub) para controlar el acceso a los datos y su 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 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 en 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 proyecto Google Cloud .

Habilita la API de Analytics Hub

gcloud

Ejecuta el comando gcloud services enable:

gcloud services enable analyticshub.googleapis.com

Roles obligatorios

Para obtener los permisos que necesitas para administrar 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 suscripciones creadas después del 25 de julio de 2023. No se admiten los conjuntos de datos vinculados creados antes de esta fecha porque no tienen el recurso de suscripción requerido.

Administra suscripciones como suscriptor

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

Suscríbete a fichas

Para suscribirte a fichas, sigue los pasos que se indican en Cómo ver y suscribirse a fichas e intercambios de datos.

Enumerar suscripciones

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

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

Reemplaza lo siguiente:

  • PROJECT_ID: ID del proyecto Google Cloud del proyecto que contiene las suscripciones que deseas enumerar.
  • LOCATION: Es 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.

Actualiza una suscripción

Un intercambio de datos o una sala limpia de datos pueden quedar obsoletos cuando un publicador o un colaborador de datos agrega o quita datos. Cuando esto sucede, tu conjunto de datos vinculado existente no se actualiza automáticamente, y debes actualizar tu suscripción para acceder a los recursos nuevos.

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

Console

  1. En la consola de Google Cloud , ve a la página BigQuery.

    Ir a BigQuery

  2. En el panel Explorador, haz clic en Agregar datos.

  3. Selecciona Uso compartido (Analytics Hub). Se abrirá una página de descubrimiento.

  4. Busca y haz clic en la sala limpia de datos o el intercambio de datos al que te suscribiste.

  5. Haz clic en Suscribirse. Como ya tienes una suscripción activa, la consola presenta la opción Actualizar.

  6. Haz clic en Actualizar para actualizar tu conjunto de datos vinculado con los recursos más recientes.

API

Para actualizar una suscripción, usa el método projects.locations.subscriptions.refresh:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de la suscripción que deseas actualizar.
  • LOCATION: Es la ubicación de la suscripción que deseas actualizar.
  • SUBSCRIPTION_ID: Es el ID de la suscripción que deseas actualizar.

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

Cómo borrar una suscripción

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

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

Reemplaza lo siguiente:

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

El cuerpo de la solicitud debe estar vacío. Si se ejecuta 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 de tu proyecto todas las réplicas de conjuntos de datos vinculados principales y secundarios.

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

Administra 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 fichas.

Enumerar suscripciones

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

Console

  1. En la consola de Google Cloud , ve a la página Compartir (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 método projects.locations.dataExchanges.listSubscriptions:

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

Reemplaza lo siguiente:

  • PROJECT_ID: ID del proyecto Google Cloud que contiene el intercambio de datos.
  • LOCATION: Es la ubicación del intercambio de datos que contiene las suscripciones que deseas enumerar.
  • DATAEXCHANGE_ID: Es 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 principales o secundarios.

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

Console

  1. En la consola de Google Cloud , ve a la página Compartir (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 desees revocar.

  5. Haz clic en Revocar suscripciones.

API

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

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

Reemplaza lo siguiente:

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

¿Qué sigue?