查看及訂閱清單和資料交換
本文說明如何在 BigQuery sharing (舊稱 Analytics Hub) 中查看及訂閱項目和資料交換。BigQuery 共用訂閱者可以查看並訂閱自己有權存取的清單和資料交換。在 BigQuery sharing 中訂閱清單或資料交換，會在 Google Cloud 專案中建立連結的資料集。
必要的角色
如要取得使用目錄所需的權限，請要求 BigQuery 共用管理員在 BigQuery 共用訂閱者專案中，授予您下列身分與存取權管理 (IAM) 角色：
- 探索房源：
Analytics Hub 檢視者 (
roles/analyticshub.viewer) - 探索資料交換：
Analytics Hub 檢視者 (
roles/analyticshub.viewer) 訂閱項目： BigQuery 使用者 (
roles/bigquery.user)- 如要訂閱項目，您也必須請 BigQuery sharing 項目發布端授予您項目、交換庫或專案的 Analytics Hub 訂閱者角色 (
roles/analyticshub.subscriber)，視您的用途最適合的範圍而定。
- 如要訂閱項目，您也必須請 BigQuery sharing 項目發布端授予您項目、交換庫或專案的 Analytics Hub 訂閱者角色 (
訂閱資料交易所： BigQuery 使用者 (
roles/bigquery.user)查看已連結的資料集： BigQuery 資料檢視者 (
roles/bigquery.dataViewer)查詢已連結的資料集： BigQuery 資料檢視者 (
roles/bigquery.dataViewer)更新已連結的資料集： BigQuery 資料擁有者 (
roles/bigquery.dataOwner)查看資料表的中繼資料： BigQuery 資料檢視者 (
roles/bigquery.dataViewer)刪除已連結的資料集： BigQuery 管理員 (
roles/bigquery.admin)
如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。
這些預先定義的角色具備執行本文所述工作所需的權限。如要查看建立及查詢資料集所需的確切權限，請展開「Required permissions」(必要權限) 部分：
所需權限
- 建立新資料集：按一下
bigquery.datasets.create或bigquery.datasets.*，對資料集執行其他動作。 - 查詢資料集：按一下
bigquery.jobs.create或bigquery.jobs.*，對工作執行其他動作。
探索商家資訊
如要探索公開和私人房源，請按照下列步驟操作：
前往 Google Cloud 控制台的「Sharing (Analytics Hub)」頁面。
按一下「搜尋房源」。系統會顯示對話方塊，內含可存取的房源。
如要依名稱或說明篩選房源，請在「搜尋房源」欄位中輸入房源名稱或說明。
在「篩選器」部分，你可以根據下列欄位篩選房源：
瀏覽篩選後的商家資訊。
探索資料交換庫
如要探索資料交換庫，請按照下列步驟操作：
前往 Google Cloud 控制台的「Sharing (Analytics Hub)」頁面。
按一下「搜尋房源」。系統會顯示對話方塊，內含可訂閱的清單和資料交換。
如要依名稱或說明篩選資料無塵室交換，請在「搜尋清單」欄位中輸入資料無塵室交換的名稱或說明。
在「篩選器」部分，您可以根據下列欄位篩選資料無塵室交換：
清單：選取「資料無塵室」核取方塊，即可查看與您共用的資料無塵室。
類別：選取一或多個類別。
位置：選取位置。你只能依資料交換位置搜尋。詳情請參閱「支援的區域」。
瀏覽篩選後的資料無塵室。
訂閱產品資訊
訂閱產品資訊後，您可以在專案中建立連結的資料集，唯讀存取權產品資訊中的資料。
如要訂閱房源，請按照下列步驟操作：
控制台
如要查看可存取的房源清單，請按照「探索房源」一文中的步驟操作。
瀏覽清單，然後按一下要訂閱的清單。系統會顯示含有房源詳細資料的對話方塊。如果供應商已啟用訂閱者電子郵件記錄功能，系統就會顯示對話方塊。在「其他詳細資料」部分，你可以查看供應商提供房源資訊的區域。
如果無法訂閱參照商業資料集的項目等，請按一下「要求存取權」或「透過 Marketplace 購買」。如果點選可訂閱的資料集，請按一下「訂閱」，開啟「建立連結資料集」對話方塊。
如果專案未啟用 Analytics Hub API，系統會顯示錯誤訊息，並提供啟用 API 的連結。按一下「啟用 Analytics Hub API」。
在「建立連結的資料集」對話方塊中，指定下列詳細資料：
- 專案：指定要新增資料集的專案名稱。
- 連結的資料集名稱：指定連結的資料集名稱。
主要區域：選取要建立連結資料集的區域。
選用：副本區域： 選取要建立其他連結資料集次要副本的區域。您可以選擇將連結的資料集與其他資料放在同一區域，以盡量減少輸出資料，並簡化跨資料集聯結。如要建立連結的資料集副本，您必須具備連結資料集的
bigquery.datasets.update權限。
如要儲存變更，請按一下「儲存」。連結的資料集會列在專案中。
API
請使用 projects.locations.dataExchanges.listings.subscribe 方法。
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:subscribe
更改下列內容：
PROJECT_ID：您要訂閱的房源專案 ID。LOCATION：要訂閱的商家資訊位置。DATAEXCHANGE_ID：要訂閱的房源資料廣告交易平台 ID。LISTING_ID：要訂閱的房源 ID。
在要求主體中，指定要建立連結資料集的資料集。
如要建立訂閱項目，並在多個區域提供連結的資料集副本，請使用要求主體中的 location 欄位，指定連結資料集的主要區域。如要在次要區域建立連結資料集副本，可以視需要使用要求主體中的 destinationDataset.replica_locations 欄位，列出所有選取的次要副本區域。確認 location 屬性和 destinationDataset.replica_locations 欄位中指定的區域，是相關聯產品資訊可用的區域。
如果要求成功，回應主體會包含訂閱物件。
如果您使用 logLinkedDatasetQueryUserEmail 欄位為資料交換庫或刊登啟用訂閱者電子郵件記錄功能，訂閱回應會包含 log_linked_dataset_query_user_email: true。記錄的資料會顯示在 INFORMATION_SCHEMA.SHARED_DATASET_USAGE 檢視畫面的 job_principal_subject 欄位中。
如果啟用預存程序共用功能 (預覽)，清單回應會包含 stored_procedure_config: true。
訂閱資料交換
訂閱資料交換庫後，您可以在專案中建立連結的資料集，取得資料無塵室交換庫中的資料唯讀存取權。
如要訂閱資料無塵室交換庫，請按照下列步驟操作：
控制台
如要查看您有權存取的資料無塵室交換庫清單，請按照「探索資料交換庫」一文中的步驟操作。
瀏覽資料無塵室交換庫，然後按一下要訂閱的資料無塵室交換庫。系統會顯示含有資料無塵室交易詳細資料的對話方塊。
如果點選可訂閱的資料無塵室交換庫，請按一下訂閱，開啟將資料無塵室新增至專案對話方塊。
如果專案未啟用 Analytics Hub API，系統會顯示錯誤訊息，並提供啟用 API 的連結。按一下「啟用 Analytics Hub API」。
在「將資料無塵室新增至專案」對話方塊中，指定下列詳細資料：
- 目的地：指定要新增資料集的專案名稱。
如要儲存變更，請按一下「儲存」。連結的資料集會列在專案中。
API
請使用 projects.locations.dataExchanges.subscribe 方法。
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:subscribe
更改下列內容：
PROJECT_ID：您要訂閱的資料交換庫專案 ID。LOCATION：要訂閱的資料交換庫位置。DATAEXCHANGE_ID：要訂閱的資料交易所 ID。
在要求主體中，指定要建立連結資料集的資料集。
如果要求成功，回應主體會包含訂閱物件。如果您已為資料交換庫啟用訂閱者電子郵件記錄功能，訂閱回應會包含 log_linked_dataset_query_user_email: true。
查看連結的資料集
連結的資料集會與其他資料集一起顯示在Google Cloud 控制台中。
如要查看專案中已連結的資料集，請按照下列步驟操作：
控制台
前往 Google Cloud 控制台的「BigQuery」頁面。
在「傳統版 Explorer」窗格中，點選「category」：
如果沒有看到「傳統檔案總管」窗格，請按一下 「Expand left pane」(展開左側窗格)，開啟窗格。
在「傳統版 Explorer」窗格中，按一下包含已連結資料集的專案名稱。
或者，您也可以使用
Data Catalog (已淘汰)
或
Knowledge Catalog
搜尋及查看連結的資料集。如要比對所有 BigQuery sharing 連結資料集，請使用 type=dataset.linked 述詞。詳情請參閱「Data Catalog 搜尋語法」或「Knowledge Catalog 搜尋語法」。
Cloud Shell
執行下列指令：
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
將 PROJECT_ID 替換為 Google Cloud 專案 ID。
查詢連結的資料集
您可以查詢任何其他 BigQuery 資料表，方法與查詢連結資料集中的資料表和檢視相同。
更新連結的資料集
連結資料集中的資源為唯讀。您無法編輯連結資料集中的資源資料或中繼資料，也無法為個別資源指定權限。
您只能更新連結資料集的說明和標籤。 連結資料集的變更不會影響來源或共用資料集。
如要更新已連結資料集的說明和標籤，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，按一下 「Explorer」：
在「Explorer」窗格中展開專案名稱，點選「Datasets」(資料集)，然後點選連結資料集的名稱開啟該資料集。
在詳細資料窗格中，按一下「編輯詳細資料」，然後指定下列詳細資料：
按一下 [儲存]。
查看資料表中繼資料
如要查看基礎資料表中繼資料，請查詢 INFORMATION_SCHEMA.TABLES 檢視區塊：
SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`
將 LINKED-DATASET 替換為已連結資料集的名稱。
取消訂閱或刪除連結的資料集
如要取消訂閱資料集，請刪除連結的資料集。刪除連結的資料集不會刪除來源資料集。
連結的資料集一經刪除即無法復原。不過，您可以再次訂閱產品資訊，並將資料集和從 Google Cloud Marketplace 整合式產品資訊建立的連結資料集新增至專案，重新建立已刪除的連結資料集。
如果 BigQuery sharing 發布者移除您的訂閱項目，則連結的資料集會與共用資料集取消連結。由於這是發布者對訂閱者擁有的資源發起的動作，因此連結的資料集會保留在 BigQuery sharing 訂閱者的專案中，但處於未連結狀態。如要移除未連結的資料集，請將其刪除。
如要刪除連結的資料集，請按照下列步驟操作：
前往 Google Cloud 控制台的「BigQuery」頁面。
在「Explorer」窗格中，按一下 「Explorer」：
在「Explorer」窗格中展開專案名稱，點選「Datasets」(資料集)，然後點選連結資料集的名稱開啟該資料集。
點選「刪除」。
在「Delete linked dataset?」(要刪除已連結的資料集嗎？) 對話方塊中輸入「delete」(刪除)，確認要刪除。
點選「刪除」。
後續步驟
- 瞭解 BigQuery 共用。
- 瞭解如何管理房源資訊。
- 瞭解如何管理資料交換。
- 瞭解 BigQuery sharing 稽核記錄。