BigQuery 資料移轉服務執行通知

本頁面提供 BigQuery 資料移轉服務的執行通知總覽。

總覽

您可以為 BigQuery 資料移轉服務設定兩種類型的執行通知:

  • Cloud Pub/Sub 通知:機器可解讀的通知,於移轉執行成功或失敗時傳送
  • 電子郵件通知:使用者可理解的通知,於移轉執行失敗時傳送

您可以分別設定各類型,也可以同時使用 Cloud Pub/Sub 和電子郵件執行通知。

Cloud Pub/Sub 通知

Cloud Pub/Sub 通知會將移轉執行的相關資訊傳送至 Cloud Pub/Sub 主題。當移轉執行完成時的狀態如下,就會觸發 Cloud Pub/Sub 通知:

  • SUCCEEDED
  • FAILED
  • CANCELLED

只要是您有足夠權限的專案,您就能將通知傳送至其中的任何 Cloud Pub/Sub 主題。Cloud Pub/Sub 主題收到通知後,即可將結果訊息傳送給主題訂閱者 (數量不限)。

事前準備

設定 Cloud Pub/Sub 移轉執行通知前,您必須:

  1. 針對要接收通知的專案啟用 Cloud Pub/Sub API。

    啟用 API

  2. 針對要接收通知的專案取得足夠的權限:

    • 如果您擁有要接收通知的專案,表示您非常有可能已經具備必要權限。

    • 如果您要建立用於接收通知的主題,則必須擁有 pubsub.topics.create 權限。

    • 無論您要使用新的主題或現有的主題,都必須擁有 pubsub.topics.setIamPolicy 權限。建立主題後,您通常會具備該主題的 pubsub.topics.setIamPolicy 權限。以下是擁有 pubsub.topics.setIamPolicy 權限的預先定義專案層級身分與存取權管理角色:

      • pubsub.admin 預先定義角色
      • Owner 原始角色

      詳情請參閱 Cloud Pub/Sub 存取權控管

  3. 擁有現有的 Cloud Pub/Sub 主題,可接收您所傳送的通知。

通知格式

傳送至 Cloud Pub/Sub 主題的通知分為以下兩部分:

  • 屬性:用於說明事件的鍵/值組合。
  • 酬載:含變更物件的中繼資料的字串。

屬性

屬性以鍵/值組合表示,包含在 BigQuery 資料移轉服務傳送至 Cloud Pub/Sub 主題的所有通知中。無論通知酬載為何,通知都會包含以下鍵值組合:

屬性名稱 範例 說明
eventType TRANSFER_RUN_FINISHED 最新發生事件的類型,值一定是 TRANSFER_RUN_FINISHED
payloadFormat JSON_API_V1 物件酬載的格式,值一定是 JSON_API_V1

酬載

酬載是含移轉執行的中繼資料的字串。目前無法變更酬載類型,我們會因應日後的 API 版本變更配合提供相關功能。

酬載類型 說明
JSON_API_V1 酬載會是 UTF-8 JSON 序列化字串,內含 TransferRun 的資源表示法

電子郵件通知

電子郵件通知會在移轉執行失敗時傳送使用者可理解的電子郵件。收件者為設定移轉的使用者。這類郵件無法設定。

如有其他應收到移轉執行電子郵件通知的使用者,請設定電子郵件轉寄規則以分送郵件。如果您使用 Gmail,則可自動將 Gmail 郵件轉寄到其他帳戶

電子郵件通知是由 BigQuery 資料移轉服務所傳送,內含失敗移轉的移轉設定、移轉執行和移轉記錄連結。例如:

From: bigquery-data-transfer-service-noreply@google.com
To: [USER_WHO_SET_UP_TRANSFER]
Title: BigQuery Data Transfer Service - Transfer Run Failure - [DISPLAY_NAME]

Transfer Configuration
Display Name: [DISPLAY_NAME]
Source: [DATA_SOURCE]
Destination: [PROJECT_ID]

Run Summary
Run: [RUN_NAME]
Schedule Time: [SCHEDULE_TIME]
Run Time: [RUN_TIME]
View Run History

Google LLC 1600 Amphitheatre Parkway, Mountain View, CA 94043

This email was sent because you indicated you are willing to receive Run
Notifications from the BigQuery Data Transfer Service. If you do not wish to
receive such emails in the future, click View Transfer Configuration and
un-check the “Send E-mail Notifications” option.

執行通知定價

在 Alpha 測試階段,BigQuery 資料移轉服務不會針對執行通知收費。如果您設定 Cloud Pub/Sub 執行通知,則會產生 Cloud Pub/Sub 費用。詳情請參閱 Cloud Pub/Sub 定價頁面。

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