Gérer les fiches

Console

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

Activer l'API Analytics Hub

gcloud

Exécutez la commande gcloud services enable :

gcloud services enable analyticshub.googleapis.com

Console

1. Accédez à la page Partage (Analytics Hub).

   Accéder à "Partage" (Analytics Hub)

   Une page qui répertorie tous les échanges de données auxquels vous pouvez accéder s'affiche.

2. Cliquez sur le nom de l'échange de données dans lequel vous souhaitez créer la fiche.

3. Cliquez sur add_box Créer une fiche.

4. Dans la section Configurer les données, dans le menu Type de ressource, sélectionnez Ensemble de données BigQuery ou Sujet Pub/Sub.

   • Si vous sélectionnez Ensemble de données BigQuery, procédez comme suit :

     1. Dans le menu Ensemble de données partagé, sélectionnez un ensemble de données existant ou cliquez sur Créer un ensemble de données. L'ensemble de données doit se trouver dans la même région que l'échange de données. Une fois la fiche créée, vous ne pouvez plus modifier l'ensemble de données partagé. Lorsque les abonnés affichent les métadonnées de l'ensemble de données associé, le partage BigQuery renvoie le nom de l'ensemble de données source et l'ID du projet contenant l'ensemble de données.
     2. Facultatif : Pour autoriser les abonnés à partager une procédure stockée SQL dans plusieurs fiches, sélectionnez Autoriser le partage de procédures stockées (Aperçu).
     3. Pour rendre l'ensemble de données partagé disponible dans d'autres régions, développez le menu Disponibilité des données par région. Le menu affiche les régions qui disposent d'instances répliquées de l'ensemble de données existantes, avec le libellé Prêt à l'emploi. Avant de configurer la fiche pour plusieurs régions, vérifiez que vous avez activé la réplication des ensembles de données multirégionaux sur l'ensemble de données partagé. Vous ne pouvez sélectionner que les régions dans lesquelles la réplication interrégionale des ensembles de données est activée. Toutes les autres régions sont marquées comme Non disponibles. Si vous ne sélectionnez aucune région supplémentaire, la fiche est définie par défaut sur la région principale de l'ensemble de données partagé, qui est libellée Fournisseur principal.

     4. Dans Contrôles de sortie des données, sélectionnez l'option de sortie des données appropriée :

        • Pour restreindre la copie et l'exportation des données de votre ensemble de données partagé tout en autorisant l'exportation des résultats de requête, sélectionnez Désactiver la copie et l'exportation des données partagées.
        • Pour restreindre la copie et l'exportation des données à la fois sur votre ensemble de données partagé et sur les résultats de requête, sélectionnez Désactiver la copie et l'exportation des résultats de requête. Cette option sélectionne également Désactiver la copie et l'exportation des données partagées.
        • Pour restreindre la copie et l'exportation de tables via les API sur votre ensemble de données partagé, sélectionnez Désactiver la copie et l'exportation de tables via les API. Cette option sélectionne également Désactiver la copie et l'exportation des données partagées.

        Pour en savoir plus sur les contrôles de sortie des données, y compris les restrictions, consultez Options de sortie des données (ensembles de données partagés BigQuery uniquement).

   • Si vous sélectionnez Sujet Pub/Sub, dans le menu Sujet partagé, sélectionnez un sujet Pub/Sub existant ou cliquez sur Créer un sujet pour en créer un.

5. Dans la section Informations sur la fiche, dans Nom à afficher, saisissez le nom de la fiche.

