Administrar las suscripciones

En este documento, se describe cómo administrar tus suscripciones de uso compartido de BigQuery, y se abarcan las tareas tanto para los suscriptores como para los publicadores.

Como suscriptor de BigQuery sharing, puedes hacer lo siguiente:

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

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

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

Una suscripción de uso compartido de BigQuery 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 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 a través de roles personalizados o cualquier otro rol predefinido.

Flujos de trabajo de los suscriptores para administrar suscripciones

En las siguientes secciones, se describe lo que pueden hacer los suscriptores de BigQuery sharing con 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 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

Reemplaza lo siguiente:

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

Cómo borrar una suscripción

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

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del proyecto de la suscripción que se borrará.
  • LOCATION: Es la ubicación de la suscripción que se borrará. Para obtener más información sobre las ubicaciones que admiten el uso compartido, consulta Regiones admitidas.
  • SUBSCRIPTION_ID: Es el ID de la suscripción que se 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 un suscriptor de uso compartido de BigQuery borra una suscripción, también se borra el conjunto de datos vinculado del proyecto del suscriptor.

Cuando borras una suscripción de una ficha multirregional (versión preliminar), también se borran 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 realizar con suscripciones a través de la API, consulta los métodos projects.locations.subscriptions.

Flujos de trabajo del publicador para administrar suscripciones

En las siguientes secciones, se describe lo que pueden hacer los publicadores de uso compartido de BigQuery con 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 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. Haz clic en el nombre del intercambio de datos en el que deseas enumerar las suscripciones.

  3. Haz clic en la pestaña Suscripciones para ver todas las suscripciones a las fichas dentro del intercambio de datos.

API

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

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

Reemplaza lo siguiente:

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

Cómo revocar una suscripción

Cuando un publicador de uso compartido de BigQuery revoca una suscripción, el suscriptor ya no puede consultar el conjunto de datos vinculado. Dado que el publicador inicia 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.

Si un publicador revoca una suscripción de una ficha multirregional (versión preliminar), los suscriptores ya no podrán consultar ninguna réplica de conjunto de datos vinculado principal o secundario.

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

Console

  1. En la consola de Google Cloud , 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. Haz clic en el nombre del intercambio de datos en el que deseas revocar la ficha.

  3. Haz clic en la pestaña Suscripciones para ver todas las suscripciones al intercambio de datos.

  4. Selecciona las suscripciones que deseas 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

Reemplaza lo siguiente:

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

Limitaciones

Las suscripciones tienen las siguientes limitaciones:

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

¿Qué sigue?