本頁面由 Cloud Translation API 翻譯而成。

管理清單

BigQuery sharing 發布者可以在 BigQuery sharing (舊稱 Analytics Hub) 中執行下列操作：

在您有發布權限的資料交易平台中建立房源資訊。
更新、刪除、分享及查看房源的使用指標。
管理清單的不同 BigQuery 共用角色，例如清單管理員、訂閱者和檢視者。
查看所有訂閱你房源的訂閱者。
監控房源使用情況。
從房源資訊中移除訂閱者。

清單是發布者在資料交換庫中列出的共用資料集參照資訊。根據為商家資訊設定的身分與存取權管理 (IAM) 政策，以及包含商家資訊的資料交換類型，商家資訊可分為下列兩種：

公開資訊。Google Cloud 使用者 (allAuthenticatedUsers) 可以探索及訂閱。公開資料交換中的清單是公開清單。這些清單可以是免費公開資料集或商用資料集的參照。如果資訊是商業資料集，BigQuery 共用訂閱者可以直接向資料供應商要求存取資訊，也可以瀏覽及購買整合 Google Cloud Marketplace 的商業資訊。
私人房源。直接與個人或群組共用。舉例來說，私有房源可以參照您與機構內其他內部團隊共用的行銷指標資料集。即使允許allAuthenticatedUsers訂閱清單，清單仍會維持私密狀態，不會顯示在 BigQuery 共用頁面上的公開清單中。如要與使用者分享這類房源資訊，請將房源網址提供給他們。如要讓私人房源可供搜尋，請公開你的房源。

事前準備

如要開始使用 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 角色：

服務使用情形管理員 (roles/serviceusage.serviceUsageAdmin)

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

控制台

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

啟用 Analytics Hub API

gcloud

執行 gcloud services enable 指令：

gcloud services enable analyticshub.googleapis.com

必要的角色

如要管理項目和訂閱項目，您必須具備下列其中一個 BigQuery 共用身分與存取權管理 (IAM) 角色：

Analytics Hub 發布者角色 (roles/analyticshub.publisher)，可讓您建立、更新、刪除及設定項目 IAM 政策。
Analytics Hub 清單管理員角色 (roles/analyticshub.listingAdmin)，可讓您更新、刪除及設定清單的 IAM 政策。
Analytics Hub 管理員角色 (roles/analyticshub.admin)，可讓您在資料交換中建立、更新、刪除及設定所有刊登項目的 IAM 政策。

詳情請參閱「BigQuery 共用身分與存取權管理角色」。如要瞭解如何將這些角色授予其他使用者，請參閱「建立房源管理員」。

此外，如要建立產品資訊，您也必須具備要建立產品資訊的資料集 bigquery.datasets.get 和 bigquery.datasets.update 權限。下列 BigQuery 預先定義角色包含 bigquery.datasets.update 權限：

BigQuery 資料擁有者 (roles/bigquery.dataOwner)
BigQuery 管理員 (roles/bigquery.admin)

如要查看您有權存取的機構內所有專案的資料交換，您必須具備 resourcemanager.organizations.get 權限。沒有包含這項權限的 BigQuery 預先定義角色，因此您需要使用 IAM 自訂角色。

查看資料交換庫

如要查看貴機構中您有權存取的資料交換庫清單，請參閱「查看資料交換庫」。如果資料交換庫位於其他機構，BigQuery sharing 管理員必須與您分享該資料交換庫的連結。

建立商家資訊

清單是 BigQuery 共用發布端在資料交換庫中列出的共用資料集參照資訊。

如要建立房源資訊，請按照下列步驟操作：

控制台

前往「Sharing (Analytics Hub)」頁面。

前往「共用」(Analytics Hub)