6. Saisissez les informations facultatives suivantes :

   • Catégorie : sélectionnez jusqu'à deux catégories qui représentent le mieux votre fiche. Les abonnés peuvent filtrer les fiches à l'aide des catégories que vous avez sélectionnées.
   • Affinité des données : spécifiez les régions que vous utilisez pour publier des données. Ce paramètre de localisation aide les abonnés à minimiser ou à éviter les coûts de sortie réseau Pub/Sub en lisant les données de la même région. Pour en savoir plus sur les coûts de sortie, consultez Coûts du transfert de données.
   • Icône : importez une icône pour votre fiche. Les formats de fichiers PNG et JPEG sont acceptés. Les icônes doivent avoir une taille inférieure à 512 Kio et des dimensions maximales de 512 x 512 pixels.
   • Description : saisissez une brève description de votre fiche. Les abonnés peuvent rechercher des fiches en fonction du texte de la description.

   • Visibilité publique : activez ce paramètre pour que votre fiche soit visible publiquement dans le catalogue de partage BigQuery. Si vous activez cette option, accordez le rôle Lecteur Analytics Hub (roles/analyticshub.viewer) à allUsers ou allAuthenticatedUsers. Pour en savoir plus, consultez Accorder le rôle pour une fiche. Si l'échange est déjà public, la fiche hérite de ces autorisations et aucune autre action n'est requise.

     Les échanges visibles publiquement ne peuvent pas comporter de fiches privées en raison de l'héritage des autorisations. En revanche, les échanges privés peuvent comporter des fiches publiques. Pour créer une fiche publique, le projet qui la contient doit être associé à une organisation et à un compte de facturation. Si vous créez une fiche commerciale intégrée à Cloud Marketplace, nous vous recommandons d'activer la visibilité publique.

   • Journalisation des adresses e-mail des abonnés : activez ce paramètre pour enregistrer les identifiants principaux de tous les utilisateurs qui exécutent des jobs et des requêtes sur les ensembles de données associés. Si vous activez cette option, la journalisation des adresses e-mail des abonnés sera activée pour tous les futurs abonnements créés à partir de cette fiche. Les données enregistrées sont disponibles dans la colonne job_principal_subject de la vue INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

   • Documentation > Markdown : saisissez des documents, des liens ou des instructions au format Markdown pour aider les abonnés à utiliser votre ensemble de données.

7. Dans la section Informations de contact de la fiche, saisissez les informations facultatives suivantes :

   • Contact principal : saisissez l'adresse e-mail ou l'URL du contact principal de la fiche.
   • Contact pour demander l'accès : saisissez l'adresse e-mail ou l'URL de votre formulaire de participation pour que les abonnés puissent vous contacter pour demander l'accès.

   • Fournisseur : développez la section Fournisseur et saisissez les détails dans les champs suivants :

     • Nom du fournisseur : nom du fournisseur de données.
     • Contact principal du fournisseur : adresse e-mail ou URL du contact principal du fournisseur de données.

     Les abonnés peuvent filtrer les fiches par fournisseur de données.

   • Éditeur : développez la section Éditeur et saisissez les détails dans les champs suivants :

     • Nom de l'éditeur : nom de l'éditeur qui crée la fiche.
     • Contact principal de l'éditeur : adresse e-mail ou URL du contact principal de l'éditeur.

8. Consultez la section Aperçu de la fiche.

9. Pour publier la fiche, cliquez sur Publier.

API

Utilisez la méthode projects.locations.dataExchanges.listings.create :

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

Remplacez les éléments suivants :

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

Dans le corps de la requête, indiquez les informations détaillées sur la fiche.

Pour créer une fiche dans plusieurs régions, spécifiez-les dans le champ bigqueryDataset.replicaLocations du corps de la requête. Avant de configurer la fiche pour plusieurs régions, vérifiez que vous avez activé la réplication des ensembles de données multirégionaux sur l'ensemble de données partagé. Vous ne pouvez sélectionner que les régions où la réplication des ensembles de données interrégionaux est activée. Si vous omettez ce champ facultatif, la fiche utilise la région principale de l'ensemble de données partagé.

Si la requête aboutit, le corps de la réponse renvoie les détails de la fiche. Si vous activez la journalisation des e-mails des abonnés en définissant le champ logLinkedDatasetQueryUserEmail sur true, la réponse de la fiche renvoie log_linked_dataset_query_user_email: true. Les données enregistrées sont disponibles dans la colonne job_principal_subject de la vue INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

Pour plus d'informations sur les tâches que vous pouvez effectuer sur des listes à l'aide des API, consultez la documentation sur les méthodes projects.locations.dataExchanges.listings.

Console

1. Accédez à la page Partage (Analytics Hub).

   Accéder à "Partage" (Analytics Hub)

2. Cliquez sur le nom de l'échange de données contenant la fiche.

3. Cliquez sur la fiche que vous souhaitez partager.

4. Cliquez sur person Définir les autorisations.

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

6. Dans le champ Nouveaux comptes principaux, saisissez les comptes principaux en fonction du type de fiche :

   • Pour une fiche privée, saisissez les adresses e-mail des identités auxquelles vous souhaitez accorder l'accès.

   • Pour une fiche publique, saisissez allAuthenticatedUsers.

   • Pour une fiche publique visible par tous, y compris les utilisateurs autres queCloud de Confiance by S3NS, saisissez allUsers.

