Rechercher des ressources

Utilisez la recherche Dataplex Universal Catalog pour trouver des ressources Trusted Cloud dans BigQuery, comme des ensembles de données et des tables BigQuery.

La recherche Dataplex Universal Catalog est compatible avec les requêtes de recherche en langage naturel (également appelées requêtes de recherche sémantique), qui vous permettent de rechercher des ressources en utilisant le langage courant.

Comme la recherche par mots clés, la recherche en langage naturel met l'accent sur la découverte de ressources en analysant les métadonnées associées aux ressources de votre organisation. La recherche prend en compte un large éventail de métadonnées décrivant les ressources, y compris celles que vous créez.

La recherche en langage naturel vise à améliorer le rappel plutôt que la précision.

Pour savoir comment rechercher des données de table dans BigQuery, consultez Présentation de la recherche dans BigQuery.

S'inscrire pour obtenir la version bêta

Pour vous inscrire à la version Preview, votre responsable de compte Google doit envoyer une demande en remplissant le formulaire d'inscription. Une fois le formulaire envoyé, l'équipe BigQuery vous contactera pour vous indiquer la marche à suivre.

Avant de commencer

Avant d'utiliser la recherche en langage naturel dans BigQuery pour rechercher des ressourcesTrusted Cloud , effectuez les tâches de cette section.

Rôles requis

Pour rechercher des ressources, vous devez disposer d'au moins l'un des rôles IAM de Dataplex Universal Catalog suivants au niveau du projet utilisé pour la recherche : administrateur de catalogue Dataplex, éditeur de catalogue Dataplex ou lecteur de catalogue Dataplex. Les autorisations applicables aux résultats de recherche sont vérifiées indépendamment du projet sélectionné.

Les résultats de recherche dans BigQuery sont limités en fonction de vos autorisations IAM sur les ressources sous-jacentes. Pour rechercher une ressource dans BigQuery, vous devez disposer des autorisations nécessaires pour y accéder. Pour en savoir plus, consultez la section Portée de la recherche de ce document.

Par exemple, pour rechercher des ensembles de données, des tables, des vues et des modèles BigQuery, vous devez disposer des autorisations correspondantes pour accéder à ces ressources. Pour en savoir plus, consultez Autorisations BigQuery. La liste suivante reprend les autorisations minimales requises :

  • Pour rechercher une table, vous devez disposer de l'autorisation bigquery.tables.get pour cette table.
  • Pour rechercher un ensemble de données, vous devez disposer de l'autorisation bigquery.datasets.get pour cet ensemble de données.

Le rôle Lecteur de métadonnées BigQuery (roles/bigquery.metadataViewer) inclut les autorisations bigquery.tables.get et bigquery.datasets.get, et vous permet de rechercher n'importe quelle ressource BigQuery.

Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Activer l'API