畫面上會顯示您可存取的所有資料交換。
按一下要建立房源資訊的資料交易所名稱。
按一下「建立商店資訊」。
在「設定資料」部分，選取「資源類型」選單中的「BigQuery 資料集」或「Pub/Sub 主題」。
- 如果選取「BigQuery 資料集」，請按照下列步驟操作：
  1. 在「共用資料集」選單中，選取現有資料集，或按一下「建立資料集」建立新資料集。選取要在資料交換中列出的資料集。資料集必須與資料交易所處的區域相同。建立房源資訊後，就無法更新這個欄位。BigQuery 共用訂閱者查看連結資料集的繼資料時，系統會傳回來源資料集名稱和包含該資料集的專案 ID。
  2. 選用：如要讓訂閱者在資訊中分享 SQL 預存程序，請選取「允許共用預存程序」(預覽版)。
  3. 展開「區域資料可用性」選單 (預覽)，即可在其他區域提供共用資料集。選單會顯示有資料集副本的區域，並標示「可供使用」。設定多個區域的項目之前，請先確認您已在共用資料集上啟用跨區域資料集複製，因為您只能選取已啟用跨區域資料集複製的區域。其他地區則標示為「不適用」。如未選取其他區域，項目會預設使用共用資料集的主要區域，標示為「供應商主要區域」。
  4. 在「資料輸出控制項」中，選取適當的資料輸出選項。
    - 如要對共用資料集套用資料輸出限制，但不要對共用資料集的查詢結果套用限制，請選取「停用共用資料的複製和匯出功能」。
    - 如要對共用資料集和共用資料集的查詢結果套用資料輸出限制，請選取「禁止複製及匯出查詢結果」，系統也會自動設定「禁止複製及匯出共用資料」。
    - 如要對共用資料集套用資料 API 複製和匯出輸出限制，請選取「停用透過 API 複製及匯出資料表的功能」，系統會自動一併設定「停用共用資料複製與匯出功能」。
    如要進一步瞭解資料輸出控管 (包括限制)，請參閱「資料輸出選項 (僅限 BigQuery 共用資料集)」。
- 如果選取「Pub/Sub Topic」(Pub/Sub 主題)，則可以在「Shared topic」(共用主題) 選單中選取現有的 Pub/Sub 主題，或按一下「Create a topic」(建立主題) 建立新主題。
在「清單詳細資料」部分的「顯示名稱」中，輸入清單名稱。
輸入下列選填詳細資料：
- 類別：選取最多兩個最能代表商家檔案的類別。BigQuery sharing 訂閱者可以根據這些類別篩選商家資訊。
- 資料親和性：如果您使用 Pub/Sub 主題，這是指 BigQuery 共用發布者用於發布資料的區域。這項資訊有助於 BigQuery 共用訂閱者從相同區域讀取資料，盡量減少或避免 Pub/Sub 網路輸出費用。如要進一步瞭解輸出費用，請參閱「資料移轉費用」。
- 圖示：應用程式資訊的圖示。支援 PNG 和 JPEG 檔案格式。圖示的檔案大小不得超過 512 KiB，且尺寸不得超過 512 x 512 像素。
- 說明：簡要說明房源。訂閱者可以根據說明搜尋房源。
- 公開探索：在 BigQuery 共用目錄中啟用公開探索功能，啟用這個選項後，請授予 allUsers 或 allAuthenticatedUsers「Analytics Hub 檢視者」角色 (roles/analyticshub.viewer)。詳情請參閱「為商家資訊授予角色」。如果交易所已公開，則會自動沿用上架權限，不需採取進一步行動。
  
  由於權限繼承的關係，公開可探索的交易平台無法有私人刊登項目，但私人交易平台可以有公開刊登項目。如要建立公開資料集，資料集所在的專案必須有相關聯的機構和帳單帳戶。如果您要建立整合 Cloud Marketplace 的商業產品資訊，建議將產品資訊設為公開，方便使用者搜尋。
