Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Syntaxe de recherche pour Knowledge Catalog

Ce document décrit la syntaxe de la recherche dans Knowledge Catalog.

Knowledge Catalog vous permet de découvrir, de cataloguer de manière centralisée, de gérer et de comprendre les données de votre organisation. Pour trouver efficacement des éléments de données spécifiques dans votre catalogue de données, vous pouvez utiliser des requêtes de recherche puissantes. La syntaxe des requêtes de recherche inclut les éléments suivants :

Recherche simple : comment trouver des éléments de données à l'aide d'un seul terme de recherche.
Prédicats qualifiés : comment affiner votre recherche à l'aide de champs de métadonnées spécifiques tels que le nom, l'emplacement ou la description.
Recherche d'aspects : comment rechercher des entrées en fonction de leurs métadonnées métier et techniques associées.
Opérateurs logiques : comment combiner plusieurs critères de recherche à l'aide des opérateurs AND et OR pour créer des requêtes complexes. En comprenant cette syntaxe, vous pouvez rapidement localiser les données dont vous avez besoin.

Avant de commencer

Comprenez les groupes d'entrées, les entrées, les liens d'entrée, les aspects, les types d'entrées, les types de liens d'entrée et les types d'aspects de Knowledge Catalog. Consultez À propos de la gestion des métadonnées dans Knowledge Catalog.

Knowledge Catalog propose une recherche qui exploite l'IA pour comprendre les requêtes en langage naturel et leur signification sémantique. Elle vous permet de trouver des ressources en utilisant un langage courant, sans avoir besoin d'une syntaxe complexe, tout en prenant en charge la correspondance de mots clés et les filtres.

Utiliser la recherche en texte libre

Vous pouvez trouver des éléments en saisissant un terme ou une expression sans syntaxe spécifique. Knowledge Catalog effectue une recherche étendue en comparant votre requête à plusieurs champs de métadonnées, y compris les suivants :

Nom, nom à afficher ou description d'une ressource
Type de ressource
ID du projet
Description de la vue d'ensemble
Nom de colonne (ou nom de colonne imbriquée) dans le schéma d'une ressource
Description de la colonne
Nom complet
Contacts
Aspects

Utiliser la syntaxe des requêtes

Pour des recherches plus précises, vous pouvez créer une requête à l'aide d'une syntaxe spécifique, y compris des qualificatifs, des opérateurs logiques et des recherches d'aspects.

Prédicats qualifiés

Vous pouvez qualifier un prédicat en le préfixant avec une clé qui limite la correspondance à une métadonnée spécifique :

Le signe égal (=) limite la recherche à une correspondance exacte.
Le signe deux-points (:) après la clé correspond au prédicat d'une sous-chaîne ou d'un jeton compris dans la valeur des résultats de recherche.

La tokenisation divise le flux de texte en une série de jetons, chaque jeton correspondant généralement à un seul mot.

Exemple :

name:foo sélectionne les ressources dont le nom contient la sous-chaîne foo, comme foo1 et barfoo.
description:foo sélectionne les ressources dont la description contient le jeton foo, comme bar et foo.
location=foo correspond aux ressources d'un emplacement spécifié dont le nom est foo.

Le comportement de ces qualificatifs peut varier légèrement selon les modes de recherche, comme indiqué dans les sections suivantes.

Les clés de prédicat type, system, location et description, ainsi que la recherche d'aspects (à l'exclusion de has) n'acceptent que le qualificatif de correspondance exacte (=), et non le qualificatif de sous-chaîne (:). Par exemple, type=foo.

La recherche dans Knowledge Catalog accepte les qualificatifs suivants :

