Afficher les fiches et s'y abonner

En tant qu'abonné Analytics Hub, vous pouvez afficher les fiches auxquelles vous avez accès et vous y abonner. L'abonnement à une fiche crée un ensemble de données associé dans votre projet.

Rôles requis

Pour obtenir les autorisations nécessaires pour utiliser les fiches, demandez à votre administrateur de vous accorder les rôles IAM (Identity and Access Management) suivants :

Pour vous abonner à des fiches, vous devez également demander à l'éditeur de la fiche de vous accorder le rôle d'abonné Analytics Hub (roles/analyticshub.subscriber) sur sa fiche, son échange ou son projet, selon le champ d'application le plus approprié à votre cas d'utilisation.

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Ces rôles prédéfinis contiennent les autorisations requises pour effectuer les tâches décrites dans ce document. Pour afficher les autorisations exactes requises pour créer et interroger des ensembles de données, développez la section Autorisations requises :

Autorisations requises

  • Pour créer des ensembles de données : bigquery.datasets.create, ou bigquery.datasets.* pour effectuer des actions supplémentaires sur les ensembles de données.
  • Pour interroger des ensembles de données : bigquery.jobs.create, ou bigquery.jobs.* pour effectuer des actions supplémentaires sur les jobs.

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

Découvrir des fiches

Pour découvrir des fiches publiques et privées, procédez comme suit :

  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. Dans la boîte de dialogue Ajouter des données, cliquez sur Analytics Hub. La boîte de dialogue Analytics Hub s'affiche. Elle contient des fiches auxquelles vous pouvez accéder. Pour les listes Salesforce Data Cloud, un bouton permet de filtrer automatiquement les fiches associées dans le volet Explorateur.

    Pour ouvrir la boîte de dialogue Analytics Hub, vous pouvez également accéder à Analytics Hub et cliquer sur Rechercher des fiches.

  4. Pour filtrer les fiches en fonction de leur nom ou de leur description, saisissez le nom ou la description de la fiche dans le champ Rechercher des fiches.

  5. Dans la section Filtre, vous pouvez filtrer les fiches en fonction des champs suivants :

    • Fiches : indiquez si vous souhaitez afficher les fiches privées, les fiches publiques ou les fiches au sein de votre organisation.

    • Catégories : sélectionnez les catégories souhaitées.

    • Emplacement : sélectionnez l'emplacement souhaité. Pour en savoir plus, consultez la section Régions où le service est disponible.

    • Fournisseur : sélectionnez le fournisseur de données. Certains fournisseurs de données nécessitent que vous demandiez l'accès à leurs ensembles de données commerciaux. Après avoir demandé l'accès, le fournisseur de données vous contacte pour partager ses ensembles de données.

  6. Parcourez les fiches filtrées.

S'abonner à des fiches

L'abonnement à une fiche vous donne un accès en lecture seule aux données de la fiche en créant un ensemble de données associé dans votre projet.

Pour vous abonner à une fiche, procédez comme suit :

Console

  1. Pour afficher une liste des fiches auxquelles vous avez accès, suivez les étapes décrites dans la section Afficher les fiches.

  2. Parcourez les fiches et cliquez sur une fiche à laquelle vous souhaitez vous abonner. Une boîte de dialogue contenant les détails de la fiche s'affiche.

  3. Si vous n'avez pas accès à l'abonnement pour une fiche, par exemple pour une fiche faisant référence à un ensemble de données commercial, cliquez sur Demander l'accès. Si vous cliquez sur un ensemble de données auquel vous pouvez vous abonner, cliquez sur Ajouter un ensemble de données au projet pour ouvrir la boîte de dialogue Créer un ensemble de données associé.

  4. Si l'API Analytics Hub n'est pas activée dans votre projet, un message d'erreur s'affiche avec un lien permettant d'activer l'API. Cliquez sur Activer l'API Analytics Hub.

  5. Dans la boîte de dialogue Créer un ensemble de données associé, spécifiez les détails suivants :

    • Projet : spécifiez le nom du projet dans lequel vous souhaitez ajouter l'ensemble de données.
    • Nom de l'ensemble de données associé : spécifiez le nom de l'ensemble de données associé.
  6. Pour enregistrer vos modifications, cliquez sur Enregistrer. L'ensemble de données associé est répertorié dans votre projet.

