查看及訂閱清單和資料交換

在 BigQuery sharing (舊稱 Analytics Hub) 中，您可以探索及訂閱項目和資料交換，直接在 BigQuery 中查詢共用資料，不必複製資料或支付儲存空間費用。訂閱後，系統會在專案中建立唯讀連結資料集，方便您與現有資源一起分析共用資料表和檢視。

必要的角色

如要取得使用房源所需的權限，請要求管理員授予下列 IAM 角色：

• 探索產品資訊和資料交換： 訂閱者專案的 Analytics Hub 檢視者 (roles/analyticshub.viewer)
• 訂閱房源：
  • BigQuery 使用者 (roles/bigquery.user) 訂閱者專案
  • Analytics Hub 訂閱者 (roles/analyticshub.subscriber) 發布者的項目、交易所或專案
• 訂閱資料交換庫：
  • BigQuery 使用者 (roles/bigquery.user) 訂閱者專案
  • Analytics Hub 訂閱者 (roles/analyticshub.subscriber) 資料無塵室
  • Analytics Hub 訂閱項目擁有者角色 (roles/analyticshub.subscriptionOwner) 目標專案
• 查看及查詢連結的資料集： 訂閱者專案中的 BigQuery 資料檢視者 (roles/bigquery.dataViewer)
• 查看資料表的中繼資料： 訂閱者專案的 BigQuery 資料檢視者 (roles/bigquery.dataViewer)
• 更新連結的資料集： 訂閱者專案的「BigQuery 資料擁有者」 (roles/bigquery.dataOwner)
• 刪除連結的資料集： 訂閱者專案的 BigQuery 管理員 (roles/bigquery.admin)

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

這些預先定義的角色具備使用房源所需的權限。如要查看確切的必要權限，請展開「Required permissions」(必要權限) 部分：

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

探索商家資訊

如要探索公開和私人房源，請按照下列步驟操作：

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

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

2. 按一下「搜尋房源」。系統會顯示對話方塊，內含可存取的商家資訊。

3. 如要依名稱或說明篩選房源，請在「搜尋房源」欄位中輸入文字。

4. 在「篩選器」部分，使用下列欄位篩選房源：

   • 產品資訊：選取要查看私人產品資訊、公開產品資訊，還是貴機構內的產品資訊。

   • 類別：選取一或多個類別。

   • 位置：選取位置。你只能依資料交換位置搜尋。詳情請參閱「支援的區域」。

   • 供應商：選取資料供應商。部分資料供應商會要求您申請存取他們的商業資料集。要求存取權後，資料供應商會與您聯絡，分享他們的資料集。

5. 瀏覽篩選後的商家資訊。

探索資料交換庫

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

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

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

2. 按一下「搜尋房源」。畫面上會顯示對話方塊，內含可訂閱的清單和資料交換。

3. 如要依名稱或說明篩選資料交易所，請在「搜尋商家資訊」欄位中輸入文字。

4. 在「篩選器」部分，使用下列欄位篩選資料無塵室交易：

   • 房源：選取「資料無塵室」核取方塊，即可查看共用的資料無塵室。

   • 類別：選取一或多個類別。

   • 位置：選取位置。你只能依資料交換位置搜尋。詳情請參閱「支援的區域」。

5. 瀏覽經過篩選的資料無塵室。

訂閱產品資訊

訂閱產品資訊後，您可以在專案中建立連結的資料集，取得該產品資訊中資料的唯讀存取權。

如要訂閱房源，請按照下列步驟操作：

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:subscribe

{
"destinationDataset": {
  "datasetReference": {
    "projectId": "SUBSCRIBER_PROJECT_ID",
    "datasetId": "LINKED_DATASET_ID"
  },
  "location": "PRIMARY_REGION"
}
}

訂閱資料交換

訂閱資料交換庫後，您可以在專案中建立連結的資料集，取得資料交換庫中資料的唯讀存取權。

如要訂閱資料無塵室交換庫，請按照下列步驟操作：

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

