Utiliser des domaines de données

En tant qu'utilisateur de domaine de données, vous pouvez utiliser les domaines de données pour affiner les résultats de recherche en fonction de contextes commerciaux spécifiques, rechercher des ensembles de données, des tables et des produits de données BigQuery, et découvrir des métadonnées dans des limites de domaine spécifiques.

Avant de commencer

Avant d'effectuer une recherche par domaine, assurez-vous de disposer des rôles requis et d'avoir activé les API.

Activer les API

Si ce n'est pas déjà fait, activez l'API Dataplex.

Rôles requis pour activer les API

Pour activer les API, vous devez disposer de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

Activer l'API

Rôles requis

Pour obtenir les autorisations nécessaires pour rechercher et découvrir des métadonnées à l'aide de domaines de données, demandez à votre administrateur de vous accorder les rôles IAM suivants sur le projet ou le domaine de données :

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 via des rôles personnalisés ou d'autres rôles prédéfinis.

Parcourir la hiérarchie des domaines

Pour en savoir plus sur la navigation dans la hiérarchie des domaines, consultez Afficher les domaines et sous-domaines de données dans un emplacement.

Rechercher des ressources dans un domaine de données

Pour rechercher des ressources avec un domaine, procédez comme suit :

Console

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

    Accéder à la recherche

  2. Cliquez sur Essayer la recherche naturelle pour activer la fonctionnalité de recherche naturelle.

  3. Cliquez sur Filtres.

  4. Dans le champ Champ d'application, sélectionnez Domaine dans la liste.

  5. Dans le champ Sélectionner un domaine, sélectionnez le domaine pour lequel vous souhaitez affiner les résultats. Ajoutez d'autres filtres si nécessaire.

Vous pouvez également utiliser l'option de menu Rechercher dans le domaine pour trouver des ressources dans le domaine :

  1. Dans la Google Cloud console, accédez à la page Domaines de données.

    Accéder aux domaines de données

  2. Sélectionnez Rechercher dans le domaine dans le menu . Cette action ouvre automatiquement une fenêtre de recherche avec le filtre domaine appliqué.

  3. Utilisez le champ de recherche pour trouver des ressources dans le domaine.

REST

Pour rechercher des entrées limitées à un domaine de données, utilisez la méthode projects.locations.searchEntries et fournissez le chemin d'accès au domaine dans le paramètre contexts.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID de votre Google Cloud projet.
  • LOCATION_ID : région de la requête de recherche (ou global).
  • QUERY : chaîne de requête de recherche.
  • DOMAIN_ID : identifiant unique du domaine de données définissant le contexte du champ d'application de la recherche.

Méthode HTTP et URL : 

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries

Corps JSON de la requête : 

{
  "query": "QUERY",
  "contexts": [ "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" ],
  "semantic_search": true,
  "page_size": 100
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir un code d'état indiquant le succès de l'opération (2xx), ainsi qu'une réponse vide.

Récupérer le contexte des domaines de données

Vous pouvez utiliser la lookupContext méthode pour ancrer les agents d'IA dans le contexte métier capturé par vos domaines de données. La méthode lookupContext est compatible avec les domaines de données de différentes manières :

  • Contexte d'un domaine de données Vous pouvez transmettre l'entrée qui représente un domaine de données dans la liste resources. La réponse contient les métadonnées du domaine de données, telles que sa description et les domaines de données parents dans la hiérarchie des domaines.
  • Appartenance des éléments de données à un domaine de données Lorsque vous récupérez le contexte d'un élément de données inclus dans un ou plusieurs domaines de données, la réponse contient un champ dataDomains qui répertorie les domaines de données auxquels appartient l'élément, en commençant par le domaine le plus spécifique et en remontant jusqu'au domaine de premier niveau.

Pour récupérer le contexte d'un domaine de données, envoyez la requête suivante :

curl --request POST \
  'https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:lookupContext' \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H 'Content-Type: application/json' \
  -d '{
    "resources": [
      "projects/PROJECT_ID/locations/LOCATION/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION/dataDomains/DATA_DOMAIN_ID"
    ],
    "options": {
      "format": "yaml"
    }
  }'

Remplacez les éléments suivants :

  • PROJECT_ID : ID du projet contenant le domaine de données.
  • PROJECT_NUMBER : numéro du projet contenant le domaine de données.
  • LOCATION : emplacement du domaine de données.
  • DATA_DOMAIN_ID : ID du domaine de données.

Pour en savoir plus sur la méthode lookupContext, consultez Récupérer le contexte des éléments de données.

Limites

Lorsque vous recherchez des ressources en dehors du contexte du domaine, par exemple lorsque vous utilisez une recherche globale, les autorisations de découvrabilité du domaine ne s'appliquent pas. Vous ne voyez que les ressources auxquelles vous avez accès dans le système sous-jacent, tel que BigQuery.

Supposons qu'un ensemble de données BigQuery soit inclus dans un domaine de données. Vous disposez du rôle Dataplex Data Domain Entry Reader pour le domaine, mais vous n'avez pas l'autorisation directe d'afficher l'ensemble de données dans BigQuery :

  • Recherche dans le domaine : l'ensemble de données s'affiche dans les résultats de recherche, car les autorisations de domaine s'appliquent.
  • Recherche en dehors du domaine : l'ensemble de données ne s'affiche pas dans les résultats de recherche. Dans une recherche générale, les autorisations de domaine ne s'appliquent pas et vous n'avez pas d'accès direct dans BigQuery.

Étape suivante