- 訂閱端電子郵件記錄：開啟記錄功能，即可記錄所有在連結資料集上執行工作和查詢的使用者主體 ID。啟用這項選項後，這份清單日後的所有訂閱項目都會啟用訂閱者電子郵件記錄功能。記錄的資料會顯示在INFORMATION_SCHEMA.SHARED_DATASET_USAGE 檢視畫面的 job_principal_subject 欄位中。
  
  注意： 啟用並儲存電子郵件記錄功能後，就無法再編輯這項設定。如要停用電子郵件記錄功能，請刪除清單項目，然後重新建立，但不要點按「訂閱者電子郵件記錄」切換按鈕。
- 說明文件 > Markdown：其他資訊，例如任何相關說明文件的連結，以及可協助 BigQuery 共用訂閱者使用主題的任何其他資訊。
在「商店資訊聯絡資料」部分，輸入下列選填詳細資料：
- 主要聯絡人：輸入商家資訊主要聯絡人的電子郵件 ID 或網址。
- 要求存取權聯絡人：輸入電子郵件 ID 或 BigQuery 共用訂閱者的聯絡表單網址。
- 供應商：展開「供應商」部分，並在下列欄位中指定詳細資料：
  - 供應商名稱：主題供應商的名稱。
  - 供應商主要聯絡人：主題供應商主要聯絡人的電子郵件 ID 或網址。
  訂閱者可以根據資料供應商篩選清單。
- 發布商：展開「發布商」部分，並在下列欄位中指定詳細資料：
  - 發布者名稱：建立清單的 BigQuery 共用發布者名稱。
  - 發布者主要聯絡人：主題發布者主要聯絡人的電子郵件 ID 或網址。
查看「商家資訊預覽」部分。
按一下「發布」。

API

請使用 projects.locations.dataExchanges.listings.create 方法。

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings?listingId=LISTING_ID

更改下列內容：

PROJECT_ID：包含資料交易所的專案 ID，您要在該交易所中建立商家資訊。
LOCATION：資料交換的位置。如要進一步瞭解支援 BigQuery 共用的位置，請參閱「支援的區域」。
DATAEXCHANGE_ID：資料交換 ID。
LISTING_ID：房源 ID。

在要求主體中，提供房源詳細資料。

如要為多個區域建立房源資訊 (預覽)，請在要求主體的 bigqueryDataset.replicaLocations 欄位中指定其他區域。設定多個區域的商家資訊前，請先確認已在共用資料集上啟用跨區域資料集複製。您只能選取已啟用跨區域資料集複製功能的區域。如果未填寫這個選填欄位，系統會使用共用資料集的主要區域建立商家資訊。

如果要求成功，回應主體會包含房源詳細資料。如果使用 logLinkedDatasetQueryUserEmail 欄位啟用訂閱者電子郵件記錄功能，清單回應會包含 log_linked_dataset_query_user_email: true。記錄的資料會顯示在 INFORMATION_SCHEMA.SHARED_DATASET_USAGE 檢視區塊的 job_principal_subject 欄位中。

如要進一步瞭解如何使用 API 對房源執行工作，請參閱 projects.locations.dataExchanges.listings 方法。

從資料集建立房源資訊

你也可以透過資料集建立房源資訊，方法如下：

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

前往 BigQuery
按一下資料集即可查看詳細資料。
依序按一下「分享」>「發布為房源資訊」。

「建立房源資訊」對話方塊隨即開啟。
選取要發布這項清單的資料交換庫。資料交易所必須與資料集位於相同區域。如要進一步瞭解如何建立資料交換，請參閱建立交換並設定權限。
在「共用資料集」選單中，選取現有資料集，或按一下「建立資料集」建立新資料集。選取要在資料交換中列出的資料集。資料集必須與資料交易所處的區域相同。房源建立後，就無法更新這個欄位。

