本文档介绍了 Dataplex 搜索查询的语法。在阅读本文档之前，请务必了解 Dataplex Catalog 的概念，例如条目、切面、切面类型、条目组和条目类型。如需了解详情，请参阅 Dataplex Catalog 概览。
如需在 Google Cloud 控制台中启动 Dataplex Catalog 搜索查询，请前往 Dataplex 搜索页面，然后选择 Dataplex Catalog 作为搜索模式。
如需了解详情，请参阅在 Dataplex Catalog 中搜索资源。
轻松搜索
形式最简单的 Dataplex Catalog 搜索查询由单个谓词组成。这些谓词可以匹配多个元数据：
- 资源的名称、显示名称或说明的子字符串
- 资源类型的子字符串
- 资源架构中的列名称（或嵌套列名称）的子字符串
- 项目 ID 的子字符串
- 概览说明中的字符串
例如，谓词 foo 与以下实体匹配：
- 名为
foo.bar的资源 - 显示名称为
Foo Bar的资源 - 使用
This is the foo script说明的资源 - 使用确切类型
foo的资源 - 资源架构中的
foo_bar列 - 资源架构中的嵌套列
foo_bar - 项目
prod-foo-bar - 资源的概述包含字词
foo
限定谓词
您可以通过在谓词前面添加一个键来限定谓词，该键将匹配限制为特定的一部分元数据：
- 等号 (
=) 将搜索限制为完全匹配。 - 键后面的冒号 (
:) 将谓词与搜索结果中的值中的子字符串或词法单元匹配。
词法单元化会将文本流拆分为一系列词法单元，每个词法单元通常对应一个字词。
例如：
name:foo选择名称中包含foo子字符串的实体，例如foo1和barfoo。description:foo选择说明中包含foo词法单元的实体，例如bar和foo。location=foo匹配指定位置中具有foo作为位置名称的资源。
谓词键 type、system、location 和 orgid 仅支持完全匹配 (=) 限定符，而不支持子字符串限定符 (:)。例如，type=foo 或 orgid=number。
Dataplex Catalog 支持以下限定符：
| 限定符 | 说明 |
|---|---|
name:x |
将 x 作为子字符串与资源 ID 匹配。 |
displayname:x |
将 x 作为子字符串与资源显示名称匹配。 |
column:x |
将 x 作为子字符串与资源架构中的列名称（或嵌套列名称）匹配。 |
description:x |
将 x 作为令牌与资源说明匹配。 |
label:bar |
匹配具有标签（带有某个值）且标签键中含有 bar 这个子字符串的 BigQuery 资源。 |
label=bar |
匹配具有标签（具有某个值）且标签键等于字符串 bar 的 BigQuery 资源。 |
label:bar:x |
将 x 作为子字符串与附加到 BigQuery 资源的键为 bar 的标签值匹配。 |
label=foo:bar |
匹配键为 foo 且键值为 bar 的 BigQuery 资源。 |
label.foo=bar |
匹配键为 foo 且键值为 bar 的 BigQuery 资源。 |
label.foo |
以字符串形式匹配具有键为 foo 的标签的 BigQuery 资源。 |
type=TYPE |
匹配特定条目类型或其类型别名的资源。 |
projectid:bar |
匹配 Google Cloud 项目中资源，这些项目的 ID 中有 bar 这一子字符串。 |
parent:x |
将 x 作为资源分层路径的子字符串匹配。父路径是父资源的 fully_qualified_name。 |
orgid=number |
匹配确切 ID 值为 number 的 Google Cloud 组织内资源。 |
system=SYSTEM |
匹配来自指定系统的资源。 |
location=LOCATION |
匹配指定位置中具有确切名称的资源。
例如， BigQuery Omni 素材资源通过使用 BigQuery Omni 位置名称来支持此限定符。
例如， |
createtime |
查找在指定日期或时间之内、之前或之后创建的资源。 例如：
时间戳格式： 所有时间戳必须采用 GMT；不支持时区。支持部分时间戳、英文短划线 ( 例如：
|
updatetime |
查找在指定日期或时间之内、之前或之后更新的资源。 例如：
时间戳格式： 所有时间戳必须采用 GMT；不支持时区。支持部分时间戳、英文短划线 ( 例如：
|
fully_qualified_name:x |
将 x 作为子字符串与 fully_qualified_name 匹配。 |
fully_qualified_name=x |
将 x 匹配为 fully_qualified_name。 |
切面搜索
如需根据附加的方面搜索条目，请使用以下查询语法。
| 限定符 | 说明 |
|---|---|
aspect:x |
将 x 作为附加到条目的方面类型的完整路径的子字符串进行匹配，格式为 projectid.location.ASPECT_TYPE_ID |
aspect=x |
将 x 匹配为指向附加到条目的方面类型的完整路径，格式为 projectid.location.ASPECT_TYPE_ID |
aspect:xOPERATORvalue |
搜索“aspect”字段值。将 支持的运算符列表取决于相应方面中的字段类型，如下所示：
只有相应方面中的顶级字段可供搜索。 例如，以下所有查询都与
|
逻辑运算符
查询可以由若干谓词和逻辑运算符组成。如果您未指定运算符，则意味着使用隐含的逻辑 AND。例如，foo bar 返回同时匹配谓词 foo 和谓词 bar 的实体。
支持逻辑 AND 和逻辑 OR。例如 foo OR bar。
您可以使用 -（短划线）或 NOT 前缀来排除谓词。例如，-name:foo 返回名称与谓词 foo 不匹配的实体。
逻辑运算符不区分大小写。例如，or 和 OR 均为可接受的值。
缩写语法
您还可以使用缩写搜索语法，用 |（竖线）代替 OR 运算符，用 ,（英文逗号）代替 AND 运算符。
例如，要使用 OR 运算符搜索众多项目中的某一个项目中的条目，您可以使用以下缩写语法：
projectid:(id1|id2|id3|id4)
不使用缩写语法进行相同搜索时，搜索内容如下所示：
projectid:id1 OR projectid:id2 OR projectid:id3 OR projectid:id4
如需搜索具有匹配列名称的条目，请使用以下命令：
- AND：
column:(name1, name2, name3) - 或：
column:(name1|name2|name3)
此缩写语法适用于限定谓词，但 label 除外。
后续步骤
- 了解如何在 Dataplex Catalog 中搜索资源
- 详细了解 Dataplex Catalog。
- 了解如何使用方面为条目添加元数据。
- 了解如何管理条目和提取自定义来源。