使用資料網域

預覽

這項產品或功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前的產品和功能是按照「原樣」提供，支援範圍可能有限。 詳情請參閱推出階段說明。

資料領域使用者可以利用資料領域，將搜尋結果範圍縮小至特定業務情境、搜尋 BigQuery 資料集、資料表和資料產品，以及在特定領域界線內探索中繼資料。

事前準備

依網域執行搜尋前，請確認您具備必要角色，並已啟用 API。

啟用 API

啟用 Dataplex API。

啟用 API 時所需的角色

如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則，您可以透過「服務使用情形管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

啟用 API

必要的角色

如要取得使用資料網域搜尋及探索中繼資料所需的權限，請要求管理員授予您專案或資料網域的下列 IAM 角色：

• 查看網域項目的中繼資料以進行探索： Dataplex 資料網域項目讀取者 (roles/dataplex.dataDomainEntryReader)
• 查看網域設定和繫結： Dataplex 資料網域設定檢視者 (roles/dataplex.dataDomainViewer)

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

瀏覽網域階層

如要進一步瞭解如何瀏覽網域階層，請參閱「查看位置中的資料網域和子網域」。

尋找資料網域中的資源

如要依網域搜尋資源，請按照下列步驟操作：

控制台

1. 在 Google Cloud 控制台中，依序前往「Knowledge Catalog」(知識目錄) >「Search」(搜尋) 頁面。

   前往「搜尋」

2. 按一下「試用隨機搜尋」，啟用搜尋結果功能。

3. 按一下 [篩選器]。

4. 在「範圍」欄位中，從清單選取「網域」。

5. 在「選取網域」欄位中，選取要縮小搜尋範圍的網域。視需要新增其他篩選條件。

或者，您也可以使用「在網域中搜尋」選單選項，在網域中尋找資源：

1. 前往 Google Cloud 控制台的「資料網域」頁面。

   前往「資料網域」

2. 從 more_vert 選單中選取「在網域內搜尋」。系統會自動開啟搜尋視窗，並套用「網域」篩選條件。

3. 使用搜尋欄位尋找網域中的資源。

REST

如要搜尋資料網域範圍內的項目，請使用 projects.locations.searchEntries 方法，並在 contexts 參數中提供網域路徑。

注意： searchEntries 路徑中的位置可以是 global (適用於完整扇出)，也可以是特定區域，視搜尋後端設定而定。

使用任何要求資料之前，請先修改下列項目的值：

• PROJECT_ID：專案的 ID。 Google Cloud
• 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
}

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries" | Select-Object -Expand Content

您應該會收到執行成功的狀態碼 (2xx) 和空白回應。

限制

在網域環境外搜尋資源時 (例如使用全域搜尋)，網域的探索權限不會套用。 您只會看到基礎系統 (例如 BigQuery) 中有權存取的資源。

假設資料網域中包含 BigQuery 資料集。您擁有網域的「Dataplex Data Domain Entry Reader」角色，但沒有直接在 BigQuery 中查看資料集的權限：

• 在網域內搜尋：由於網域權限適用，因此搜尋結果會顯示資料集。
• 在網域外搜尋：搜尋結果不會顯示資料集。一般搜尋不會套用網域權限，您也無法在 BigQuery 中直接存取。

後續步驟

• 進一步瞭解資料網域。
• 瞭解如何建立資料網域。
• 瞭解如何管理資料網域資源。