Utiliser les produits de données

Ce document s'adresse aux consommateurs de produits de données Knowledge Catalog (anciennement Dataplex Universal Catalog) qui souhaitent découvrir et utiliser des produits de données pour leurs cas d'utilisation.

Pour en savoir plus sur l'architecture et les concepts clés des produits de données, consultez À propos des produits de données.

Avant de commencer

  1. Activez les API Dataplex et BigQuery.

    Rôles requis pour activer les API

    Pour activer les API, vous avez besoin du rôle IAM Administrateur Service Usage (roles/serviceusage.serviceUsageAdmin), qui contient l'autorisation serviceusage.services.enable. Découvrez comment attribuer des rôles.

    Activer les API

Rôles requis

Pour obtenir les autorisations nécessaires pour rechercher, accéder à et utiliser des produits de données, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le produit de données ou le projet :

Pour en savoir plus sur l'attribution de rôles, consultez 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.

En tant qu'utilisateur de produits de données, vous devez disposer de l'autorisation viewer pour accéder à l'élément correspondant dans le système source afin d'afficher les métadonnées d'un élément. Par exemple, pour rechercher les métadonnées d'un ensemble de données ou d'une table dans un produit de données, vous devez disposer du rôle Lecteur de métadonnées BigQuery (roles/bigquery.metadataViewer). Pour en savoir plus, consultez Rôles requis pour accéder aux résultats de recherche.

Console

  1. Dans la console Google Cloud , accédez à la page Rechercher de Knowledge Catalog.

    Accéder à la recherche

  2. Effectuez une recherche à l'aide de mots clés ou du langage naturel. Pour en savoir plus, consultez Rechercher des ressources.

  3. Dans les résultats de recherche, cliquez sur le produit de données dont vous souhaitez afficher les détails. Vous pouvez consulter la description, les composants, le contrat, les aspects et d'autres documents associés au produit de données.

REST

Pour rechercher un produit de données, utilisez la méthode searchEntries.

Par exemple, envoyez la requête POST suivante :

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d \
  '{
  "query": "ADDITIONAL_KEYWORDS (type=(DATA_PRODUCT))",
  "pageSize": 10
  }' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/global:searchEntries"

Remplacez les éléments suivants :

  • ADDITIONAL_KEYWORDS (facultatif) : mots clés ou critères de recherche supplémentaires permettant d'affiner les résultats (par exemple, displayName:'My Data Product' ou description:'sales')
  • PROJECT_ID : ID de votre projet Google Clouddans lequel le produit de données est créé.

Demander l'accès aux produits de données

En tant que consommateur de produits de données, si vous n'avez pas accès à un produit de données, vous pouvez demander l'accès en procédant comme suit :

  1. Dans la console Google Cloud , accédez à la page Produits de données du catalogue de connaissances.

    Accéder à "Produits de données"

  2. Cliquez sur le produit de données auquel vous souhaitez accéder.

  3. Cliquez sur Demande d'accès.

  4. Dans le volet Request details (Détails de la demande), spécifiez les éléments suivants :

    • Type d'accès : sélectionnez l'accès que vous recherchez.
    • Message : indiquez une justification pour la demande d'accès.

  5. Cliquez sur Envoyer. Un brouillon d'e-mail s'ouvre automatiquement dans votre application de messagerie par défaut (comme Gmail ou Outlook) avec l'adresse du destinataire, ainsi qu'un objet et un corps de message préremplis.

  6. Examinez le contenu de l'e-mail généré automatiquement, qui contient les détails de votre demande.

    Pour envoyer la demande d'accès au propriétaire du produit de données pour approbation, cliquez sur Envoyer.

    Le propriétaire du produit de données reçoit votre e-mail et examine votre demande. Attendez de recevoir une notification par e-mail confirmant que votre demande d'accès a été approuvée ou refusée.

    Une fois votre demande approuvée, vous aurez accès au produit de données et pourrez commencer à l'utiliser dans le catalogue de connaissances.

Utiliser des produits de données

Pour utiliser un produit de données, assurez-vous de disposer des autorisations nécessaires. Consultez Demander l'accès aux produits de données.

Une fois que le propriétaire du produit de données vous a accordé l'autorisation, vous pouvez accéder au produit de données et à ses composants. Par exemple, si vous disposez des autorisations nécessaires pour accéder à une table BigQuery, vous pouvez l'interroger directement dans BigQuery pour générer des insights.

Pour accéder à un produit de données et l'utiliser, procédez comme suit :

  1. Recherchez le produit de données.
  2. Dans les résultats de recherche, cliquez sur le produit de données que vous souhaitez utiliser.
  3. Cliquez sur l'onglet Composants.
  4. Cliquez sur le composant dont vous souhaitez afficher les détails. La page des détails de l'entrée s'ouvre. Vous pouvez accéder à des informations telles que le schéma, les insights et la traçabilité. Si le composant est une table ou une vue BigQuery, vous pouvez cliquer sur Ouvrir dans BigQuery pour accéder à BigQuery Studio et interroger les résultats.

Étapes suivantes