管理資料交換

您可以使用 BigQuery sharing 中的資料交換庫，在專案、機構或公開環境中安全地共用資料集。身為 BigQuery sharing 管理員，您可以執行下列工作：

  • 建立、更新、查看、分享及刪除資料交換。
  • 管理資料交換的存取權和角色。
  • 公開資料交換。

如要管理資料交換庫中的清單，請參閱「管理清單」。

資料交換預設為私密。只有可存取交換庫的使用者或群組，才能查看或訂閱交換庫的刊登內容。您可以公開資料交換。將資料交易所設為公開後，Google Cloud 使用者 (allAuthenticatedUsers) 就能探索及訂閱房源資訊。

事前準備

如要開始使用 BigQuery sharing (舊稱 Analytics Hub)，請在專案中啟用 Analytics Hub API Google Cloud 。

如要啟用 Analytics Hub API，您需要下列 Identity and Access Management (IAM) 權限：

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

以下是具有啟用 Analytics Hub API 所需權限的預先定義 IAM 角色：

如要啟用 Analytics Hub API，請選取下列其中一個選項：

控制台

前往 Analytics Hub API 頁面，為專案啟用 Analytics Hub API。 Google Cloud

啟用 Analytics Hub API

gcloud

執行 gcloud services enable 指令：

gcloud services enable analyticshub.googleapis.com

必要的角色