當 BigQuery 共用訂閱者查看連結資料集的中繼資料時，系統會傳回來源資料集名稱和包含該資料集的專案 ID。
選用：如要讓訂閱者在資訊中分享 SQL 預存程序，請選取「允許共用預存程序」(預覽版)。
展開「區域資料可用性」選單 (預覽)，即可在其他區域提供共用資料集。選單會顯示有資料集副本的區域，並標示「可供使用」。設定多個區域的項目之前，請先確認您已在共用資料集上啟用跨區域資料集複製，因為您只能選取已啟用跨區域資料集複製的區域。其他地區則標示為「不適用」。如未選取其他區域，預設會使用共用資料集區域，標示為「供應商主要區域」。
在「資料外流控制項」中，選取適當的資料外流選項。
- 如要對共用資料集套用資料輸出限制，但不要對共用資料集的查詢結果套用限制，請選取「停用共用資料複製與匯出功能」。
- 如要對共用資料集和共用資料集的查詢結果套用資料輸出限制，請選取「停用查詢結果複製與匯出功能」，系統也會自動設定「停用共用資料複製與匯出功能」。
- 如要對共用資料集套用資料 API 複製和匯出輸出限制，請選取「停用透過 API 複製及匯出資料表的功能」，系統也會自動設定「停用共用資料複製與匯出功能」。
如要進一步瞭解資料輸出控管 (包括限制)，請參閱「資料輸出選項 (僅限 BigQuery 共用資料集)」。
在「清單詳細資料」部分的「顯示名稱」中，輸入清單名稱。
輸入下列選填詳細資料：
- 類別：選取最多兩個最能代表商家檔案的類別。BigQuery sharing 訂閱者可以根據這些類別篩選商家資訊。
- 資料親和性：BigQuery 共用發布者用來發布資料的區域。BigQuery 共用訂閱者可利用這項資訊，從相同區域讀取資料，盡量減少或避免 Pub/Sub 網路輸出費用。如要進一步瞭解輸出費用，請參閱「資料移轉費用」。
- 圖示：應用程式資訊的圖示。支援 PNG 和 JPEG 檔案格式。圖示的檔案大小不得超過 512 KiB，且尺寸不得超過 512 x 512 像素。
- 說明：簡要說明房源。 BigQuery sharing 訂閱者可以根據說明搜尋清單。
- 公開探索：在 BigQuery 共用目錄中啟用公開探索功能，啟用這個選項後，請授予 allUsers 或 allAuthenticatedUsers「Analytics Hub 檢視者」角色 (roles/analyticshub.viewer)。如需更多資訊，請參閱「授予房源角色」。如果交易所已公開，系統會自動沿用刊登權限，因此無須採取任何行動。
  
  由於權限繼承的關係，公開可探索的交易平台無法提供私人刊登，但私人交易平台可以提供公開刊登。如要建立公開資料，資料目錄所在的專案必須有相關聯的機構和帳單帳戶。如果您要建立整合 Cloud Marketplace 的商業產品資訊，建議將產品資訊設為公開，方便使用者搜尋。
- 記錄訂閱端電子郵件：開啟這項功能後，系統會記錄所有未來訂閱項目的訂閱者主體 ID，方便您掌握訂閱者在清單項目連結資料集上執行的工作和查詢。啟用這個選項後，只有新建立的訂閱項目會記錄主體 ID。記錄的資料會顯示在 INFORMATION_SCHEMA.SHARED_DATASET_USAGE 檢視區塊的 job_principal_subject 欄位中。
  
  注意： 啟用並儲存電子郵件記錄功能後，就無法再編輯這項設定。如要停用電子郵件記錄功能，請刪除清單項目並重新建立，但不要點按「訂閱者電子郵件記錄」切換按鈕。
- 說明文件 > Markdown：其他資訊，例如任何相關說明文件的連結，以及有助於訂閱者使用主題的任何其他資訊。
在「商店資訊聯絡資料」部分，輸入下列選填詳細資料：
- 主要聯絡人：輸入商家資訊主要聯絡人的電子郵件 ID 或網址。
- 要求存取聯絡人：輸入電子郵件 ID 或訂閱者與您聯絡的申請表網址。
- 供應商：展開「供應商」部分，並在下列欄位中指定詳細資料：
  - 供應商名稱：主題供應商的名稱。
  - 供應商主要聯絡人：主題供應商主要聯絡人的電子郵件 ID 或網址。
  訂閱者可以根據資料供應商篩選清單。
