Gérer les échanges de données

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

  • Créer, mettre à jour, afficher, partager et supprimer des échanges de données
  • Créer, mettre à jour, supprimer et partager des fiches.
  • Gérer les administrateurs Analytics Hub, les administrateurs, éditeurs, abonnés et lecteurs de fiches.

Par défaut, un échange de données est privé et seuls les utilisateurs ou les groupes ayant accès à cet échange peuvent afficher les données ou s'y abonner. Toutefois, si vous souhaitez que les fiches puissent être découvertes et faire l'objet d'abonnements par les utilisateurs Google Cloud (allAuthenticatedUsers), vous pouvez demander à rendre votre échange de données public.

Avant de commencer

Pour commencer à utiliser 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 :

Console

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

Activer l'API Analytics Hub

gcloud

Exécutez la commande gcloud services enable :

gcloud services enable analyticshub.googleapis.com

Autorisations requises

Pour gérer les échanges de données, vous devez disposer du rôle Administrateur Analytics Hub (roles/analyticshub.admin). Pour en savoir plus, consultez la section Rôle d'administrateur Analytics Hub. Pour savoir comment attribuer ce rôle à d'autres utilisateurs, consultez la section Créer des administrateurs Analytics Hub.

Créer un échange de données

Pour créer un échange de données, procédez comme suit :

Console

  1. Accédez à la page Analytics Hub.

    Accéder à Analytics Hub

  2. Cliquez sur  Créer un échange.

  3. Dans la boîte de dialogue Créer un échange, sélectionnez un projet et une région pour votre échange de données. Vous ne pouvez pas mettre à jour le projet et la région après avoir créé l'échange de données.

  4. Comme Nom à afficher, saisissez le nom de votre échange de données.

  5. Facultatif : saisissez des valeurs dans les champs suivants :

    • Contact principal : saisissez l'URL ou l'adresse e-mail du contact principal pour l'échange de données.
    • Description : saisissez une description de l'échange de données.

  6. Pour activer la visibilité publique, cliquez sur le bouton Visibilité publique. Une fois qu'une place de marché est visible publiquement, toutes les fiches qu'elle contient sont affichées et peuvent faire l'objet d'une recherche dans le catalogue. Si vous activez la visibilité publique, vous devez configurer les autorisations de l'échange. En raison de l'héritage des autorisations, toutes les fiches seront définies par défaut avec le même type de visibilité publique de l'échange. Par conséquent, les échanges publics ne peuvent pas comporter de fiches privées, mais les échanges privés peuvent avoir des fiches publiques (par exemple, vous pouvez définir le type de visibilité publique au niveau de la fiche individuelle). Le projet dans lequel vous créez l'échange de données doit être associé à une organisation et à un compte de facturation.

  7. Cliquez sur Créer un échange.

  8. Facultatif : dans la section Autorisations de l'échange, procédez comme suit :

    1. Saisissez les adresses e-mail dans les champs suivants pour attribuer les rôles utilisateur Analytics Hub :

    2. Pour enregistrer les autorisations, cliquez sur Définir des autorisations.

  9. Si vous n'avez pas défini d'autorisations pour votre échange de données, cliquez sur Ignorer.

API

Exécutez la méthode projects.locations.dataExchanges.create.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges?dataExchangeId=DATAEXCHANGE_ID

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet dans lequel vous souhaitez créer l'échange de données.
  • LOCATION : emplacement de votre échange de données. Pour en savoir plus sur les emplacements compatibles avec Analytics Hub, consultez la page Régions compatibles.
  • DATAEXCHANGE_ID : ID de votre échange de données

Dans le corps de la requête, indiquez les détails de l'échange de données. Si la requête aboutit, le corps de la réponse contient des détails de l'échange de données.

Pour plus d'informations sur les tâches que vous pouvez effectuer sur des échanges de données à l'aide des API, consultez la page Méthodes projects.locations.dataExchanges.

Mettre à jour un échange de données

Pour mettre à jour un échange de données, procédez comme suit :

