本文將說明 Dataplex Universal Catalog 搜尋查詢的語法。閱讀本文前，請務必先瞭解 Dataplex Universal Catalog 中繼資料管理的概念，例如項目、切面、切面類型、項目群組和項目類型。詳情請參閱「關於 Dataplex Universal Catalog 中的中繼資料管理」。
Dataplex Universal Catalog 提供兩種搜尋模式：關鍵字搜尋和自然語言搜尋 (搶先版)。
您可以使用特定關鍵字、篩選器和定義的語法，透過關鍵字搜尋尋找資源。
自然語言搜尋功能可擴充關鍵字搜尋，支援自然語言查詢。您可以使用日常用語尋找資源，不必再使用複雜的語法。
本文涵蓋關鍵字和自然語言搜尋的語法。
如要在Google Cloud 控制台中啟動 Dataplex Universal Catalog 搜尋查詢，請前往 Dataplex Universal Catalog 的「Search」(搜尋) 頁面，然後選取「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 |
比對具有標籤 (具有某些值) 的 BigQuery 資源，且標籤鍵包含 bar 做為子字串。 |
label=bar |
比對具有標籤 (含某些值) 的 BigQuery 資源，且標籤鍵等於 bar (字串)。 |
label:bar:x |
比對附加至 BigQuery 資源的鍵 bar，做為標籤值中的子字串。x |
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。 |
自然語言搜尋
述詞鍵 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 |
比對具有標籤 (具有某些值) 的 BigQuery 資源，且標籤鍵包含 bar 做為子字串。 |
labels=bar |
比對具有標籤 (含某些值) 的 BigQuery 資源，且標籤鍵等於 bar (字串)。 |
labels.bar:x |
比對附加至 BigQuery 資源的鍵 bar，做為標籤值中的子字串。x |
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 |
搜尋顯示比例欄位值。比對 支援的運算子清單取決於構面中的欄位類型，如下所示：
只有層面頂層欄位可供搜尋。 舉例來說，下列所有查詢都會比對項目，其中
|
自然語言搜尋
| 限定詞 | 說明 |
|---|---|
has:x |
以附加至項目的構面類型完整路徑的子字串形式比對 x，格式為 projectid.location.ASPECT_TYPE_ID |
has=x |
比對 x，做為附加至項目的構面類型完整路徑，格式為 projectid.location.ASPECT_TYPE_ID |
has: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 的中繼資料管理功能。
- 瞭解如何使用構面，透過中繼資料擴充項目。
- 瞭解如何管理項目及擷取自訂來源。