- 發布商：展開「發布商」部分，並在下列欄位中指定詳細資料：
  - 發布者名稱：建立清單的 BigQuery 共用發布者名稱。
  - 發布者主要聯絡人：主題發布者主要聯絡人的電子郵件 ID 或網址。
查看「商家資訊預覽」部分。
按一下「發布」。

使用 BigQuery 資料集建立清單時，可以共用 SQL 預存程序。由於預存程序可以建立、捨棄及操控表格，也能叫用其他預存程序，因此需要額外授權。

訂閱者授權

訂閱清單後，系統可能不會直接執行連結的預存程序。為確保可存取連結的預存程序，訂閱者必須將連結的資料集名稱告知供應商，供應商才能授權連結供應商資源中的預存程序。此外，訂閱者必須授權連結的共用預存程序，並將 IAM 角色附加至擁有的資源，才能讀取及寫入這些資源。

供應商授權

供應商使用預存程序建立項目時，必須允許訂閱者透過連結的預存程序讀取及寫入資料表。如要確保這點，請按照下列步驟操作：

對於非讀取作業，供應商必須授權連結的共用預存程序，並將 IAM 角色附加至連結預存程序存取的任何供應商資源。
如果是讀取作業，供應商可以授權連結的共用預存程序 (位於訂閱者的連結資料集中)，或授權原始共用預存程序 (位於供應商的資料集中)，並將 IAM 角色附加至連結預存程序存取的任何供應商資源。

授予使用者商家資訊存取權

如要授權使用者存取私人項目，請為該項目設定個別使用者或群組的 IAM 政策。如果是商業用途的商店資訊，資料交換必須公開。公開資料交易所中的項目會顯示在所有Google Cloud 使用者 (allAuthenticatedUsers) 的 BigQuery sharing 中。如要讓使用者瀏覽及要求存取商業項目，您必須授予使用者 Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。如要讓使用者訂閱商業項目，您必須明確授予使用者 Analytics Hub 訂閱者角色 (roles/analyticshub.subscriber)。如果是與 Cloud Marketplace 整合的商業項目，系統會根據 Cloud Marketplace 訂單自動佈建 Analytics Hub 訂閱者角色。

如要讓所有人 (包括未使用 Google Cloud的使用者) 都能存取服務清單，請授予 allUsers Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。

如要授予使用者查看或訂閱房源的權限，請按照下列步驟操作：

控制台

前往「Sharing (Analytics Hub)」頁面。

前往「共用」(Analytics Hub)
按一下包含商家資訊的資料交易所名稱。
按一下要新增訂閱者的房源資訊。
按一下「設定權限」。
如要新增主體，請按一下「新增主體」。
在「New principals」(新增主體) 欄位中，根據房源類型新增下列詳細資料：
- 如果是私人房源，請輸入要授予存取權的身分識別電子郵件 ID。
- 如果是公開資訊，請新增 allAuthenticatedUsers。
- 如要讓所有人 (包括非Google Cloud使用者) 都能找到公開的產品資訊，請新增 allUsers。
在「Select a role」(選取角色) 部分，將指標懸停在「Analytics Hub」(數據分析中心) 上，然後根據商家資訊類型選取下列其中一個角色：
- 如果是商業產品資訊 (包括整合 Cloud Marketplace 的產品資訊)，請選取「Analytics Hub Viewer」角色。使用者可透過這個角色查看商家檔案並要求存取權。
- 如果是私人或非商業用途的公開清單，請選取「Analytics Hub 訂閱者」角色。使用者可透過這個角色訂閱你的商家資訊。
- 如果是整合 Cloud Marketplace 的項目，系統會根據 Cloud Marketplace 訂單自動管理訂閱項目，因此不需要授予 Analytics Hub 訂閱者角色 (roles/analyticshub.subscriber)。
注意： 授予使用者存取非 Cloud Marketplace 整合式商業項目的授權後，您可以為這些使用者建立私人項目，或是授予這些使用者商業項目的 Analytics Hub 訂閱者 (roles/analyticshub.subscriber) 角色。

