Ce document décrit la syntaxe des requêtes de recherche Dataplex. Avant vous lisez ce document, il est important que vous compreniez les concepts Catalogue Dataplex, comme les entrées de données, les aspects, les types d'aspects, les groupes d'entrées et les types d'entrées. Pour en savoir plus, consultez Présentation du catalogue Dataplex
Pour lancer une requête de recherche dans le catalogue Dataplex dans le dans la console Google Cloud, accédez à la page Recherche de Dataplex, puis sélectionnez le mode de recherche Catalogue Dataplex.
Pour en savoir plus, consultez Recherchez des éléments de données dans le catalogue Dataplex.
Recherche simple
Dans sa forme la plus simple, une requête de recherche dans le catalogue Dataplex se compose d'un seul prédicat. Un tel prédicat peut correspondre à plusieurs éléments de métadonnées:
- Sous-chaîne du nom, du nom à afficher ou de la description d'un élément de données
- Sous-chaîne du type d'un élément de données
- Sous-chaîne d'un nom de colonne (ou colonne imbriquée) dans le schéma de données élément
- Sous-chaîne d'un ID de projet
- Chaîne d'une description générale
Par exemple, le prédicat foo
correspond aux entités suivantes :
- Élément de données nommé
foo.bar
- Élément de données portant le nom à afficher
Foo Bar
- Élément de données avec la description
This is the foo script
- Élément de données avec le type exact
foo
- Colonne
foo_bar
dans le schéma d'un élément de données - Colonne imbriquée
foo_bar
dans le schéma d'un élément de données - Projet
prod-foo-bar
- Élément de données avec un aperçu contenant le mot
foo
Prédicats qualifiés
Vous pouvez qualifier un prédicat en le préfixant avec une clé qui limite le correspondant à une métadonnée spécifique:
- Le signe égal (
=
) limite la recherche à une correspondance exacte. - Le signe deux-points (
:
) après la clé met en correspondance le prédicat avec une sous-chaîne ou un dans la valeur affichée dans les résultats de recherche.
La tokenisation divise le flux de texte en une série de jetons, chacun jeton correspondant généralement à un seul mot.
Exemple :
name:foo
sélectionne les entités dont le nom contient la sous-chaînefoo
, commefoo1
etbarfoo
.description:foo
sélectionne les entités dont la description contient le jetonfoo
. commebar
etfoo
.location=foo
met en correspondance les éléments de données d'un emplacement spécifié avecfoo
comme le nom de l'emplacement.
Les clés de prédicat type
, system
, location
et orgid
ne sont compatibles qu'avec la
le qualificatif de correspondance exacte (=
), et non le qualificatif de sous-chaîne (:
). Par exemple :
type=foo
ou orgid=number
.
Le catalogue Dataplex accepte les qualificatifs suivants:
Qualificatif | Description |
---|---|
name:x |
Renvoie x en tant que sous-chaîne de l'ID de l'élément de données. |
displayname:x |
Renvoie x en tant que sous-chaîne du nom d'affichage de l'élément de données. |
column:x |
Correspond à x en tant que sous-chaîne du nom de la colonne (ou en tant que sous-chaîne imbriquée
nom de la colonne) dans le schéma de l'élément de données. |
description:x |
Renvoie x en tant que jeton dans la description de l'élément de données. |
label:bar |
Correspond aux éléments de données BigQuery qui possèdent un libellé (avec des
) et la clé d'étiquette a bar comme sous-chaîne. |
label=bar |
Correspond aux éléments de données BigQuery qui possèdent un libellé (avec
une valeur) et la clé d'étiquette est égale à bar en tant que chaîne. |
label:bar:x |
Correspond à x en tant que sous-chaîne de la valeur d'un libellé avec
clé bar associée à un élément de données BigQuery. |
label=foo:bar |
Correspond aux éléments de données BigQuery dont la clé est égale à
foo et la valeur de clé est bar . |
label.foo=bar |
Correspond aux éléments de données BigQuery dont la clé est égale à
foo et la valeur de clé est bar . |
label.foo |
Correspond aux éléments de données BigQuery qui possèdent un libellé dont
"key" est égal à foo sous forme de chaîne. |
type=TYPE |
Correspond aux éléments de données d'un type d'entrée spécifique ou de son alias de type. |
projectid:bar |
Fait correspondre les éléments de données des projets Google Cloud qui correspondent
bar en tant que sous-chaîne de l'ID. |
parent:x |
Correspond à x en tant que sous-chaîne du chemin hiérarchique d'une
l'élément de données. Le chemin d'accès parent est un fully_qualified_name de
la ressource parente. |
orgid=number |
Associe les éléments de données d'une organisation Google Cloud avec
la valeur d'ID exacte de number . |
system=SYSTEM |
Correspond aux éléments de données d'un système spécifié. |
location=LOCATION |
Fait correspondre les éléments de données dans un emplacement spécifié avec un nom exact.
Par exemple, Les éléments BigQuery Omni acceptent ce qualificatif via le
Nom d'emplacement BigQuery Omni.
Par exemple :
|
createtime |
Recherche les éléments de données créés dans, avant ou après un la date ou l'heure. Exemple :
Format d'horodatage: Tous les codes temporels doivent être exprimés en heure GMT. les fuseaux horaires ne sont pas acceptés. Partiellement
codes temporels, tiret ( Exemple :
|
updatetime |
Affiche les éléments de données qui ont été mis à jour pendant, avant ou après un la date ou l'heure. Exemple :
Format d'horodatage: Tous les codes temporels doivent être exprimés en heure GMT. les fuseaux horaires ne sont pas acceptés. Partiellement
codes temporels, tiret ( Exemple :
|
fully_qualified_name:x |
Correspond à x en tant que sous-chaîne de fully_qualified_name . |
fully_qualified_name=x |
Correspond à x et à fully_qualified_name . |
Recherche Aspect
Pour rechercher des entrées en fonction des aspects qui leur sont associés, utilisez la requête suivante : syntaxe.
Qualificatif | Description |
---|---|
aspect:x |
Correspond à x en tant que sous-chaîne du chemin d'accès complet à l'aspect
Type d'un aspect associé à l'entrée, dans le format
projectid.location.ASPECT_TYPE_ID |
aspect=x |
Correspond à x comme le chemin d'accès complet à l'aspect
Type d'un aspect associé à l'entrée, dans le format
projectid.location.ASPECT_TYPE_ID |
aspect:xOPERATORvalue |
Recherche des valeurs de champ d'aspect. Correspond à La liste des opérateurs compatibles dépend du type de champ dans comme suit:
Seuls les champs de niveau supérieur de l'aspect sont inclus dans l'index de recherche. Par exemple, toutes les requêtes suivantes correspondent aux entrées dont la valeur
du champ
|
Opérateurs logiques
Une requête peut être constituée de plusieurs prédicats avec des opérateurs logiques. Si vous ne
spécifiez un opérateur. La logique AND
est implicite. Par exemple, foo bar
renvoie
entités qui correspondent à la fois au prédicat foo
et au prédicat bar
.
Les opérateurs logiques AND
et OR
logiques sont acceptés. Exemple : foo OR bar
.
Vous pouvez annuler un prédicat avec un préfixe -
(trait d'union) ou NOT
. Par exemple :
-name:foo
renvoie les entités dont le nom ne correspond pas au prédicat foo
.
Les opérateurs logiques ne sont pas sensibles à la casse. Par exemple, or
et OR
sont tous les deux
acceptable.
Syntaxe abrégée
Une syntaxe de recherche abrégée est également disponible, en utilisant |
(barre verticale) pour
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 OR
vous pouvez utiliser la syntaxe abrégée suivante:
projectid:(id1|id2|id3|id4)
La même recherche sans l'utilisation de 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 le code suivant:
- ET:
column:(name1, name2, name3)
- OU:
column:(name1|name2|name3)
Cette syntaxe abrégée
fonctionne pour le
prédicats qualifiés, à l'exception de label
.
Étape suivante
- Découvrez comment rechercher des éléments de données. dans le catalogue Dataplex
- En savoir plus sur le catalogue Dataplex
- Découvrez comment enrichir les entrées avec des métadonnées à l'aide d'aspects.
- Découvrez comment gérer les entrées et ingérer des sources personnalisées.