7. Dans le menu Sélectionner un rôle, pointez sur Analytics Hub, puis sélectionnez un rôle en fonction du type de fiche :

   • Pour une fiche commerciale (y compris les fiches intégrées à Cloud Marketplace), sélectionnez Lecteur Analytics Hub. Ce rôle permet aux utilisateurs d'afficher la fiche et de demander l'accès.

   • Pour une fiche publique à usage non commercial ou privée, sélectionnez Abonné Analytics Hub. Ce rôle permet aux utilisateurs de s'abonner à votre fiche.

   • Pour les fiches intégrées à Cloud Marketplace, vous n'avez pas besoin d'attribuer le rôle Abonné Analytics Hub (roles/analyticshub.subscriber). Les abonnements sont gérés automatiquement en fonction de la commande Cloud Marketplace.

   Pour en savoir plus, consultez Rôles d'abonné et de lecteur Analytics Hub.

8. Pour enregistrer les autorisations, cliquez sur Enregistrer.

API

1. Lisez la stratégie existante en appelant la méthode projects.locations.dataExchanges.listings.getIamPolicy :

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

   Remplacez les éléments suivants :

   • PROJECT_ID : ID du projet, par exemple my-project-1
   • LOCATION : emplacement de l'échange de données contenant la fiche.
   • DATAEXCHANGE_ID : ID de l'échange de données
   • LISTING_ID : ID de la liste.

   Le partage renvoie la stratégie actuelle dans la réponse.

2. Pour ajouter ou supprimer des membres et les rôles qui leur sont associés, modifiez le fichier JSON de la stratégie à l'aide d'un éditeur de texte. Spécifiez les membres en respectant les formats suivants :

   • 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. Mettez à jour la stratégie en appelant la méthode projects.locations.dataExchanges.listings.setIamPolicy. Dans le corps de la requête, transmettez la stratégie IAM mise à jour de l'étape précédente.

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

   Dans le corps de la requête, transmettez les informations détaillées sur la fiche. Si la requête aboutit, le corps de la réponse renvoie les détails de la fiche avec la règle mise à jour.

Pour plus d'informations sur les tâches que vous pouvez effectuer sur des listes à l'aide des API, consultez la documentation sur les méthodes projects.locations.dataExchanges.listings.

Console

1. Accédez à la page Partage (Analytics Hub).

   Accéder à "Partage" (Analytics Hub)

2. Cliquez sur le nom de l'échange de données contenant la fiche pour laquelle vous souhaitez gérer les abonnements.

3. Cliquez sur la fiche pour laquelle vous souhaitez répertorier tous les abonnés.

4. Pour afficher tous les abonnés de votre fiche, cliquez sur Gérer les abonnements :

   

5. Facultatif : vous pouvez filtrer les résultats en fonction des informations sur les abonnés.

Si vous avez accès à l'ensemble de données partagé, vous pouvez également suivre la procédure ci-dessous pour répertorier les abonnés :

1. Accédez à la page BigQuery.

   Accéder à BigQuery

2. Dans le volet de gauche, cliquez sur explore Explorateur :

   

   Si le volet de gauche ne s'affiche pas, cliquez sur last_page Développer le volet de gauche pour l'ouvrir.

3. Dans le volet Explorateur, développez le nom de votre projet, cliquez sur Ensembles de données, puis sur le nom de l'ensemble de données partagé.

4. Dans la fiche Partage person_add, sélectionnez Gérer les abonnements.

SQL

L'exemple suivant utilise la vue INFORMATION_SCHEMA.SCHEMATA_LINKS pour répertorier tous les ensembles de données associés à un ensemble de données partagé dans myproject situés dans la région us :

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

Le résultat renvoyé ressemble à ceci : Certaines colonnes sont omises pour simplifier la sortie.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

Pour une liste comportant plusieurs régions, vous pouvez afficher les abonnements dans différentes régions en remplaçant la région us par l'emplacement de réplique souhaité. Par exemple, pour afficher les ensembles de données associés à un ensemble de données partagé dans myproject qui se trouvent dans la région eu, utilisez la requête suivante :