{
"destination": "projects/SUBSCRIBER_PROJECT_ID/locations/LOCATION",
"subscription": "SUBSCRIPTION_ID",
"destinationDataset": {
  "datasetReference": {
    "projectId": "SUBSCRIBER_PROJECT_ID",
    "datasetId": "LINKED_DATASET_ID"
  },
  "location": "PRIMARY_REGION"
}
}

查看連結的資料集

連結的資料集會與其他資料集一起顯示在Cloud de Confiance 控制台中。

如要在專案中查看已連結的資料集，請按照下列步驟操作：

PROJECT=PROJECT_ID \
for dataset in $(bq ls --project_id $PROJECT | tail +3); do [ "$(bq show -d --project_id $PROJECT $dataset | egrep LINKED)" ] && echo $dataset; done

查詢連結的資料集

您可以查詢任何其他 BigQuery 資料表，也可以查詢連結資料集中的資料表和檢視畫面。

如要查詢連結資料集中的資料表，請執行 SELECT 查詢，並參照專案 ID、連結資料集 ID 和資料表名稱：

SELECT * FROM `PROJECT_ID`.`LINKED_DATASET_ID`.`TABLE_NAME`
LIMIT 10;

更改下列內容：

• PROJECT_ID：您的 Cloud de Confiance 專案 ID。
• LINKED_DATASET_ID：已連結資料集的 ID。
• TABLE_NAME：要查詢的資料表或檢視區塊名稱。

詳情請參閱「執行互動式查詢」。

更新連結的資料集

連結資料集中的資源為唯讀。您無法編輯連結資料集中的資源資料或中繼資料，也無法為個別資源指定權限。

您只能更新連結資料集的說明和標籤。 連結資料集的變更不會影響來源或共用資料集。

如要更新已連結資料集的說明和標籤，請按照下列步驟操作：

1. 前往 Cloud de Confiance 控制台的「BigQuery」頁面。

   前往「BigQuery」

2. 在「Explorer」窗格中，按一下 explore「Explorer」：

   

3. 在「Explorer」窗格中展開專案名稱，點選「Datasets」(資料集)，然後點選連結的資料集名稱開啟該資料集。

4. 在詳細資料窗格中，按一下「編輯詳細資料」，然後設定下列選項：mode_edit

   1. 如要新增標籤，請參閱在資料集中加入標籤。

   2. 如要啟用對照，請展開「進階選項」，然後按照下列步驟操作：

      1. 選取「啟用預設定序」。
      2. 在「Default collation」(預設排序規則) 清單中，選取所需選項。

5. 點按「儲存」，儲存變更。

查看資料表中繼資料

如要查看連結資料表的資料表中繼資料，請查詢 INFORMATION_SCHEMA.TABLES 檢視區塊：

SELECT * FROM `LINKED_DATASET_ID`.INFORMATION_SCHEMA.TABLES;

將 LINKED_DATASET_ID 替換為已連結資料集的 ID。

取消訂閱或刪除連結的資料集

如要取消訂閱資料集，請刪除連結的資料集。刪除連結的資料集不會刪除來源資料集。

連結的資料集一經刪除即無法復原。不過，您隨時可以再次訂閱房源，重新建立已刪除的連結資料集。

如果發布商移除你的訂閱項目，你的連結資料集就會與共用資料集取消連結。由於這是發布者對訂閱者擁有的資源發起的動作，連結的資料集會保留在您的專案中，但處於取消連結狀態。如要移除未連結的資料集，請將其刪除。

如要刪除連結的資料集，請按照下列步驟操作：

1. 前往 Cloud de Confiance 控制台的「BigQuery」頁面。

   前往「BigQuery」

2. 在「Explorer」窗格中，按一下 explore「Explorer」：

   

3. 在「Explorer」窗格中展開專案名稱，點選「Datasets」(資料集)，然後點選連結的資料集名稱開啟該資料集。

4. 點選「刪除」。

5. 在「要刪除連結的資料集嗎？」對話方塊中，輸入 delete 確認刪除。

6. 點選「刪除」。

後續步驟

• 瞭解 BigQuery 共用。
• 瞭解如何管理房源資訊。
• 瞭解如何管理資料交換。
• 瞭解如何查看 BigQuery 共用稽核記錄。