詳情請參閱「Analytics Hub 訂閱者和檢視者角色」。
按一下 [儲存]。

API

使用 projects.locations.dataExchanges.listings.getIamPolicy 方法，透過清單 getIamPolicy 方法讀取現有政策。
```
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:getIamPolicy
```
更改下列內容：
- PROJECT_ID：專案 ID，例如 my-project-1。
- LOCATION：含有房源資訊的資料交易所位置。
- DATAEXCHANGE_ID：資料交換 ID。
- LISTING_ID：房源 ID。
「分享」會在回應中傳回目前的政策。
如要新增或移除成員及其相關聯的角色，請使用文字編輯器編輯政策。請使用下列格式新增成員：
- user:test-user@gmail.com
- group:admins@example.com
- serviceAccount:test123@example.domain.com
- domain:example.domain.com
舉例來說，如要將 roles/analyticshub.subscriber 角色授予 group:subscribers@example.com，請在政策中新增下列繫結：
```
{
 "members": [
   "group:subscribers@example.com"
 ],
 "role":"roles/analyticshub.subscriber"
}
```
使用 projects.locations.dataExchanges.listings.setIamPolicy 方法寫入更新後的政策。在要求主體中，提供上一個步驟中更新的 IAM 政策。
```
POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:setIamPolicy
```
在要求主體中提供房源詳細資料。如果要求成功，回應主體會包含房源詳細資料。

如要進一步瞭解如何使用 API 對房源執行工作，請參閱 projects.locations.dataExchanges.listings 方法。

為公開房源建立未經驗證的網址

如要建立未經驗證的 BigQuery 共用項目網址，讓非Google Cloud 使用者也能查看，請按照下列步驟操作：

前往「Sharing (Analytics Hub)」頁面。

前往「共用」(Analytics Hub)

畫面上會顯示您可存取的所有資料交換。
按一下包含商家資訊的資料交易所名稱。
按一下顯示名稱即可查看房源詳細資料。商店資訊必須啟用公開探索功能。
按一下「複製公開連結」，即可產生未經驗證的產品資訊網址。請確認這份清單授予 allUsers Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。

建立商店資訊管理員

如要讓使用者管理房源資訊，必須建立房源資訊管理員。如要建立清單管理員，您必須在清單層級授予使用者 Analytics Hub 發布者或 Analytics Hub 清單管理員 IAM 角色。如要進一步瞭解如何為商家資訊授予這些角色，請參閱「為商家資訊授予角色」。

查看所有訂閱項目

如要查看目前所有商店資訊的訂閱項目，請選取下列其中一個選項：

控制台

前往「Sharing (Analytics Hub)」頁面。

前往「共用」(Analytics Hub)
按一下包含要管理訂閱項目商家資訊的資料交易名稱。
按一下要列出所有訂閱者的商家資訊。
如要查看所有訂閱者，請按一下「管理訂閱」。
選用：您可以依訂閱者詳細資料篩選結果。

或者，如果您有權存取共用資料集，可以按照下列步驟列出訂閱者：

前往「BigQuery」頁面

前往「BigQuery」
點選左側窗格中的「Explorer」：

如果沒有看到左側窗格，請按一下「展開左側窗格」圖示開啟窗格。
在「Explorer」窗格中展開專案名稱，點選「Datasets」(資料集)，然後點選共用資料集的名稱。
在「分享」清單中，選取「管理訂閱項目」。

SQL

以下範例使用 INFORMATION_SCHEMA.SCHEMATA_LINKS 檢視區塊，列出 myproject 中連結至共用資料集的所有連結資料集，這些資料集位於 us 區域：

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

輸出結果大致如下。某些資料欄會省略，用以簡化輸出內容。

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