Pour utiliser la recherche, assurez-vous d'avoir activé l'API Dataplex. L'API Dataplex est activée par défaut pour tous les nouveaux projets Trusted Cloud avec BigQuery. Si l'API Dataplex n'est pas activée dans votre projet, consultez Activer Dataplex Universal Catalog.

  1. Dans la console Trusted Cloud , accédez à la page Recherche BigQuery.

    Accéder à la recherche

  2. Dans le champ de recherche, saisissez votre requête en langage naturel, puis appuyez sur Entrée. Voici quelques exemples de requêtes :

    • Show me the datasets that contain taxi information
    • Find data on vaccine distribution across different countries
    • Get tables with historical temperature data for major world cities
    • Search for hurricane tracking and storm activity datasets
    • Population data by country
  3. Pour filtrer votre recherche, cliquez sur Filtres. Les filtres suivants sont disponibles :

    • Champ d'application : effectuez une recherche dans l'ensemble de l'organisation (par défaut), dans le projet actuel ou uniquement pour les ressources suivies. Pour en savoir plus, consultez la section Portée de la recherche de ce document.
    • Systèmes : service Trusted Cloud auquel appartient la ressource, comme BigQuery. Le système Dataplex Universal Catalog contient des groupes d'entrées.
    • Projets : projets dans lesquels effectuer la recherche.
    • Type : type de ressource, comme une connexion BigQuery, un bucket Cloud Storage ou une base de données. Selon le type de ressource, vous pouvez également filtrer par sous-type, comme le type de connexion ou le dialecte SQL.
    • Sélectionner des zones géographiques : les zones géographiques dans lesquelles effectuer la recherche.
    • Sélectionner des ensembles de données : cette option limite les résultats de recherche aux ressources BigQuery appartenant aux ensembles de données BigQuery sélectionnés. Dans le champ Saisissez le nom pour filtrer, saisissez le nom de l'ensemble de données.
    • Annotations : types d'aspects Dataplex Universal Catalog associés à la ressource que vous recherchez. Pour filtrer par valeurs d'aspect, cliquez sur Filtrer sur les valeurs d'annotation, puis sélectionnez les valeurs.

    Pour supprimer un filtre, cliquez sur Effacer à côté du filtre spécifique que vous souhaitez supprimer. Pour supprimer tous les filtres, cliquez sur Effacer les filtres.

    Pour en savoir plus sur l'évaluation des filtres, consultez la section Filtres de ce document.

  4. Facultatif : Pour afficher plus d'informations sur une ressource, cliquez sur son nom dans les résultats de recherche.

    Un récapitulatif des ressources s'ouvre dans un volet fractionné. Effectuez l'une des actions suivantes :

    • Pour ouvrir la ressource dans le service auquel elle appartient, cliquez sur Ouvrir dans PRODUCT_NAME pour la ressource. Par exemple, pour ouvrir un ensemble de données BigQuery dans BigQuery Studio, cliquez sur Ouvrir dans Studio. Les options disponibles dépendent de la ressource.
    • Pour afficher les métadonnées Dataplex Universal Catalog associées à une ressource, cliquez sur Ouvrir dans le catalogue Dataplex pour la ressource.
    • Si vous avez des résultats de recherche importants que vous souhaitez ajouter à vos favoris, vous pouvez les marquer d'une étoile. Cliquez sur  Ajouter aux favoris pour la ressource. Vous pouvez afficher les ressources suivies dans BigQuery Studio.
    • Pour fermer le récapitulatif des ressources dans le volet fractionné, cliquez sur Fermer.

Filtres

Les filtres vous permettent d'affiner les résultats de recherche.

Lorsque vous fournissez des filtres dans plusieurs sections, ils sont pris en compte selon l'opérateur logique AND. Les résultats de recherche contiennent les ressources qui correspondent à au moins une condition de chaque section sélectionnée. Par exemple, si vous sélectionnez le système BigQuery et le type de ressource dataset, les résultats de recherche incluent les ensembles de données BigQuery, mais pas les ensembles de données Vertex AI.

Si vous sélectionnez plusieurs filtres dans une même section, ils sont pris en compte selon l'opérateur logique OR. Par exemple, si vous sélectionnez le type de ressource dataset et le type de ressource table, les résultats de recherche incluent à la fois des ensembles de données et des tables.

Portée de la recherche

Pour les projets appartenant à une organisation Trusted Cloud , la recherche s'effectue dans le champ d'application de cette organisation.

Les résultats de recherche respectent les autorisations dont vous disposez sur les ressources. Par exemple, si vous disposez d'un accès en lecture aux métadonnées BigQuery pour une ressource, cette ressource s'affiche dans vos résultats de recherche. Si vous avez accès à une table BigQuery, mais pas à l'ensemble de données contenant cette table, celle-ci apparaîtra quand même bien dans les résultats de recherche.

Les résultats de recherche n'incluent que les ressources appartenant au même périmètre VPC Service Controls que le projet dans lequel la recherche est effectuée. Lorsque vous utilisez la console Trusted Cloud , il s'agit du projet qui est sélectionné dans la console.

Étapes suivantes