Console

  1. Accédez à la page Analytics Hub.

    Accéder à Analytics Hub

  2. Dans la liste des échanges de données, cliquez sur celui que vous souhaitez mettre à jour.

  3. Cliquez sur  Modifier l'échange.

  4. Dans la boîte de dialogue Modifier l'échange, mettez à jour les champs suivants :

    • Nom à afficher
    • Contact principal
    • Description
    • Visibilité publique
      • Si vous activez la visibilité publique, attribuez le rôle Lecteur Analytics Hub (roles/analyticshub.viewer) à allUsers ou allAuthenticatedUsers.
      • Si vous désactivez la visibilité publique, supprimez le rôle Lecteur Analytics Hub (roles/analyticshub.viewer) de allUsers ou allAuthenticatedUsers. Les échanges publics ne peuvent pas comporter de fiches privées, mais les échanges privés peuvent comporter des fiches privées.

  5. Cliquez sur Enregistrer.

API

Exécutez la méthode projects.locations.dataExchanges.patch.

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID?updateMask=UPDATEMASK

Remplacez UPDATEMASK par la liste des champs que vous souhaitez mettre à jour. Pour mettre à jour plusieurs valeurs, utilisez une liste d'éléments séparés par une virgule. Par exemple, pour mettre à jour le nom à afficher et le contact principal d'un échange de données, saisissez displayName,primaryContact.

Dans le corps de la requête, spécifiez les valeurs mises à jour pour les champs suivants :

  • Nom à afficher
  • Description
  • Documentation
  • Icône
  • Contact principal
  • Visibilité publique

Pour plus d'informations sur les tâches que vous pouvez effectuer sur des échanges de données à l'aide des API, consultez la page Méthodes projects.locations.dataExchanges.

Afficher les échanges de données

Pour afficher tous les échanges de données dans votre organisation auxquels vous avez accès, procédez comme suit:

Console

  1. Accédez à la page Analytics Hub.

    Accéder à Analytics Hub

  2. Afficher la liste des échanges de données au sein de votre organisation Google Cloud

API

Exécutez la méthode organizations.locations.dataExchanges.list.

GET https://analyticshub.googleapis.com/v1/organizations/ORGANIZATION_ID/location/LOCATION/dataExchanges

Remplacez les éléments suivants :

  • ORGANIZATION_ID : ID de l'organisation. Pour en savoir plus, consultez la page Obtenir l'ID de votre organisation.
  • LOCATION: emplacement pour lequel vous souhaitez répertorier les échanges de données existants.

Partager un échange de données

Si l'éditeur Analytics Hub appartient à une organisation différente de celle qui contient l'échange de données, il ne peut pas afficher votre échange de données dans Analytics Hub. Vous devez partager un lien vers l'échange de données avec l'éditeur.

  1. Accédez à la page Analytics Hub.

    Accéder à Analytics Hub

  2. Dans la liste des échanges de données, cliquez sur Autres options.

  3. Cliquez sur Copier le lien de partage.

Autoriser des utilisateurs à accéder à un échange de données

Pour autoriser des utilisateurs à accéder à un échange de données, vous devez définir la stratégie IAM pour cet échange. Pour en savoir plus sur les rôles utilisateur IAM prédéfinis, consultez la section Rôles utilisateur Analytics Hub. Pour cela, procédez comme suit :

Console

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

    Accéder à Analytics Hub

  2. Cliquez sur le nom de l'échange de données pour lequel vous souhaitez définir des autorisations.

  3. Cliquez sur  Définir les autorisations.

  4. Pour ajouter des comptes principaux, cliquez sur  Ajouter un compte principal.

  5. Dans le champ Nouveaux comptes principaux, ajoutez les adresses e-mail auxquelles vous souhaitez accorder l'accès.

  6. Pour Sélectionner un rôle, maintenez le pointeur sur Analytics Hub, puis sélectionnez l'un des rôles IAM (Identity and Access Management) suivants :

    • Administrateur Analytics Hub
    • Éditeur Analytics Hub
    • Administrateur de listes Analytics Hub
    • Abonné Analytics Hub
    • Lecteur Analytics Hub

  7. Cliquez sur Enregistrer.