如要查看多個區域的訂閱項目 (預覽)，請將 us 區域替換為預期副本位置，即可查看不同區域的訂閱項目。舉例來說，如要查看 myproject 中連結至共用資料集且位於 eu 地區的連結資料集，請使用下列查詢：

SELECT * FROM `myproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

API

使用 projects.locations.dataExchanges.listings.listSubscriptions 方法。

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:listSubscriptions

更改下列內容：

PROJECT_ID：要訂閱的房源專案 ID。
LOCATION：要訂閱的商家資訊位置。
DATAEXCHANGE_ID：包含您要訂閱的房源資訊的資料交易所 ID。
LISTING_ID：要訂閱的房源 ID。

移除訂閱項目

如果移除 2023 年 7 月 25 日前建立的房源訂閱項目，連結的資料集會與共用資料集取消連結。訂閱者仍可在專案中查看資料集，但這些資料集已不再與共用資料集連結。

如要從商店資訊中移除 2023 年 7 月 25 日前建立的訂閱項目，請按照下列步驟操作：

如要列出所有訂閱者，請按照「查看所有訂閱項目」一文中的 Google Cloud 控制台操作說明進行操作。
如要從清單中移除訂閱者，請按一下「刪除」。如要移除所有訂閱項目，請按一下「移除所有訂閱項目」。
在「要移除訂閱項目嗎？」對話方塊中輸入 remove 以確認。
按一下 [移除]。

如要移除 2023 年 7 月 25 日後建立的訂閱項目，請按照下列步驟操作：

控制台

如要列出所有訂閱者，請按照「查看所有訂閱項目」一文中的 Google Cloud 控制台操作說明進行操作。
按一下「Subscriptions」(訂閱項目) 分頁標籤。
如要從房源資訊中移除訂閱者，請選取要移除的訂閱項目，然後按一下「移除訂閱」。
在「要移除訂閱項目嗎？」對話方塊中輸入 remove 以確認。
按一下 [移除]。

API

使用 projects.locations.subscriptions.revoke 方法。

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

更改下列內容：

PROJECT_ID：要移除的訂閱項目專案 ID。
LOCATION：要移除的訂閱項目位置。
SUBSCRIPTION：要移除的訂閱項目 ID。

更新產品資訊

如要更新房源資訊，請按照下列步驟操作：

控制台

前往「Sharing (Analytics Hub)」頁面。

前往「共用」(Analytics Hub)
按一下包含商家資訊的資料交易所名稱。
按一下要更新的商家資訊。
按一下「編輯房源」。
修改欄位中的值。除了房源的共用資料集，您可修改所有值。
選用：
- 如要啟用公開探索功能，請將 Analytics Hub 檢視者角色 (roles/analyticshub.viewer) 授予 allUsers 或 allAuthenticatedUsers。詳情請參閱「授予房源角色」。
- 如果停用公開探索功能，請從 allUsers 和 allAuthenticatedUsers 移除 Analytics Hub 檢視者角色 (roles/analyticshub.viewer)。公開交易平台無法提供私人房源，但私人交易平台可以提供公開房源。
- 啟用並儲存訂閱端電子郵件記錄功能後，就無法編輯這項設定。如要停用電子郵件記錄功能，請刪除清單項目，然後重新建立，但不要點按「訂閱者電子郵件記錄」切換按鈕。
- 在商家資訊中新增或移除區域 (預覽)。新增多個區域前，請先確認您已在共用資料集上啟用跨區域資料集複製。移除區域時，請先刪除該區域中的共用資料集副本。
注意： 這個選項僅適用於為多個區域建立的新商家檔案。您無法為現有的單一區域房源新增或移除副本。
預覽房源資訊。
如要儲存變更，請按一下「儲存」。為避免與整合 Cloud Marketplace 的產品資訊發生差異，系統會顯示通知，提示更新 Cloud Marketplace 資料產品資訊。

注意： 更新 Cloud Marketplace 資料產品資訊時，必須經過 Marketplace 營運團隊審查並核准。

API

請使用 projects.locations.dataExchanges.listings.patch 方法。

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

將 UPDATEMASK 替換為要更新的欄位清單。如要更新多個值，請使用以半形逗號分隔的清單。舉例來說，如要更新資料交換的顯示名稱和主要聯絡人，請輸入 displayName,primaryContact。

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

displayName
description
primaryContact
documentation
icon
categories[]
discoveryType
logLinkedDatasetQueryUserEmail

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

更新商家資訊的副本區域時，請務必指定所有適用區域。更新商家資訊前，請確認已在共用資料集上啟用跨區域資料集複製。您只能新增共用資料集複製的區域 (預覽)。如要移除區域，請先刪除該區域的共用資料集副本，再從商家資訊中移除。只有為多個區域新建立的商家資訊，才能更新副本區域。您無法將現有商家資訊轉換為多個區域的商家資訊。

如要進一步瞭解如何使用 API 對房源執行工作，請參閱 projects.locations.dataExchanges.listings 方法。

刪除商家資訊

刪除商品後，訂閱者就無法再查看商品。刪除房源也會刪除所有連結的資料集，並從訂閱者專案中移除所有訂閱項目。如果資料集仍處於連結狀態，請按一下依序選取「共用」>「管理訂閱」，手動移除資料集。系統會開啟「訂閱項目」頁面，您可以在這裡移除特定訂閱者資料集，或一次移除所有訂閱者資料集。

您無法刪除含有有效商業訂閱項目的整合 Cloud Marketplace 的產品資訊。刪除房源前，請先撤銷所有商業訂閱。

刪除多個區域的房源資訊 (預覽) 不會刪除共用資料集副本。刪除多個區域的項目後，訂閱者就無法再查看項目或查詢連結的資料集。如果其他房源未參照共用資料集副本，您可以選擇刪除副本。

刪除多個區域的房源資訊 (預覽) 前，請確認沒有與其相關的有效訂閱項目。如有有效訂閱項目，請先使用 projects.locations.subscriptions.revoke 方法撤銷訂閱。移除所有有效訂閱後，即可繼續刪除多個區域的商家資訊。

如要刪除房源，請按照下列步驟操作：

控制台

前往「Sharing (Analytics Hub)」頁面。

前往「共用」(Analytics Hub)
按一下包含商家資訊的資料交易所名稱。
按一下要刪除的商家資訊。
按一下「刪除」圖示。
在「Delete listing?」(刪除房源？) 對話方塊中輸入「delete」(刪除)，確認要刪除房源。
按一下「Delete」(刪除)。

API

請使用 projects.locations.dataExchanges.listings.delete 方法。

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID

如要進一步瞭解如何使用 API 對房源執行工作，請參閱 projects.locations.dataExchanges.listings 方法。

在精選專區中顯示房源資訊

如要提高 BigQuery 共用目錄中資源的曝光率和知名度，資源可以顯示在「精選」部分。精選房源受《 Google Cloud 優勢合作夥伴協議》規範。

如要讓合作夥伴的清單顯示在 BigQuery 共用目錄的「精選」部分，必須符合下列條件：

共用資料必須位於 BigQuery 中。
他們必須註冊優勢合作夥伴計畫，並取得「建構」資格。
清單必須已建立，且已啟用公開探索功能。

如要申請將商家資訊加入「精選」部分，請填寫並提交申請表。如要要求從該專區移除商家資訊，請提交相同的申請表單。

管理清單

事前準備

控制台

gcloud

必要的角色

查看資料交換庫

建立商家資訊

控制台

API

從資料集建立房源資訊

在房源資訊中分享 SQL 預存程序

訂閱者授權

供應商授權

授予使用者商家資訊存取權

控制台

API

為公開房源建立未經驗證的網址

建立商店資訊管理員

查看所有訂閱項目

控制台

SQL

API

移除訂閱項目

控制台

API

更新產品資訊

控制台

API

刪除商家資訊

控制台

API

在精選專區中顯示房源資訊

後續步驟