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 sur le projet d'abonné :

• Découvrir les fiches : Lecteur Analytics Hub (roles/analyticshub.viewer)

• S'abonner à des fiches : Utilisateur BigQuery (roles/bigquery.user)

  • 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.

• Afficher les ensembles de données associés : Lecteur de données BigQuery (roles/bigquery.dataViewer)

• Interroger des ensembles de données associés : Lecteur de données BigQuery (roles/bigquery.dataViewer)

• Mettre à jour des ensembles de données associés : Propriétaire de données BigQuery (roles/bigquery.dataOwner)

• Afficher les métadonnées de table : Lecteur de données BigQuery (roles/bigquery.dataViewer)

• Supprimer les ensembles de données associés : Administrateur BigQuery (roles/bigquery.admin)

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 :

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 add 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 :

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

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 :

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 more_vert Actions, puis cliquez sur Ouvrir.

4. Dans le panneau Détails, cliquez sur mode_edit  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 more_vert 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

• Apprenez-en davantage sur Analytics Hub.
• En savoir plus sur la gestion des fiches.
• Découvrez comment gérer les échanges de données.
• Découvrez les journaux d'audit d'Analytics Hub.