API

  1. Consultez la stratégie existante à l'aide de la méthode projects.locations.dataExchanges.getIamPolicy, qui exploite la méthode de création de liste getIamPolicy :

    POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:getIamPolicy

    Remplacez les éléments suivants :

    • PROJECT_ID : ID du projet, par exemple my-project-1
    • LOCATION : emplacement de votre échange de données
    • DATAEXCHANGE_ID : ID de l'échange de données

    Analytics Hub affiche la stratégie actuelle.

  2. Pour ajouter ou supprimer des membres et les rôles IAM qui leur sont associés, modifiez la stratégie à l'aide d'un éditeur de texte. Utilisez le format suivant pour ajouter des membres :

    • user:test-user@gmail.com
    • group:admins@example.com
    • serviceAccount:test123@example.domain.com
    • domain:example.domain.com

    Par exemple, pour accorder le rôle roles/analyticshub.subscriber à group:subscribers@example.com, ajoutez la liaison suivante à la stratégie :

    {
 "members": [
   "group:subscribers@example.com"
 ],
 "role":"roles/analyticshub.subscriber"
}

  3. Écrivez la stratégie mise à jour à l'aide de la méthode projects.locations.dataExchanges.setIamPolicy. Dans le corps de la requête, indiquez la stratégie IAM mise à jour de l'étape précédente.

    POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:setIamPolicy

    Dans le corps de la requête, indiquez les informations détaillées relatives à la liste demandée. Si la requête aboutit, le corps de la réponse contient des détails de la liste.

Créer des administrateurs Analytics Hub

Pour gérer les échanges de données, vous devez créer des administrateurs Analytics Hub. Pour créer des administrateurs d'échanges de données, vous devez attribuer aux utilisateurs le rôle Administrateur Analytics Hub (roles/analyticshub.admin) au niveau du projet ou de l'échange.

Si vous souhaitez que les administrateurs gèrent tous les échanges de données d'un projet, attribuez le rôle Administrateur Analytics Hub pour ce projet. Si vous souhaitez que les administrateurs gèrent un échange de données spécifique, accordez le rôle Administrateur Analytics Hub pour cet échange de données.

Rendre un échange de données public

Par défaut, un échange de données est privé et seuls les utilisateurs ou les groupes ayant accès à cet échange peuvent afficher les fiches associées ou s'y abonner. Toutefois, vous pouvez choisir de rendre un échange de données public. Les fiches des échanges de données publics peuvent être découvertes et faire l'objet d'abonnements par les utilisateurs Google Cloud (allAuthenticatedUsers).

Pour rendre un échange de données public, procédez comme suit :

  1. Pour permettre aux utilisateurs allAuthenticatedUsers d'afficher des fiches, vous devez leur accorder le rôle Lecteur Analytics Hub au niveau de l'échange de données.

  2. Pour permettre aux utilisateurs allAuthenticatedUsers de s'abonner aux fiches, vous devez leur accorder le rôle Abonné Analytics Hub au niveau de l'échange de données.

  3. Activez la visibilité publique lorsque vous create ou mettez à jour un échange de données. Spécifiez les autorisations appropriées lorsque vous rendez un échange de données public.

Supprimer un échange de données

Lorsqu'un échange de données est supprimé, toutes les fiches qu'il contient sont également supprimées. Toutefois, les ensembles de données partagés et les ensembles de données associés ne sont pas supprimés. En outre, lorsqu'un projet est supprimé, les échanges de données qu'il contient ne sont pas supprimés. Vous devez supprimer ces échanges de données avant de supprimer le projet. Si vous supprimez un échange de données, cette action est irréversible.

Pour supprimer un échange de données, procédez comme suit :

Console

  1. Accédez à la page Analytics Hub.

    Accéder à Analytics Hub

  2. Dans la liste des échanges de données, cliquez sur celui que vous souhaitez supprimer.

  3. Cliquez sur  Supprimer l'échange.

  4. Dans la boîte de dialogue Supprimer l'échange ?, confirmez la suppression en saisissant delete.

  5. Cliquez sur Supprimer.

API

Exécutez la méthode projects.locations.dataExchanges.delete.

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

Pour plus d'informations sur les tâches que vous pouvez effectuer sur des échanges de données à l'aide des API, consultez la page Méthodes projects.locations.dataExchanges.

Étape suivante