Qualificatif	Description
`name:x`	Correspond à `x` en tant que sous-chaîne de l'ID de ressource ou du nom à afficher de la ressource.
`displayname:x`	Correspond à `x` en tant que sous-chaîne du nom à afficher de la ressource.
`column:x`	Correspond à `x` en tant que sous-chaîne du nom de colonne (ou du nom de colonne imbriquée ) dans le schéma de la ressource.
`description:x`	Correspond à `x` en tant que jeton dans la description de la ressource.
`labels:bar`	Correspond aux ressources BigQuery comportant une étiquette (avec une certaine valeur) et dont la clé d'étiquette est `bar` en tant que sous-chaîne.
`labels=bar`	Correspond aux ressources BigQuery comportant une étiquette (avec une certaine valeur) et dont la clé d'étiquette est égale à `bar` en tant que chaîne.
`labels.bar:x`	Correspond à `x` en tant que sous-chaîne dans la valeur d'une étiquette dont la clé `bar` est associée à une ressource BigQuery.
`labels.foo=bar`	Correspond aux ressources BigQuery où la clé est égale `foo` et la valeur de la clé est égale `bar`.
`type=TYPE`	Correspond aux ressources d'un type d'entrée spécifique ou à son alias de type.
`projectid:bar`	Correspond aux ressources des Google Cloud projets qui correspondent `bar` en tant que sous-chaîne dans l'ID.
`parent:x`	Correspond à `x` en tant que sous-chaîne du chemin d'accès hiérarchique d'une ressource.
`system=SYSTEM`	Correspond aux ressources d'un système spécifié.
`location=LOCATION`	Correspond aux ressources d'un emplacement spécifié avec un nom exact. Par exemple, `location=us-central1` correspond aux éléments hébergés dans l'Iowa. Les éléments BigQuery Omni sont compatibles avec ce qualificatif en utilisant le nom de l'emplacement BigQuery Omni. Par exemple, `location=aws-us-east-1` correspond aux éléments BigQuery Omni en Virginie du Nord.
`createtime`	Recherche les ressources qui ont été créées pendant, avant ou après une date ou une heure donnée. Exemple : `createtime:2019-01-01` correspond à toutes les ressources créées le 1er janvier 2019. `createtime<2019-02` correspond à toutes les ressources créées avant le 1er février 2019 à 00:00:00. `createtime>2019-02` correspond à toutes les ressources créées après le 1er février 2019 à 00:00:00. `createtime>-30d` correspond à toutes les ressources créées au cours des 30 derniers jours. `createtime<=-30d` correspond à toutes les ressources créées il y a 30 jours ou plus. `createtime<=-1d` correspond à toutes les ressources créées la veille. Format d'horodatage : `YYYY-MM-DDThh:mm:ss` Tous les horodatages doivent être à l'heure GMT. Les fuseaux horaires ne sont pas acceptés. Les horodatages partiels et les séparateurs de dates tiret (`-`) et barre oblique (`/`) sont acceptés. Exemple : `2010-10-22T05:36:24` `2010-10-22T05:36` `2010-10-22T05` `2010-10-22` `2010-10` `2010` `2010/10/22`
`updatetime`	Recherche les ressources qui ont été mises à jour pendant, avant ou après une date ou une heure donnée. Exemple : `updatetime:2019-01-01` correspond à toutes les ressources mises à jour le 1er janvier 2019. `updatetime<2019-02` correspond à toutes les ressources mises à jour avant le 1er février 2019 à 00:00:00. `updatetime>2019-02` correspond à toutes les ressources mises à jour après le 1er février 2019 à 00:00:00. `updatetime>-30d` correspond à toutes les ressources mises à jour au cours des 30 derniers jours. `updatetime<-30d` correspond à toutes les ressources mises à jour il y a 30 jours ou plus. `updatetime=-1d` correspond à toutes les ressources mises à jour la veille. `updatetime>=-30d` correspond à toutes les ressources mises à jour au cours des 30 derniers jours. `updatetime<=-30d` correspond à toutes les ressources mises à jour il y a 30 jours ou plus. Format d'horodatage : `YYYY-MM-DDThh:mm:ss` Tous les horodatages doivent être à l'heure GMT. Les fuseaux horaires ne sont pas acceptés. Les horodatages partiels et les séparateurs de dates tiret (`-`) et barre oblique (`/`) sont acceptés. Exemple : `2010-10-22T05:36:24` `2010-10-22T05:36` `2010-10-22T05` `2010-10-22` `2010-10` `2010` `2010/10/22`

Recherche d'aspects

Vous pouvez utiliser la syntaxe des requêtes pour rechercher des entrées en fonction de leurs aspects associés.

La correspondance de sous-chaîne tente de correspondre à un nombre limité d'aspects. Si vous ne trouvez pas l'entrée à l'aide d'un fragment du chemin d'accès, utilisez le chemin d'accès complet pour affiner la recherche et augmenter le rappel.

Qualificatif Description

aspect:x
ou
has:x Correspond à x en tant que sous-chaîne du chemin d'accès complet au type d'aspect d'un aspect associé à l'entrée, au format projectid.location.ASPECT_TYPE_ID

aspect=x
ou
has=x Correspond à x en tant que chemin d'accès complet au type d'aspect d'un aspect associé à l'entrée, au format projectid.location.ASPECT_TYPE_ID

