本文档介绍了 Dataplex Universal Catalog 关键字搜索和自然语言 AI 搜索的语法。
借助 Dataplex Universal Catalog，您可以发现、集中编目、管理和了解组织的数据。如需在数据目录中高效查找特定数据资产，您可以使用强大的搜索查询。搜索查询的语法包括：
- 简单搜索：如何使用单个搜索字词查找数据资产。
- 限定谓词：如何使用名称、位置或说明等特定元数据字段来优化搜索。
- 方面搜索：如何根据条目附加的业务元数据和技术元数据搜索条目。
- 逻辑运算符：如何使用 AND 和 OR 组合多个搜索条件来创建复杂的查询。了解此语法后，您便可以快速找到所需的数据。
准备工作
了解 Dataplex Universal Catalog 条目、切面、切面类型、条目组和条目类型。请参阅 Dataplex Universal Catalog 中的元数据管理简介。
Dataplex Universal Catalog 提供两种搜索模式：关键字搜索和自然语言搜索（预览版）。
- 借助关键字搜索，您可以使用特定关键字、过滤条件和定义的语法来查找资源。
- 自然语言搜索利用 AI 来理解语义查询。它可让您使用日常用语查找 AI 资源，无需使用复杂的语法。
本文档介绍了关键字搜索和自然语言搜索的语法。 AI 如需在Google Cloud 控制台中启动 Dataplex Universal Catalog 搜索查询，请前往 Dataplex Universal Catalog 搜索页面，然后选择 Dataplex Universal Catalog 作为搜索平台。
如需了解详情，请参阅在 Dataplex Universal Catalog 中搜索资源。
输入任何文字进行搜索
您可以输入字词或短语（无需使用任何特定语法）来查找资产。 Dataplex Universal Catalog 会将您的查询与多个元数据字段进行匹配，从而执行广泛的搜索，这些字段包括：
- 资源的名称、显示名称或说明
- 资源的类型
- 项目 ID
- 概览说明
- 资源架构中的列名称（或嵌套列名称）
- 列说明
- 完全限定名称
- 联系人
- 切面
使用查询语法进行搜索
如需进行更精确的搜索，您可以使用特定语法构建查询，包括限定符、逻辑运算符和切面搜索。
限定谓词
您可以通过在谓词前面添加一个键来限定谓词，该键将匹配限制为特定的一部分元数据：
- 等号 (
=) 将搜索限制为完全匹配。 - 键后面的英文冒号 (
:) 将谓词与搜索结果的值中的子字符串或词元匹配。
词元化将文本流分解为一系列词元，每个词元通常对应于一个字词。
例如：
name:foo选择名称中包含foo子字符串的资源，例如foo1和barfoo。description:foo选择说明中包含foo词元的资源，例如bar和foo。location=foo匹配指定位置中以foo作为位置名称的资源。
这些限定符的行为在不同搜索模式下可能会略有不同，详情请参阅以下各部分。
关键字搜索
谓词键 type、system、location 和 orgid 仅支持完全匹配 (=) 限定符，不支持子字符串限定符 (:)。例如，type=foo 或 orgid=number。
Dataplex Universal 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 匹配。 |
自然语言搜索
AI
谓词键 type、system、location 和 description 以及切面搜索（不包括 has）仅支持完全匹配 (=) 限定符，不支持子字符串限定符 (:)。例如，type=foo。
Dataplex Universal Catalog 支持以下自然语言搜索限定符：
| 限定符 | 说明 |
|---|---|
name:x |
将 x 作为资源 ID 或资源显示名称的子字符串匹配。 |
displayname:x |
将 x 作为子字符串与资源显示名称匹配。 |
column:x |
将 x 作为子字符串与资源架构中的列名称（或嵌套列名称）匹配。 |
description:x |
将 x 作为词元与资源说明匹配。 |
labels:bar |
匹配具有标签（带有某个值）且标签键中含有 bar 作为子字符串的 BigQuery 资源。 |
labels=bar |
匹配具有标签（带有某个值）且标签键等于 bar 作为字符串的 BigQuery 资源。 |
labels.bar:x |
将 x 作为子字符串与附加到 BigQuery 资源的键为 bar 的标签值匹配。 |
labels.foo=bar |
匹配键为 foo 且键值为 bar 的 BigQuery 资源。 |
type=TYPE |
匹配特定条目类型或其类型别名的资源。 |
projectid:bar |
匹配 Google Cloud 项目中的资源，这些资源以 ID 中的字符串形式匹配 bar。 |
parent:x |
将 x 作为资源的层次结构路径的子字符串匹配。 |
system=SYSTEM |
匹配指定系统中的资源。 |
location=LOCATION |
匹配指定位置中具有确切名称的资源。
例如， BigQuery Omni 资产通过使用 BigQuery Omni 位置名称来支持此限定符。例如， |
createtime |
查找在指定日期或时间之内、之前或之后创建的资源。 例如：
时间戳格式： 所有时间戳必须采用 GMT（不支持时区）。支持部分时间戳、连字符 ( 例如：
|
updatetime |
查找在指定日期或时间之内、之前或之后更新的资源。 例如：
时间戳格式： 所有时间戳必须采用 GMT（不支持时区）。支持部分时间戳、连字符 ( 例如：
|
切面搜索
如需根据条目的附加切面搜索条目，请使用以下查询语法。
关键字搜索
| 限定符 | 说明 |
|---|---|
aspect:x |
将 x 作为子字符串与附加到条目的切面的切面类型的完整路径匹配，格式为 projectid.location.ASPECT_TYPE_ID |
aspect=x |
将 x 与附加到条目的切面的切面类型的完整路径匹配，格式为 projectid.location.ASPECT_TYPE_ID |
aspect:xOPERATORvalue |
搜索切面字段值。将 支持的运算符列表取决于切面中的字段类型，如下所示：
只有切面的顶级字段可供搜索。 例如，以下所有查询都会匹配
|
自然语言搜索
AI
| 限定符 | 说明 |
|---|---|
has:x |
将 x 作为子字符串与附加到条目的切面的切面类型的完整路径匹配，格式为 projectid.location.ASPECT_TYPE_ID |
has=x |
将 x 与附加到条目的切面的切面类型的完整路径匹配，格式为 projectid.location.ASPECT_TYPE_ID |
xOPERATORvalue |
搜索切面字段值。将
只有切面的顶级字段可供搜索。 |
逻辑运算符
查询可以由若干谓词和逻辑运算符组成。如果您未指定运算符，则意味着使用隐含的逻辑 AND。例如，foo bar 返回同时匹配谓词 foo 和谓词 bar 的资源。
支持逻辑 AND 和逻辑 OR。例如 foo OR bar。
您可以使用 -（连字符）或 NOT 前缀来排除谓词。例如，-name:foo 会返回名称与谓词 foo 不匹配的资源。
缩写语法
您还可以使用缩写搜索语法，用 |（竖线）代替 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 Universal Catalog 中搜索资源
- 详细了解 Dataplex Universal Catalog 中的元数据管理。
- 了解如何使用切面通过元数据丰富条目。
- 了解如何管理条目和注入自定义来源。