Gérer les abonnements

Ce document explique comment gérer vos abonnements au partage BigQuery, en couvrant les tâches pour les abonnés et les éditeurs.

En tant qu'abonné à BigQuery Sharing, vous pouvez effectuer les opérations suivantes :

  • S'abonner à une fiche.
  • Regrouper vos abonnements actuels dans un projet Google Cloud donné.
  • Supprimez un abonnement.

En tant qu'éditeur de partage BigQuery, vous pouvez effectuer les opérations suivantes :

  • Afficher tous les abonnements de votre fiche.
  • Révoquer l'accès à un abonnement spécifique.

Un abonnement au partage BigQuery est une ressource régionalisée qui réside dans le projet de l'abonné. Les abonnements stockent des informations pertinentes sur l'abonné et représentent le contrat entre l'éditeur et l'abonné.

Avant de commencer

Pour commencer à utiliser BigQuery Sharing (anciennement Analytics Hub), vous devez activer l'API Analytics Hub dans votre projet Google Cloud .

Pour activer l'API Analytics Hub, vous devez disposer des autorisations IAM (Identity and Access Management) suivantes :

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

Le rôle IAM prédéfini suivant inclut les autorisations dont vous avez besoin pour activer l'API Analytics Hub :

Pour activer l'API Analytics Hub, sélectionnez l'une des options suivantes :

Console

Accédez à la page de l'API Analytics Hub et activez-la pour votre projet Google Cloud .

Activer l'API Analytics Hub

gcloud

Exécutez la commande gcloud services enable :

gcloud services enable analyticshub.googleapis.com

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les abonnements, demandez à votre administrateur de vous accorder le rôle IAM Propriétaire de l'abonnement Analytics Hub (roles/analyticshub.subscriptionOwner) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Workflows des abonnés pour gérer les abonnements

Les sections suivantes décrivent ce que les abonnés BigQuery Sharing peuvent faire avec les abonnements.

S'abonner à des fiches

Pour vous abonner à des fiches, suivez les étapes décrites dans Afficher et s'abonner à des fiches et des échanges de données.

Répertorier les abonnements

Pour lister vos abonnements actuels dans un projet donné, utilisez la méthode projects.locations.subscriptions.list :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet Google Cloud pour les abonnements que vous souhaitez lister.
  • LOCATION : emplacement des abonnements que vous souhaitez lister.

Supprimer un abonnement

Pour supprimer un abonnement, utilisez la méthode projects.locations.subscriptions.delete :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet de l'abonnement à supprimer.
  • LOCATION : emplacement de l'abonnement à supprimer. Pour en savoir plus sur les régions où le partage est disponible, consultez Régions où le service est disponible.
  • SUBSCRIPTION_ID : ID de l'abonnement à supprimer.

Le corps de la requête doit être vide. Si la requête aboutit, le corps de la réponse contient une instance d'opération.

Lorsqu'un abonné au partage BigQuery supprime un abonnement, l'ensemble de données associé est également supprimé du projet de l'abonné.

Lorsque vous supprimez un abonnement d'une fiche multirégionale (aperçu), toutes les répliques d'ensembles de données associés (principales et secondaires) sont également supprimées du projet de l'abonné.

Pour en savoir plus sur les tâches que vous pouvez effectuer avec les abonnements à l'aide de l'API, consultez les méthodes projects.locations.subscriptions.

Workflows pour les éditeurs permettant de gérer les abonnements

Les sections suivantes décrivent ce que les éditeurs de partage BigQuery peuvent faire avec les abonnements. Pour en savoir plus sur la gestion des abonnements associés aux fiches, consultez Gérer les fiches.

Répertorier les abonnements

Pour lister tous les abonnements, sélectionnez l'une des options suivantes.

Console

  1. Dans la console Google Cloud , accédez à la page Partage (Analytics Hub).

    Accéder à "Partage" (Analytics Hub)

    La page liste tous les échanges de données auxquels vous pouvez accéder.

  2. Cliquez sur le nom de l'échange de données dans lequel vous souhaitez regrouper les abonnements.

  3. Cliquez sur l'onglet Abonnements pour afficher tous les abonnements associés aux fiches de l'échange de données.

API

Pour répertorier les abonnements aux fiches dans un échange de données particulier, utilisez la méthode projects.locations.dataExchanges.listSubscriptions.

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet de l'échange de données pour lequel lister les abonnements.
  • LOCATION : emplacement de l'échange de données pour lequel lister les abonnements.
  • DATAEXCHANGE_ID : ID de l'échange de données pour lequel lister les abonnements.

Révoquer un abonnement

Lorsqu'un éditeur de partage BigQuery révoque un abonnement, l'abonné ne peut plus interroger l'ensemble de données associé. Étant donné que cette action est initiée par l'éditeur sur une ressource appartenant à l'abonné, l'ensemble de données associé reste dans le projet de l'abonné. L'abonné peut supprimer l'ensemble de données.

Si un éditeur révoque un abonnement à partir d'une fiche multirégionale (aperçu), les abonnés ne peuvent plus interroger les répliques d'ensembles de données associés principaux ou secondaires.

Pour révoquer un abonnement, sélectionnez l'une des options suivantes :

Console

  1. Dans la console Google Cloud , accédez à la page Partage (Analytics Hub).

    Accéder à "Partage" (Analytics Hub)

    La page liste tous les échanges de données auxquels vous pouvez accéder.

  2. Cliquez sur le nom de l'échange de données dans lequel vous souhaitez révoquer la fiche.

  3. Cliquez sur l'onglet Abonnements pour afficher tous les abonnements de l'échange de données.

  4. Sélectionnez les abonnements à révoquer.

  5. Cliquez sur Révoquer les abonnements.

API

Pour révoquer un abonnement, utilisez la méthode projects.locations.subscriptions.revoke.

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID de projet de l'abonnement à révoquer.
  • LOCATION : emplacement de l'abonnement.
  • SUBSCRIPTION_ID : ID de l'abonnement à révoquer.

Limites

Les abonnements sont soumis aux limites suivantes :

  • Vous ne pouvez utiliser l'API que pour gérer les abonnements créés après le 25 juillet 2023. Les ensembles de données associés créés avant cette date ne sont pas compatibles, car ils ne disposent pas de la ressource d'abonnement requise.

Étapes suivantes