Qualificatif	Description
`aspect:x` ou `has:x`	Correspond à `x` en tant que sous-chaîne du chemin d'accès complet au type d'aspect d'un aspect associé à l'entrée, au format `projectid.location.ASPECT_TYPE_ID`
`aspect=x` ou `has=x`	Correspond à `x` en tant que chemin d'accès complet au type d'aspect d'un aspect associé à l'entrée, au format `projectid.location.ASPECT_TYPE_ID`
`x OPERATOR value`	Recherche les valeurs de champ d'aspect. Correspond à `x` en tant que sous-chaîne du chemin d'accès complet au type d'aspect et au nom de champ d'un aspect associé à l'entrée, dans les formats suivants : Syntaxe pour les types d'aspect système : `ASPECT_TYPE_ID.FIELD_NAME` `dataplex-types.ASPECT_TYPE_ID.FIELD_NAME` `dataplex-types.LOCATION.ASPECT_TYPE_ID.FIELD_NAME` Par exemple, les requêtes suivantes correspondent aux entrées où la valeur du champ `type` dans l'aspect `bigquery-dataset` est `default` : `bigquery-dataset.type=default` `dataplex-types.bigquery-dataset.type=default` `dataplex-types.global.bigquery-dataset.type=default` Syntaxe pour les types d'aspect personnalisés : Si l'aspect est créé dans la région globale : `PROJECT_ID.ASPECT_TYPE_ID.FIELD_NAME` Si l'aspect est créé dans une région spécifique : `PROJECT_ID.REGION.ASPECT_TYPE_ID.FIELD_NAME` Par exemple, les requêtes suivantes correspondent aux entrées où la valeur du champ `is-enrolled` dans l'`employee-info` aspect est `true`. `example-project.us-central1.employee-info.is-enrolled=true` `example-project.employee-info.is-enrolled=true` La liste des opérateurs compatibles dépend du type de champ dans l' aspect, comme suit : Chaîne : `=` (correspondance exacte) Tous les types de nombres : `=`, `:`, `<`, `>`, `<=`, `>=`, `=>`, `=<` Énumération : `=` Date/heure : identique à celle des nombres, mais les valeurs à comparer sont traitées comme des dates/heures au lieu de nombres Booléen : `=` Seuls les champs de niveau supérieur de l'aspect peuvent faire l'objet d'une recherche.

x
OPERATOR
value

Recherche les valeurs de champ d'aspect. Correspond à x en tant que sous-chaîne du chemin d'accès complet au type d'aspect et au nom de champ d'un aspect associé à l'entrée, dans les formats suivants :

Syntaxe pour les types d'aspect système :
- ASPECT_TYPE_ID.FIELD_NAME
- dataplex-types.ASPECT_TYPE_ID.FIELD_NAME
- dataplex-types.LOCATION.ASPECT_TYPE_ID.FIELD_NAME
Par exemple, les requêtes suivantes correspondent aux entrées où la valeur du champ type dans l'aspect bigquery-dataset est default :
- bigquery-dataset.type=default
- dataplex-types.bigquery-dataset.type=default
- dataplex-types.global.bigquery-dataset.type=default
Syntaxe pour les types d'aspect personnalisés :
- Si l'aspect est créé dans la région globale : PROJECT_ID.ASPECT_TYPE_ID.FIELD_NAME
- Si l'aspect est créé dans une région spécifique : PROJECT_ID.REGION.ASPECT_TYPE_ID.FIELD_NAME
Par exemple, les requêtes suivantes correspondent aux entrées où la valeur du champ is-enrolled dans l'employee-info aspect est true.
- example-project.us-central1.employee-info.is-enrolled=true
- example-project.employee-info.is-enrolled=true
La liste des opérateurs compatibles dépend du type de champ dans l' aspect, comme suit :
- Chaîne : = (correspondance exacte)
- Tous les types de nombres : =, :, <, >, <=, >=, =>, =<
- Énumération : =
- Date/heure : identique à celle des nombres, mais les valeurs à comparer sont traitées comme des dates/heures au lieu de nombres
- Booléen : =

Seuls les champs de niveau supérieur de l'aspect peuvent faire l'objet d'une recherche.

Opérateurs logiques

Une requête peut être composée de plusieurs prédicats contenant des opérateurs logiques.

