Gérer les abonnements

En tant qu'abonné Analytics Hub, vous pouvez effectuer les tâches suivantes :

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

En tant qu'éditeur Analytics Hub, vous pouvez effectuer les tâches suivantes :

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

Un abonnement 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 .

Autorisations requises

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 :

• roles/serviceusage.serviceUsageAdmin

Pour en savoir plus sur les rôles IAM dans BigQuery, consultez la page Rôles prédéfinis et autorisations.

Activer l'API Analytics Hub

Pour activer l'API Analytics Hub, procédez comme suit :

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 la page 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.

Workflow pour les abonnés

Les abonnés peuvent effectuer les actions suivantes avec les abonnements.

S'abonner à des fiches

Pour vous abonner à des fiches, suivez les étapes décrites dans la section S'abonner à des fiches.

Répertorier les abonnements

Pour afficher 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 contenant les abonnements que vous souhaitez regrouper.

• LOCATION : emplacement pour lequel vous souhaitez regrouper les abonnements existants.

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 contenant l'abonnement que vous souhaitez supprimer.
• LOCATION : emplacement de l'abonnement que vous souhaitez supprimer. Pour en savoir plus sur les régions compatibles avec le partage BigQuery, consultez Régions où le service est disponible.
• 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 de l'opération.

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

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

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

Workflow pour les éditeurs

Les éditeurs peuvent effectuer les actions suivantes avec les abonnements. Pour en savoir plus sur la gestion des abonnements associés aux fiches, consultez la section Gérer les fiches.

Répertorier les abonnements

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

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

Révoquer un abonnement

Lorsqu'un éditeur révoque un abonnement, l'abonné ne peut plus interroger l'ensemble de données associé. Comme il s'agit d'une action initiée par l'éditeur sur une ressource appartenant à l'abonné, l'ensemble de données associé reste en suspens dans le projet de l'abonné. L'abonné peut choisir de supprimer l'ensemble de données orphelin.

Si un éditeur révoque un abonnement à une fiche pour plusieurs régions (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 :

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

Limites

Les abonnements sont soumis aux limites suivantes :

• Les ensembles de données associés ayant été créés avant le 25 juillet 2023 ne sont pas remplis. Seuls les abonnements créés après le 25 juillet 2023 sont compatibles avec les méthodes d'API.

Étapes suivantes

• En savoir plus sur l'architecture de BigQuery Sharing
• Découvrez comment afficher les fiches et s'y abonner.
• Découvrez les rôles utilisateur Analytics Hub.
• Découvrez comment créer des ensembles de données.
• En savoir plus sur la journalisation d'audit BigQuery Sharing