本文档介绍了 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 |
匹配带有标签的 BigQuery 数据资源（
某个值），标签键等于字符串形式的 bar。 |
label:bar:x |
将标签值中的 x 作为子字符串与
键 bar 已附加到 BigQuery 数据资产。 |
label=foo:bar |
匹配键等于的 BigQuery 数据资源
foo，且键值等于 bar。 |
label.foo=bar |
匹配键为 foo 且键值为 bar 的 BigQuery 数据资源。 |
label.foo |
匹配带有以下标签的 BigQuery 数据资产：
键等于字符串的 foo。 |
type=TYPE |
匹配特定条目类型或其类型别名的相关数据资产。 |
projectid:bar |
匹配 Google Cloud 项目中的数据资源，这些 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 |
查找在特定日期之前、之后或之后创建的数据资产 日期或时间。 例如：
时间戳格式： 所有时间戳都必须采用格林尼治标准时间；时区。支持部分时间戳、英文短划线 ( 例如：
|
updatetime |
查找在指定日期内、之前或之后更新的数据资产 日期或时间。 例如：
时间戳格式： 所有时间戳都必须采用格林尼治标准时间；时区。支持部分时间戳、英文短划线 ( 例如：
|
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 |
搜索切面字段值。将 支持的运算符列表取决于 如下所示：
只有相应方面中的顶级字段可供搜索。 例如，以下所有查询都与值为
（位于
|
逻辑运算符
查询可以由若干谓词和逻辑运算符组成。如果您未指定运算符，则意味着使用隐含的逻辑 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) - OR：
column:(name1|name2|name3)
此缩写语法适用于限定谓词，但 label 除外。
后续步骤
- 了解如何在 Dataplex Catalog 中搜索数据资产
- 详细了解 Dataplex Catalog。
- 了解如何使用方面为条目添加元数据。
- 了解如何管理条目和提取自定义来源。