API

Exécutez la méthode projects.locations.dataExchanges.listings.subscribe.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:subscribe

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet de la fiche à laquelle vous souhaitez vous abonner.
  • LOCATION : emplacement de la fiche à laquelle vous souhaitez vous abonner.
  • DATAEXCHANGE_ID : ID d'échange de données de la fiche à laquelle vous souhaitez vous abonner.
  • LISTING_ID : ID de la fiche à laquelle vous souhaitez vous abonner.

Dans le corps de la requête, spécifiez l'ensemble de données dans lequel vous souhaitez créer l'ensemble de données associé. Si la requête aboutit, le corps de la réponse est vide.

Afficher les ensembles de données associés

Les ensembles de données associés s'affichent avec les autres ensembles de données dans la console Google Cloud.

Procédez comme suit pour afficher les ensembles de données associés dans votre projet :

Console

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

    Accéder à BigQuery

  2. Dans le panneau Explorateur, cliquez sur le nom de votre projet contenant l'ensemble de données associé .

Vous pouvez également utiliser Data Catalog pour rechercher et afficher des ensembles de données associés. Pour faire correspondre tous les ensembles de données associés à Analytics Hub, utilisez le prédicat type=dataset.linked. Pour en savoir plus, consultez la section Syntaxe de recherche dans Data Catalog.

Cloud Shell

Exécutez la commande suivante :

PROJECT=<your project ID> \
for dataset in $(bq ls --project_id $PROJECT | tail +3); do [ "$(bq show -d --project_id $PROJECT $dataset | egrep LINKED)" ] && echo $dataset; done

Interroger des ensembles de données associés

Vous pouvez interroger les tables et les vues de vos ensembles de données associés de la même manière que vous interrogez n'importe quelle autre table BigQuery.

Mettre à jour des ensembles de données associés

Les ressources d'un ensemble de données associé sont en lecture seule. Vous ne pouvez pas modifier les données ni les métadonnées des ressources des ensembles de données associés, ni spécifier des autorisations pour des ressources individuelles.

Vous ne pouvez mettre à jour que la description et les libellés de vos ensembles de données associés. Les modifications apportées à un ensemble de données associé n'affectent pas les ensembles de données sources ou partagés.

Pour mettre à jour la description et les libellés d'un ensemble de données associé, procédez comme suit :

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

    Accéder à BigQuery

  2. Dans le panneau Explorateur, cliquez sur le nom de votre projet, puis sur l'ensemble de données associé.

  3. Développez l'option Actions, puis cliquez sur Ouvrir.

  4. Dans le panneau Détails, cliquez sur  Modifier les détails, puis spécifiez les informations suivantes :

    1. Pour ajouter des libellés, consultez la section Ajouter un libellé à un ensemble de données.
    2. Pour activer le classement, développez la section Options avancées et procédez comme suit :

      1. Sélectionnez Activer le classement par défaut.
      2. Dans la liste Classement par défaut, sélectionnez une option.
  5. Cliquez sur Enregistrer.

Afficher les métadonnées de table

Pour afficher les métadonnées de la table sous-jacente, interrogez la vue INFORMATION_SCHEMA.TABLES :

SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`

Remplacez LINKED-DATASET par le nom de l'ensemble de données associé.

Supprimer les ensembles de données associés

Si votre abonnement est supprimé par un éditeur Analytics Hub, votre ensemble de données associé est dissocié de l'ensemble de données partagé. Vous pouvez supprimer un ensemble de données dissocié, car celui-ci ne peut pas être interrogé.

La suppression d'un ensemble de données associé ne supprime pas l'ensemble de données source. Vous ne pouvez pas récupérer un ensemble de données associé que vous avez supprimé. Toutefois, vous pouvez le recréer en vous réabonnant à la fiche et en ajoutant l'ensemble de données à votre projet.

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

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

    Accéder à BigQuery

  2. Dans le panneau Explorateur, cliquez sur le nom de votre projet, puis sur l'ensemble de données associé.

  3. Développez l'option Actions, puis cliquez sur Supprimer.

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

  5. Cliquez sur Supprimer.

Étape suivante