使用資料產品

您可以使用 Knowledge Catalog (舊稱 Dataplex Universal Catalog) 的資料產品,尋找精選資產集合,並透過內建的核准工作流程要求存取權。核准後,您可以使用使用者憑證、服務帳戶或遠端 Model Context Protocol (MCP) 伺服器,查詢基礎資料,例如 BigQuery 資料表。

本文適用於資料產品消費者。如要進一步瞭解資料產品的架構和重要概念,請參閱「關於資料產品」。

事前準備

  1. 啟用 Dataplex 和 BigQuery API (如果尚未啟用)。

    啟用 API 所需的角色

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

    啟用 API

必要的角色

如要取得搜尋、存取及使用資料產品所需的權限,請要求管理員授予您資料產品或專案的下列 IAM 角色:

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

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

身為資料產品消費者,您必須具備 viewer 權限,才能存取來源系統中的對應資產,並查看資產的中繼資料。舉例來說,如要搜尋資料產品中資料集或資料表的中繼資料,您需要 BigQuery 中繼資料檢視者角色 (roles/bigquery.metadataViewer)。詳情請參閱「存取搜尋結果所需的角色」。

控制台

  1. 在 Google Cloud 控制台,前往 Knowledge Catalog 的「Search」(搜尋) 頁面。

    前往「Search」(搜尋) 頁面

  2. 使用關鍵字或自然語言搜尋。詳情請參閱「搜尋資源」。

  3. 在搜尋結果中,按一下要查看詳細資料的資料產品。您可以查看資料產品的說明、資產、合約、面向、聯絡資料和其他說明文件。

REST

如要搜尋資料產品,請使用 searchEntries 方法。

例如,傳送下列 POST 要求:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d \
  '{
  "query": "ADDITIONAL_KEYWORDS (type=(DATA_PRODUCT))",
  "pageSize": 10
  }' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/global:searchEntries"

更改下列內容:

  • ADDITIONAL_KEYWORDS (選用):任何其他關鍵字或搜尋條件,用於縮小結果範圍 (例如 displayName:'My Data Product' 或 description:'sales')
  • PROJECT_ID:建立資料產品的 Google Cloud專案 ID

要求資料產品存取權

如果您是資料產品消費者,但沒有存取資料產品的 IAM 權限,可以使用整合式存取權核准工作流程要求存取權。

提交存取要求

控制台

  1. 在 Google Cloud 控制台,前往 Knowledge Catalog 的「Data products」(資料產品) 頁面。

    前往「Data products」(資料產品)

  2. 按一下要存取的資料產品。

  3. 按一下 [要求存取權]。

  4. 在「Request details」窗格中,指定下列參數:

    • 存取權群組:選取要加入的功能存取權群組。
    • 「Self」(自我) 或「Service account」(服務帳戶):選取主體類型:

      • 如果是為自己要求存取權,請選取「自己」。

      • 如要要求程式輔助身分的存取權,請選取「Service account」(服務帳戶)。只有在資料產品支援服務帳戶時,才能使用這個選項。

    • 理由:輸入要求的業務理由。

  5. 按一下「提交」。

系統會產生新的變更要求,供資料產品擁有者審查。要求獲准或遭拒後,您會收到電子郵件通知,說明最終狀態。

REST

具備 dataplex.dataProducts.get 權限的資料產品消費者,可以建立 ChangeRequest 資源來要求存取權。使用自訂方法 :requestAccess,將 POST 要求傳送至資料產品資源端點:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
  "parent": "projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID",
  "change_request": {
    "justification": "JUSTIFICATION_TEXT",
    "data_product_access_request": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID",
      "access_group_id": "DATA_PRODUCT_ACCESS_GROUP_ID"
    }
  }
}' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID:requestAccess"

更改下列內容:

  • PROJECT_ID: Google Cloud 專案的 ID

  • LOCATION:資料產品所在的區域 (例如 us-central1)

  • DATA_PRODUCT_ID:目標資料產品的專屬 ID

  • JUSTIFICATION_TEXT:說明存取權需求的業務原因

  • DATA_PRODUCT_ACCESS_GROUP_ID:您要求加入的特定存取權群組 ID

查看存取要求的狀態

資料產品消費者可以監控已提交存取要求的進度和生命週期。Knowledge Catalog 會追蹤並顯示這些要求,並根據您查看的是統一工作流程清單,還是特定產品的存取權摘要,使用不同的狀態。

查看統整後的存取要求清單

如要查看所有資料產品中提交的存取權要求完整清單,請按照下列步驟操作:

控制台

  1. 前往 Google Cloud 控制台的 Knowledge Catalog「Governance workflows」(管理工作流程) 頁面。

    前往「Governance workflows」(管理工作流程)

  2. 按一下「我的要求」分頁標籤。

  3. 查看整合清單,其中會顯示過去和待處理的要求,以及目前的工作流程狀態:

    • New:存取權要求已建立,尚待核准者審查。

    • 已核准:要求已獲核准,但後端系統仍在佈建存取權。

    • 已遭拒:要求遭拒。查看核准者的留言,瞭解拒絕原因。