如要取得管理資料交易所需的權限，請要求管理員授予您專案的Analytics Hub 管理員角色 (roles/analyticshub.admin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

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

建立資料交換庫

您可以建立資料交換，與特定使用者、群組或大眾共用資料集。建立資料交換庫時，請指定專案、區域、顯示名稱，以及訂閱端電子郵件記錄和公開可偵測性等選用設定。

如要建立資料交換庫，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Sharing (Analytics Hub)」頁面。

    前往「共用」(舊稱 Analytics Hub)

  2. 按一下 「建立兌換」。

  3. 在「建立交換庫」對話方塊中，選取資料交換庫的「專案」和「區域」。建立資料交換後，就無法變更專案和地區。

  4. 在「顯示名稱」欄位中，輸入資料交易所的名稱。

  5. 選用：在下列欄位中輸入值：

    • 主要聯絡人：輸入資料交換的主要聯絡人網址或電子郵件地址。
    • 說明：輸入資料交易所的說明。

  6. 如要記錄在連結資料集上執行工作和查詢的所有使用者主體 ID，請點選「訂閱端電子郵件記錄」切換按鈕，將其設為開啟。開啟這項設定後，資料交換庫中所有日後的刊登項目都會啟用訂閱者電子郵件記錄功能。記錄的資料會顯示在 INFORMATION_SCHEMA.SHARED_DATASET_USAGE 檢視區塊的 job_principal_subject 欄位中。

  7. 如要公開顯示交換庫，請將「Public Discoverability」(公開可偵測性) 切換鈕設為開啟。如果交換庫可公開探索，目錄中就會顯示交換庫中的所有項目，且可供搜尋。啟用公開探索功能時，請考量下列因素：

    • 清單繼承：根據預設，所有清單都會繼承資料交換設定的公開探索設定。公開交換庫中不能有私人清單項目，但私人交換庫中可以有公開清單項目。您可以在個別房源層級設定公開探索類型。
    • 權限：啟用公開探索功能後，請設定交換權限，將 Analytics Hub 檢視者角色 (roles/analyticshub.viewer) 授予 allUsers 或 allAuthenticatedUsers。
    • 專案規定：建立資料交換的專案必須有相關聯的機構和帳單帳戶。

  8. 如要建立資料交換，請按一下「建立交換庫」。

  9. 選用步驟：在「Exchange Permissions」(Exchange 權限) 部分，完成下列步驟：

    1. 在下列欄位中輸入電子郵件地址，授予 Identity and Access Management (IAM) 角色：

      • 管理員：為這些使用者指派Analytics Hub 管理員角色 (roles/analyticshub.admin)。
      • 發布者：將 Analytics Hub 發布者角色 (roles/analyticshub.publisher) 指派給這些使用者。如要進一步瞭解 BigQuery sharing 發布端可執行的工作，請參閱「管理清單」。
      • 訂閱者：將 Analytics Hub 訂閱者角色 (roles/analyticshub.subscriber) 指派給這些使用者。如要進一步瞭解 BigQuery sharing 訂閱者可執行的工作，請參閱「查看及訂閱資料集和資料交易所」。
      • 檢視者：為這些使用者指派 Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。BigQuery sharing 檢視者可以查看房源資訊。如果啟用公開探索功能，請將 Analytics Hub 檢視者角色授予 allUsers 或 allAuthenticatedUsers。

    2. 如要儲存權限，請按一下「設定權限」。

  10. 如果未設定資料交換的權限，請按一下「略過」。

API

如要建立資料交換庫，請使用 projects.locations.dataExchanges.create 方法：

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges?dataExchangeId=DATAEXCHANGE_ID

更改下列內容：

  • PROJECT_ID：您要在當中建立資料交換的專案 ID。
  • LOCATION：資料交換庫的位置。如要進一步瞭解支援 BigQuery 分享功能的地區，請參閱支援的地區。
  • DATAEXCHANGE_ID：資料交換庫的 ID。

在要求主體中，提供資料交換詳細資料。

如果要求成功，回應主體會包含資料交換的詳細資料。

如果您使用 logLinkedDatasetQueryUserEmail 欄位啟用訂閱者電子郵件記錄功能，資料交換庫回應會包含 log_linked_dataset_query_user_email: true。記錄的資料會顯示在 INFORMATION_SCHEMA.SHARED_DATASET_USAGE 檢視區塊的 job_principal_subject 欄位中。

如要進一步瞭解如何使用 API 對資料交易所執行工作，請參閱 projects.locations.dataExchanges 方法。

更新資料交換

您可以更新現有資料交換的設定，例如顯示名稱、說明、主要聯絡人和公開探索設定。您無法變更現有資料交換的專案或區域。

如要更新資料交換庫，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Sharing (Analytics Hub)」頁面。

    前往「共用」(舊稱 Analytics Hub)

  2. 在資料交換清單中，選取要更新的資料交換。

  3. 點按「Details」(詳細資料) 分頁標籤。

  4. 按一下「編輯兌換」。

  5. 在「編輯交易所」對話方塊中，更新下列欄位：

    • 顯示名稱：輸入新的顯示名稱。
    • 主要聯絡人：輸入更新後的網址或電子郵件地址。
    • 說明：輸入更新後的說明。

    • 開放搜尋：開啟或關閉開放搜尋功能。

      • 如要啟用公開探索功能，請將 Analytics Hub 檢視者角色 (roles/analyticshub.viewer) 授予 allUsers 或 allAuthenticatedUsers。
      • 如果關閉公開探索功能，請從 allUsers 或 allAuthenticatedUsers 移除 Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。公開交換庫中不能有私人清單項目，但私人交換庫中可以有公開清單項目。

    • 訂閱端電子郵件記錄：開啟或關閉訂閱端電子郵件記錄功能。

  6. 如要套用變更，請按一下「儲存」。

API

如要更新資料交換，請使用 projects.locations.dataExchanges.patch 方法：

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID?updateMask=UPDATEMASK

更改下列內容：

  • PROJECT_ID：包含資料交換的專案 ID。
  • LOCATION：資料交換庫的位置。
  • DATAEXCHANGE_ID：資料交換庫的 ID。
  • UPDATEMASK：以半形逗號分隔的欄位清單，列出要更新的欄位 (例如 displayName,primaryContact)。

在要求主體中，為下列任一欄位指定更新的值：

  • displayName
  • description
  • primaryContact
  • documentation
  • icon
  • discoveryType
  • logLinkedDatasetQueryUserEmail

如要進一步瞭解這些欄位，請參閱「資源：DataExchange」。

如要進一步瞭解如何使用 API 對資料交易所執行工作，請參閱 projects.locations.dataExchanges 方法。

查看資料交換庫

您可以查看 Google Cloud 專案或機構中，您有權存取的資料交換清單。

如要查看資料交換庫，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Sharing (Analytics Hub)」頁面。

    前往「共用」(舊稱 Analytics Hub)

  2. 在資料交易所清單中，查看為Google Cloud 專案顯示的資料交易所。如果您擁有 resourcemanager.organizations.get 權限，也可以查看整個機構的資料交換情形。 Google Cloud

API

如要查看專案中的資料交換，請使用 projects.locations.dataExchanges.list 方法：

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges

更改下列內容：

  • PROJECT_ID：您要列出資料交易所的專案 ID。
  • LOCATION：要列出現有資料交換的位置。

如要查看貴機構的資料交換活動，請使用 organizations.locations.dataExchanges.list 方法：

GET https://analyticshub.googleapis.com/v1/organizations/ORGANIZATION_ID/locations/LOCATION/dataExchanges

更改下列內容：

  • ORGANIZATION_ID：組織 ID。詳情請參閱「取得組織 ID」。
  • LOCATION：要列出現有資料交換的位置。

共用資料交換庫

如果 BigQuery sharing 發布者與資料交換庫所屬的機構不同，他們就無法在 BigQuery sharing 中瀏覽或查看您的資料交換庫。如要讓發布商存取資料交換，您可以複製並分享直接連結。

如要分享資料交換庫的連結，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「Sharing (Analytics Hub)」頁面。

    前往「共用」(舊稱 Analytics Hub)

  2. 在資料交換清單中，找出要共用的資料交換，然後按一下「更多選項」。

  3. 如要將連結複製到剪貼簿，請按一下 「複製共用連結」。

授予使用者資料交換存取權

如要授予使用者資料交換存取權，請為該資料交換設定 IAM 政策。如要進一步瞭解預先定義的 IAM 使用者角色，請參閱「BigQuery 共用 IAM 角色」。

控制台

  1. 前往 Google Cloud 控制台的「Sharing (Analytics Hub)」頁面。

    前往「共用」(舊稱 Analytics Hub)

  2. 按一下要設定權限的資料交易所名稱。

  3. 點按「Details」(詳細資料) 分頁標籤。

  4. 按一下「設定權限」。

  5. 如要新增主體，請按一下 「新增主體」。

  6. 在「New principals」(新增主體) 欄位中，輸入要授予存取權的主體電子郵件地址。您也可以使用 allUsers 將資源設為公開，讓網際網路上的所有人都能存取，或使用 allAuthenticatedUsers 將資源設為僅供已登入 Google 帳戶的使用者存取。

  7. 在「Select a role」(請選擇角色) 清單中，將指標懸停在「Analytics Hub」(資料分析中心) 上，然後選取下列其中一個 IAM 角色：

    • Analytics Hub 管理員
    • Analytics Hub 清單管理員
    • Analytics Hub 發布者
    • Analytics Hub 訂閱者
    • Analytics Hub 訂閱項目擁有者
    • Analytics Hub 檢視者

  8. 按一下 [儲存]。

API

  1. 如要讀取現有政策，請使用 projects.locations.dataExchanges.getIamPolicy 方法：

    POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:getIamPolicy

    更改下列內容：

    • PROJECT_ID：專案 ID，例如 my-project-1。
    • LOCATION：資料交換的位置。使用小寫英文字母。
    • DATAEXCHANGE_ID：資料交換 ID。

    BigQuery 共用功能會傳回目前的政策。

  2. 如要新增或移除成員及其相關聯的 IAM 角色，請使用文字編輯器編輯政策。請使用下列格式新增成員：

    • user:test-user@gmail.com
    • group:admins@googlegroups.com
    • serviceAccount:server@example.gserviceaccount.com
    • domain:example.com

    舉例來說，如要將 roles/analyticshub.subscriber 角色授予 group:subscribers@googlegroups.com，請在政策中新增下列繫結：

    {
 "members": [
   "group:subscribers@googlegroups.com"
 ],
 "role":"roles/analyticshub.subscriber"
}

  3. 如要設定資料交換政策，請使用 projects.locations.dataExchanges.setIamPolicy 方法。在要求主體中，提供上一個步驟中更新的 IAM 政策：

    POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:setIamPolicy

建立 BigQuery 共用管理員

如要委派資料交換管理權，請在專案或資料交換層級授予使用者 Analytics Hub 管理員角色 (roles/analyticshub.admin)，建立資料交換管理員。

公開資料交換庫

資料交換預設為私密。只有可存取交換庫的使用者或群組，才能查看或訂閱交換庫的刊登內容。您可以將資料交換設為公開，讓Google Cloud 使用者 (allAuthenticatedUsers) 探索及訂閱清單。

如要公開資料交換庫，請按照下列步驟操作：

  1. 如要讓 allAuthenticatedUsers 查看商家資訊，請在資料交換層級授予 Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。

  2. 如要允許allAuthenticatedUsers 訂閱商家資訊， 請在資料交換層級授予Analytics Hub 訂閱者角色 (roles/analyticshub.subscriber)。

  3. 建立或更新資料交換庫時，請點選「公開可探索性」切換鈕，將其設為開啟。

刪除資料交換

刪除資料交換庫時，也會一併刪除交換庫中的所有產品資訊。共用和連結的資料集不會刪除。刪除專案不會自動刪除資料交換，因此您必須先刪除所有資料交換，才能關閉專案。 資料交換刪除後即無法復原。

刪除資料交換前，請根據資料交換設定完成下列必要條件：

如要刪除資料交換庫，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Sharing (Analytics Hub)」頁面。

    前往「共用」(舊稱 Analytics Hub)

  2. 在資料交換清單中，選取要刪除的資料交換。

  3. 點按「Details」(詳細資料) 分頁標籤。

  4. 按一下「刪除兌換項目」。

  5. 在「Delete exchange?」(刪除交易？) 對話方塊中輸入 delete，確認刪除。

  6. 如要永久刪除資料交換，請按一下「刪除」。

API

如要刪除資料交換，請使用 projects.locations.dataExchanges.delete 方法：

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID

更改下列內容：

  • PROJECT_ID：包含資料交換的專案 ID。
  • LOCATION：資料交換庫的位置。如要進一步瞭解支援 BigQuery 分享功能的地區，請參閱支援的地區。
  • DATAEXCHANGE_ID：資料交換庫的 ID。

如要進一步瞭解如何使用 API 對資料交易所執行工作，請參閱 projects.locations.dataExchanges 方法。

後續步驟