查看及訂閱清單

Analytics Hub 訂閱者可以查看及訂閱自己有權存取的資訊清單。訂閱商家資訊會在專案中建立連結資料集。

必要的角色

如要取得使用產品資訊所需的權限，請要求管理員在訂閱者專案中授予您下列身分與存取權管理 (IAM) 角色：

如要進一步瞭解如何授予角色，請參閱「管理存取權」。

這些預先定義的角色包含執行本文件中任務所需的權限。如要查看建立及查詢資料集所需的確切權限，請展開「必要權限」部分：

所需權限

  • 建立新資料集：bigquery.datasets.create 或 bigquery.datasets.*，以便對資料集執行其他動作。
  • 查詢資料集：bigquery.jobs.create 或 bigquery.jobs.*，可對工作執行其他動作。

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

探索商家資訊

如要查看公開和私人房源資訊，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中，前往「Sharing (Analytics Hub)」(分享 (數據分析中心) 頁面。

    前往「分享」(Analytics Hub)

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

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

  4. 在「篩選器」部分，你可以根據下列欄位篩選產品資訊：

    • 資訊清單：選取要查看私人資訊清單、公開資訊清單，或是貴機構內的資訊清單。

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

    • 位置：選取位置。詳情請參閱「支援的區域」。

    • 供應商：選取資料供應商。部分資料供應商會要求您申請存取權，才能使用其商業資料集。提出存取權要求後，資料供應商會與您聯絡，分享資料集。

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

訂閱產品資訊

訂閱資訊清單後，您可以在專案中建立連結資料集，藉此取得資訊清單中資料的唯讀存取權。

如要訂閱商家資訊，請按照下列步驟操作：

主控台

  1. 如要查看您有權存取的產品資訊清單，請按照「探索產品資訊」中的步驟操作。

  2. 瀏覽商家資訊，然後按一下要訂閱的商家資訊。畫面上會顯示包含商家詳細資料的對話方塊。您也可以在這個對話方塊中查看供應商是否已啟用訂閱者電子郵件記錄功能。

  3. 如果您無法訂閱某個資訊清單 (例如參照商業資料集的資訊清單)，請按一下「要求存取權」或「透過市集購買」。如果您點選可訂閱的資料集，請按一下「訂閱」，開啟「建立連結資料集」對話方塊。

  4. 如果專案未啟用 Analytics Hub API，系統會顯示錯誤訊息，並附上啟用 API 的連結。按一下「啟用 Analytics Hub API」。

  5. 在「建立已連結的資料集」對話方塊中，指定下列詳細資料：

    • 專案：指定要新增資料集的專案名稱。
    • 連結的資料集名稱：指定連結資料集的名稱。

  6. 如要儲存變更，請按一下「儲存」。已連結的資料集會列在專案中。

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。

在要求主體中，指定要建立連結資料集的資料集。如果要求成功，回應主體會包含 subscription 物件。如果您已為資料交換或清單啟用訂閱者電子郵件記錄功能 (預覽)，訂閱回應就會包含 log_linked_dataset_query_user_email: true。

查看已連結的資料集

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

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

主控台

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

    前往 BigQuery

  2. 在「Explorer」面板中，按一下包含已連結資料集的專案名稱。

或者，您也可以使用 Data Catalog (已淘汰) 或 Dataplex Universal Catalog 搜尋及查看已連結的資料集。如要比對所有共用連結的資料集，請使用 type=dataset.linked 預設詞。詳情請參閱「Data Catalog 搜尋語法」或「Dataplex Universal Catalog 搜尋語法」。

Cloud Shell

執行下列指令：

PROJECT=<your 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 資料表相同。

更新已連結的資料集

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

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

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

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

    前往 BigQuery

  2. 在「Explorer」面板中，按一下專案名稱，然後點選已連結的資料集。

  3. 展開 「動作」選項，然後按一下「開啟」。

  4. 在「詳細資料」面板中，按一下 「編輯詳情」，然後指定下列詳細資料：

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

    2. 如要啟用排序功能，請展開「進階選項」部分，然後按照下列步驟操作：

      1. 選取「啟用預設定序」。
      2. 在「預設排序」清單中選取所需選項。

  5. 按一下 [儲存]。

查看資料表中繼資料

如要查看基礎資料表中繼資料，請查詢 INFORMATION_SCHEMA.TABLES 檢視：

SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`

請將 LINKED-DATASET 替換為已連結資料集的名稱。

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

如要取消訂閱資料集，您必須刪除連結的資料集。

刪除連結的資料集不會刪除來源資料集。刪除連結資料集後，您無法擷取該資料集，但可以重新訂閱清單，然後將資料集新增至專案，藉此重新建立資料集。

如果Analytics Hub 發布者移除您的訂閱項目，您的已連結的資料集就會從共用資料集中取消連結。您可以刪除未連結的資料集，因為您無法查詢未連結的資料集。

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

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

    前往 BigQuery

  2. 在「Explorer」面板中，按一下專案名稱，然後點選已連結的資料集。

  3. 展開 「Actions」 選項，然後按一下「Delete」。

  4. 在「Delete linked dataset?」對話方塊中，輸入「delete」來確認刪除。

  5. 點選「刪除」。

後續步驟