Knowledge Catalog (舊稱 Dataplex Universal Catalog) 的資料網域可讓您將搜尋結果縮小至特定業務情境，並在定義的範圍內探索中繼資料。資料網域使用者可以瀏覽網域階層、搜尋網域資源，以及擷取網域背景資訊，為 AI 代理提供基準。
事前準備
依網域搜尋前，請確認您具備必要角色，並已啟用相關 API。
啟用 API
啟用 Dataplex API (如果尚未啟用)。
啟用 API 所需的角色
您必須具備 serviceusage.services.enable 權限，才能啟用 API。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「Service Usage 管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。
必要的角色
如要取得使用資料網域搜尋及探索中繼資料所需的權限，請要求管理員在專案或資料網域中，授予您下列 IAM 角色：
-
查看探索用網域項目的中繼資料：Dataplex 資料網域項目讀取者 (
roles/dataplex.dataDomainEntryReader) -
查看網域設定和繫結：Dataplex 資料網域設定檢視者 (
roles/dataplex.dataDomainViewer)
如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。
瀏覽網域階層
如要進一步瞭解如何瀏覽網域階層，請參閱「查看特定位置的資料網域和子網域」。
尋找資料網域中的資源
您可以在資料網域中搜尋，找出 BigQuery 資料集、資料表和資料產品等資源，並查看其中繼資料。如要搜尋網域內的資源，請按照下列步驟操作：
控制台
在 Google Cloud 控制台，依序前往「Knowledge Catalog」 >「Search」(搜尋) 頁面。
按一下「試用自然搜尋」，啟用自然搜尋功能。
按一下 [篩選器]。
在「Scope」欄位中，從清單選取「Domain」。
在「Select domain」(選取網域) 欄位中，選取要縮小結果範圍的網域。視需要新增其他篩選條件。
或者，您也可以使用「Search within domain」(在網域內搜尋) 選單選項，尋找網域中的資源：
前往 Google Cloud 控制台的「Data domains」(資料網域) 頁面。
從 選單中選取「在網域內搜尋」。這項操作會自動開啟已套用「網域」篩選條件的搜尋視窗。
使用搜尋欄位尋找網域中的資源。
REST
如要搜尋資料網域範圍內的項目，請使用 projects.locations.searchEntries 方法，並在 contexts 參數中提供網域路徑。
使用任何要求資料之前，請先修改下列項目的值：
PROJECT_ID： Google Cloud 專案的 ID。LOCATION_ID：搜尋查詢的區域 (或global)。QUERY：搜尋查詢字串。DOMAIN_ID：資料網域的專屬 ID，用於定義搜尋範圍情境。
HTTP 方法和網址：
POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries
JSON 要求主體：
{
"query": "QUERY",
"contexts": [ "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" ],
"semantic_search": true,
"page_size": 100
}
請展開以下其中一個選項，以傳送要求：
您應該會收到執行成功的狀態碼 (2xx) 和空白回應。
擷取資料網域的背景資訊
您可以使用 lookupContext 方法，根據資料網域擷取的業務背景資訊，為 AI 代理建立基準。lookupContext 方法支援資料網域的方式如下：
- 資料網域的背景資訊。您可以在
resources清單中傳遞代表資料網域的項目。回覆包含資料網域的中繼資料，例如說明和網域階層中的父項資料網域。 - 資料資產的資料網域成員資格。擷取一或多個資料網域中資料資產的背景資訊時，回應會包含
dataDomains欄位，列出資產所屬的資料網域，從最特定的網域開始，向上到頂層網域。
如要擷取資料網域的背景資訊，請傳送下列要求：
curl --request POST \
'https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION:lookupContext' \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H 'Content-Type: application/json' \
-d '{
"resources": [
"projects/PROJECT_ID/locations/LOCATION/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION/dataDomains/DATA_DOMAIN_ID"
],
"options": {
"format": "yaml"
}
}'
更改下列內容：
- PROJECT_ID：包含資料網域的專案 ID。
- PROJECT_NUMBER：資料網域 所在專案的編號。
- LOCATION：資料網域的位置。
- DATA_DOMAIN_ID：資料網域的 ID。
如要進一步瞭解 lookupContext 方法，請參閱「擷取資料資產的背景資訊」。
限制
在網域環境外搜尋資源時 (例如使用全域搜尋)，網域的曝光度權限不適用。您只會看到在基礎系統 (例如 BigQuery) 中有權存取的資源。
假設資料網域包含 BigQuery 資料集。您具備該網域的「Dataplex Data Domain Entry Reader」角色，但沒有直接在 BigQuery 查看資料集的權限：
- 在網域內搜尋：由於網域權限適用，您會在搜尋結果中看到資料集。
- 在網域外搜尋：搜尋結果不會顯示資料集。一般搜尋不適用網域權限，您也無法在 BigQuery 中直接存取。