Gérer les abonnements

Vous pouvez gérer vos abonnements dans BigQuery Sharing (anciennement Analytics Hub) pour contrôler l'accès aux données et leur partage. En tant qu'abonné, vous pouvez vous abonner à des fiches, afficher vos abonnements et les supprimer. En tant qu'éditeur, vous pouvez surveiller qui a accès à vos fiches et révoquer les abonnements si nécessaire. Un abonnement BigQuery Sharing est une ressource régionalisée qui réside dans le projet de l'abonné. Les abonnements stockent des informations 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 via des rôles personnalisés ou d'autres rôles prédéfinis.

Limites

Les abonnements sont soumis aux limites suivantes :

  • Vous ne pouvez utiliser l'API Analytics Hub 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.

Gérer les abonnements en tant qu'abonné

Les sections suivantes décrivent comment les abonnés au partage BigQuery gèrent 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 dans un projet, appelez la méthode projects.locations.subscriptions.list :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet Google Cloud contenant les abonnements que vous souhaitez répertorier.
  • LOCATION : emplacement des abonnements que vous souhaitez lister. Pour en savoir plus sur les régions où le partage est disponible, consultez Régions où le service est disponible.

Actualiser un abonnement

Un échange de données ou une data clean room peuvent devenir obsolètes lorsqu'un éditeur ou un contributeur ajoute ou supprime des données. Dans ce cas, votre ensemble de données associé existant n'est pas automatiquement mis à jour. Vous devez actualiser votre abonnement pour accéder aux nouvelles ressources.

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

Console

  1. Dans la console Google Cloud , accédez à la page BigQuery.

    Accéder à BigQuery

  2. Dans le volet Explorateur, cliquez sur  Ajouter des données.

  3. Sélectionnez Partage (Analytics Hub). Une page de découverte s'affiche.

  4. Recherchez la salle blanche de données ou l'échange de données auxquels vous êtes abonné, puis cliquez dessus.

  5. Cliquez sur S'abonner. Étant donné que vous disposez déjà d'un abonnement actif, la console affiche l'option Actualiser.

  6. Cliquez sur Actualiser pour mettre à jour votre ensemble de données associé avec les dernières ressources.

API

Pour actualiser un abonnement, utilisez la méthode projects.locations.subscriptions.refresh :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet de l'abonnement que vous souhaitez actualiser.
  • LOCATION : emplacement de l'abonnement que vous souhaitez actualiser.
  • SUBSCRIPTION_ID : ID de l'abonnement que vous souhaitez actualiser.

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.

Supprimer un abonnement

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

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

Remplacez les éléments suivants :

  • PROJECT_ID : Google Cloud ID du projet contenant l'abonnement que vous souhaitez supprimer.
  • LOCATION : emplacement de l'abonnement que vous souhaitez supprimer.
  • SUBSCRIPTION_ID : ID de l'abonnement que vous souhaitez 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.

Lorsque vous supprimez un abonnement, l'ensemble de données associé est également supprimé de votre projet.

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

Pour en savoir plus sur la gestion des abonnements à l'aide de l'API Analytics Hub, consultez les méthodes projects.locations.subscriptions.

Gérer les abonnements en tant qu'éditeur

Les sections suivantes décrivent comment les éditeurs de partage BigQuery gèrent 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 au partage (Analytics Hub)

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

  2. Dans la liste des échanges de données, cliquez sur le nom de celui qui contient les abonnements que vous souhaitez lister.

  3. Cliquez sur l'onglet Abonnements.

API

Pour répertorier les abonnements aux fiches d'un échange de données spécifique, appelez la méthode projects.locations.dataExchanges.listSubscriptions :

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet Google Cloud contenant l'échange de données.
  • LOCATION : emplacement de l'échange de données contenant les abonnements que vous souhaitez lister.
  • DATAEXCHANGE_ID : ID de l'échange de données pour lequel lister les abonnements.

Révoquer un abonnement

Lorsque vous révoquez un abonnement en tant qu'éditeur BigQuery Sharing, l'abonné ne peut plus interroger l'ensemble de données associé. Étant donné que vous lancez cette action 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.

Lorsque vous révoquez un abonnement à partir d'une fiche multirégionale, 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 au partage (Analytics Hub)

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

  2. Dans la liste des échanges de données, cliquez sur le nom de celui qui contient l'abonnement que vous souhaitez révoquer.

  3. Cliquez sur l'onglet Abonnements.

  4. Cochez la case à côté de chaque abonnement que vous souhaitez révoquer.

  5. Cliquez sur Révoquer les abonnements.

API

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

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

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet Google Cloud du projet contenant l'abonnement que vous souhaitez révoquer.
  • LOCATION : emplacement de l'abonnement que vous souhaitez révoquer.
  • SUBSCRIPTION_ID : ID de l'abonnement que vous souhaitez révoquer.

Étapes suivantes