Utiliser des domaines de données

Aperçu

Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres pré-DG" de la section "Conditions d'utilisation générales du service" des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

En tant qu'utilisateur de domaine de données, vous pouvez utiliser des 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

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

• Afficher les métadonnées des entrées de domaine pour la découverte : lecteur d'entrées de domaine de données Dataplex (roles/dataplex.dataDomainEntryReader)
• Afficher les configurations et les liaisons de domaine : lecteur de configuration de domaine de données Dataplex (roles/dataplex.dataDomainViewer)

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 des filtres supplémentaires 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 more_vert. 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.

Remarque : L'emplacement dans le chemin d'accès pour searchEntries peut être global (pour une diffusion complète) ou une région spécifique en fonction de la configuration de votre backend de recherche.

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 :

curl (Linux, macOS ou Cloud Shell)

Remarque : La commande suivante suppose que vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, et exécutez la commande suivante :

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries"

PowerShell (Windows)

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, et exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries" | Select-Object -Expand Content

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

Limites

Lorsque vous recherchez des ressources en dehors du contexte du domaine, par exemple lorsque vous utilisez une recherche globale, les autorisations de détectabilité 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'êtes pas directement autorisé à 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

• En savoir plus sur les domaines de données.
• Découvrez comment créer des domaines de données.
• Découvrez comment gérer les ressources de domaine de données.