SELECT * FROM `myproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

API

Utilisez la méthode projects.locations.dataExchanges.listings.listSubscriptions.

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

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 de la place de marché contenant la fiche à laquelle vous souhaitez vous abonner.
• LISTING_ID : ID de la fiche à laquelle vous souhaitez vous abonner.

Console

1. Pour répertorier les abonnés d'une fiche, suivez les instructions de la console Cloud de Confiance dans Afficher tous les abonnements.

2. Cliquez sur Abonnements.

3. Pour sélectionner les abonnements que vous souhaitez supprimer, cochez les cases à côté de ces abonnements, puis cliquez sur delete Supprimer les abonnements.

4. Dans la boîte de dialogue Supprimer l'abonnement ?, confirmez la suppression en saisissant remove.

5. Cliquez sur Supprimer.

API

Appelez la méthode projects.locations.subscriptions.revoke :

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

Remplacez les éléments suivants :

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

Console

1. Accédez à la page Partage (Analytics Hub).

   Accéder à "Partage" (Analytics Hub)

2. Cliquez sur le nom de l'échange de données contenant la fiche.

3. Cliquez sur la fiche que vous souhaitez mettre à jour.

4. Cliquez sur mode_edit Modifier la fiche.

5. Modifiez les valeurs des champs. Vous pouvez modifier toutes les valeurs, sauf l'ensemble de données partagé de la fiche.

6. Facultatif : Mettez à jour les paramètres et la disponibilité de la fiche :

   • Pour activer la visibilité publique, accordez le rôle Lecteur Analytics Hub (roles/analyticshub.viewer) à allUsers ou allAuthenticatedUsers. Pour savoir comment attribuer des rôles à une fiche, consultez Accorder le rôle pour une fiche.
   • Pour désactiver la visibilité publique d'une fiche dans un échange privé, supprimez le rôle Lecteur Analytics Hub (roles/analyticshub.viewer) de allUsers et allAuthenticatedUsers. Si l'échange est déjà public, les autorisations de fiche sont déjà héritées et aucune autre action n'est requise.
   • Une fois que vous avez activé et enregistré la journalisation des adresses e-mail des abonnés, vous ne pouvez plus modifier ce paramètre. Pour désactiver la journalisation des e-mails, supprimez la fiche, puis recréez-la sans sélectionner Journalisation des e-mails des abonnés.
   • Pour ajouter ou supprimer des régions, modifiez votre sélection de régions. Avant d'ajouter plusieurs régions, vérifiez que vous avez activé la réplication interrégionale d'ensembles de données sur l'ensemble de données partagé. Avant de supprimer une région, supprimez la réplique de l'ensemble de données partagé dans cette région.

7. Examinez l'aperçu de la fiche.

8. Pour enregistrer les modifications, cliquez sur Save (Enregistrer). Si vous modifiez une fiche intégrée à Cloud Marketplace, une notification vous invite à modifier également la fiche produit de données Cloud Marketplace.

API

Appelez la méthode projects.locations.dataExchanges.listings.patch :

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

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet contenant l'échange de données dans lequel vous souhaitez créer la fiche.
• LOCATION : emplacement de l'échange de données.
• DATAEXCHANGE_ID : ID de l'échange de données.
• LISTING_ID : ID de la fiche à modifier.
• UPDATEMASK : 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 de votre masque de mise à jour :

• displayName
• description
• primaryContact
• documentation
• icon
• categories[]
• discoveryType
• logLinkedDatasetQueryUserEmail
• bigqueryDataset.replicaLocations

Pour en savoir plus sur ces champs, consultez Ressource : annonce.

Lorsque vous mettez à jour les régions de réplique pour votre fiche, spécifiez toutes les régions applicables. Avant de mettre à jour la fiche, vérifiez que vous avez activé la réplication des ensembles de données multirégionaux sur l'ensemble de données partagé. Vous ne pouvez ajouter que des régions dans lesquelles l'ensemble de données partagé comporte une réplique. Avant de supprimer une région de la fiche, supprimez la réplique de l'ensemble de données partagé dans cette région. Vous pouvez également convertir des fiches spécifiques à une région en fiches multirégionales.

Pour plus d'informations sur les tâches que vous pouvez effectuer sur des listes à l'aide des API, consultez la documentation sur les méthodes projects.locations.dataExchanges.listings.

Console

1. Accédez à la page Partage (Analytics Hub).

   Accéder à "Partage" (Analytics Hub)

2. Cliquez sur le nom de l'échange de données contenant la fiche.

3. Cliquez sur la fiche que vous souhaitez supprimer.

4. Cliquez sur delete Supprimer.

5. Dans la boîte de dialogue Supprimer la fiche ?, confirmez la suppression en saisissant delete.

6. Cliquez sur Supprimer.

API

Appelez la méthode projects.locations.dataExchanges.listings.delete :

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

Remplacez les éléments suivants :

• PROJECT_ID : ID du projet contenant l'échange de données.
• LOCATION : emplacement de l'échange de données.
• DATAEXCHANGE_ID : ID de l'échange de données.
• LISTING_ID : ID de la fiche à supprimer.

Pour plus d'informations sur les tâches que vous pouvez effectuer sur des listes à l'aide des API, consultez la documentation sur les méthodes projects.locations.dataExchanges.listings.