REST

使用自訂集合方法 :listMine 傳送 GET 要求:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests:listMine"

查看特定資料產品的存取權摘要

除了全域工作流程清單外,您也可以查看個別資料產品的存取權狀態。這樣一來,您就能確認是否已繼承素材資源群組的存取權,不必提交新的要求。

如要查看資料產品的存取權摘要,請按照下列步驟操作:

控制台

  1. 在 Google Cloud 控制台,前往 Knowledge Catalog 的「Data products」(資料產品) 頁面。

    前往「Data products」(資料產品)

  2. 按一下要檢查的特定資料產品。

  3. 按一下「存取權摘要」分頁標籤。查看您在該資料產品所有存取權群組中的狀態。

    「存取權摘要」分頁會使用下列狀態:

    狀態 說明
    沒有任何存取權限 您沒有存取權群組的存取權,也尚未提出要求。
    審核中 您已提交存取權要求,目前正在等待核准者審查。
    已核准 您的存取權要求已獲准,但系統仍在將成員資格套用至基礎 Google 群組。
    已授予存取權 存取權已完全啟用。您是存取權群組的成員,可以與資料產品的資產互動。
    已遭拒 您針對這個存取權群組提出的存取要求已遭拒。

REST

使用要求最初建立時傳回的專屬 ID,傳送 GET 要求:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/changeRequests/CHANGE_REQUEST_ID"

更改下列內容:

  • PROJECT_ID: Google Cloud 專案的 ID

  • LOCATION:資料產品所在的區域 (例如 us-central1)

  • CHANGE_REQUEST_ID:已提交變更要求的專屬 ID

刪除存取要求

  1. 前往 Google Cloud 控制台的 Knowledge Catalog「Governance workflows」(管理工作流程) 頁面。

    前往「Governance workflows」(管理工作流程)

  2. 按一下「我的要求」分頁標籤。

  3. 找到目標資料產品要求所在的資料列。如有需要,請套用篩選器來找出該項目。

  4. 依序點選 「Actions」(動作) 和「Delete」(刪除)。

使用資料產品

如要使用資料產品,請確認您已取得必要權限。請參閱「要求資料產品存取權」。

資料產品擁有者授予權限後,您就能存取資料產品及其資產。舉例來說,如果您有權存取 BigQuery 資料表,可以直接在 BigQuery 查詢資料表,生成洞察資料。

使用使用者憑證存取資產

如果使用者憑證的存取要求已獲准,請按照下列步驟存取資產:

  1. 搜尋資料產品。
  2. 在搜尋結果中,按一下要使用的資料產品。
  3. 按一下「資產」分頁標籤。
  4. 按一下要查看詳細資料的素材資源。項目詳細資料頁面隨即開啟。

    您可以查看結構定義、洞察和歷程等詳細資料。如果資產是 BigQuery 資料表或檢視表,您可以點選「Open in BigQuery」(在 BigQuery 中開啟),前往 BigQuery Studio 查詢結果。

使用服務帳戶存取資產

如果服務帳戶的存取要求獲得核准,您會取得資料產生者服務帳戶的服務帳戶權杖建立者 (roles/iam.serviceAccountTokenCreator) IAM 角色。這樣一來,您就能建立模擬鏈結,存取基礎資產。

如要使用服務帳戶存取資產,請按照下列步驟操作:

  1. 前往資料產品詳細資料頁面的「Data Assets」(資料資產) 分頁,找出為資料產品設定的服務帳戶。

  2. 如要模擬資料產生器服務帳戶,請使用下列 Google Cloud CLI 指令,為服務帳戶建立模擬鏈結:

    gcloud config set auth/impersonate_service_account CONSUMER_SERVICE_ACCOUNT,PRODUCER_SERVICE_ACCOUNT
    

    更改下列內容:

    • CONSUMER_SERVICE_ACCOUNT:資料產品消費者服務帳戶的完整電子郵件地址

    • PRODUCER_SERVICE_ACCOUNT:對應至資料產品存取權群組的服務帳戶完整電子郵件地址

    詳情請參閱「使用服務帳戶模擬功能」。

使用遠端 MCP 伺服器存取資料產品

如果用戶端應用程式和開發人員工具在 Google Cloud 生態系統外與資料產品互動,您可以使用遠端 Model Context Protocol (MCP) 伺服器。這種架構模式可讓外部開發人員用戶端安全地查詢及探索編目資料資產,同時維持統一的管理界線。

如要瞭解如何部署及連線至外部伺服器,請參閱「使用 Knowledge Catalog 遠端 MCP 伺服器」。

後續步驟