Si vous ne spécifiez pas d'opérateur, l'opérateur logique AND est implicite. Par exemple, foo bar renvoie les ressources qui correspondent à la fois au prédicat foo et au prédicat bar.
Les opérateurs logiques AND et OR sont acceptés. Par exemple, foo OR bar.
Vous pouvez annuler un prédicat avec les préfixes - (tiret) ou NOT. Par exemple, -name:foo renvoie les ressources dont le nom ne correspond pas au prédicat foo.

Syntaxe abrégée

Une syntaxe de recherche abrégée est également disponible, en utilisant | (barre verticale) pour les opérateurs OR et , (virgule) pour les opérateurs AND.

Par exemple, pour rechercher des entrées dans l'un des nombreux projets à l'aide de l'opérateur OR, vous pouvez utiliser la syntaxe abrégée suivante :

projectid:(id1|id2|id3|id4)

La même recherche sans utiliser la syntaxe abrégée se présente comme suit :

projectid:id1 OR projectid:id2 OR projectid:id3 OR projectid:id4

Pour rechercher des entrées avec des noms de colonne correspondants, utilisez les éléments suivants :

AND: column:(name1,name2,name3)
OR: column:(name1|name2|name3)

Cette syntaxe abrégée fonctionne pour les prédicats qualifiés, à l'exception de label dans la recherche par mots clés.

Recherche par mots clés uniquement

Knowledge Catalog fournit un mode de recherche par mots clés uniquement pour assurer la rétrocompatibilité, le mode de recherche standard étant compatible avec la correspondance sémantique et la correspondance de mots clés. Nous vous recommandons d'utiliser le mode de recherche standard, sauf si la recherche par mots clés uniquement est requise pour la rétrocompatibilité.

Le tableau suivant récapitule les principales différences entre les qualificatifs à prendre en compte lorsque vous utilisez la recherche par mots clés uniquement.

Qualificatif	Différences majeures
`name:x`	Correspond à `x` en tant que sous-chaîne de l'ID de ressource uniquement.
Qualificatifs `label`	Utilise le `label` préfixe au lieu de `labels`. Les formats de syntaxe compatibles incluent les suivants : `label:bar` `label=bar` `label:bar:x` `label=foo:bar` `label.foo=bar` `label.foo`
`orgid=number`	Correspond aux ressources d'une Google Cloud organisation avec la valeur d'ID exacte `number`, compatible uniquement dans la recherche par mots clés uniquement.
`fully_qualified_name`	Est compatible avec `fully_qualified_name:x` (correspondance de sous-chaîne) et `fully_qualified_name=x` (correspondance exacte) (compatible uniquement dans la recherche par mots clés uniquement).
`createtime` et `updatetime`	N'accepte que la date exacte (`:`) et les opérateurs de comparaison de base (`<`, `>`). N'accepte pas les filtres de temps relatifs (tels que `-30d` ou `-1d`) ni les opérateurs de comparaison tels que `<=`, `>=`, `=`, `=>`, `=<`.
Restriction de correspondance exacte	Les clés de prédicat `type`, `system`, `location`, et `orgid` n'acceptent que la correspondance exacte (`=`), et non la correspondance de sous-chaîne (`:`).

Recherche d'aspects pour la recherche par mots clés uniquement

Le tableau suivant récapitule les principales différences entre les recherches d'aspects à prendre en compte lorsque vous utilisez la recherche par mots clés uniquement.

Élément de recherche d'aspects	Différences majeures
Préfixe de qualificatif	Accepte `aspect:` et `aspect=`. N'accepte pas ``has:`` ni ``has=``.
Syntaxe de recherche de valeurs de champ d'aspect	Nécessite le `aspect:` préfixe lors de la recherche de valeurs de champ d'aspect (format : `aspect:x OPERATOR value`, par exemple `aspect:employee-info.is-enrolled=true` ou `aspect:employee=true`).
Opérateurs de champ de chaîne	Les champs de chaîne acceptent à la fois la correspondance exacte (`=`) et la correspondance de sous-chaîne (`:`).
Raccourcis de type d'aspect système	N'accepte pas les raccourcis de type d'aspect système, tels que `ASPECT_TYPE_ID.FIELD_NAME` ou `dataplex-types...`).

Étape suivante

Découvrez comment rechercher des ressources dans Knowledge Catalog.
En savoir plus sur la gestion des métadonnées dans Knowledge Catalog.
Découvrez comment enrichir des entrées et des liens d'entrée avec des métadonnées à l'aide des aspects.
Apprenez à gérer les entrées et ingérer des sources personnalisées.