Cloud Storage 訂閱項目是一種匯出訂閱項目,會在收到訊息時,將訊息寫入現有的 Cloud Storage 值區。您不需要設定單獨的訂閱端。使用 Google Cloud 控制台、Google Cloud CLI、用戶端程式庫或 Pub/Sub API,建立、更新、列出、分離或刪除 Cloud Storage 訂閱。
如果沒有 Cloud Storage 訂閱類型,您需要使用拉取或推送訂閱,以及可讀取訊息並將訊息寫入 Cloud Storage 值區的訂閱者 (例如 Dataflow)。如果訊息不需要在儲存至 Cloud Storage 值區前進行額外處理,就不需要執行 Dataflow 工作所產生的額外負擔;您可以改用 Cloud Storage 訂閱。
不過,如果 Pub/Sub 系統需要在將資料儲存至 Cloud Storage 值區前進行一些資料轉換,建議您使用 Dataflow 管道。
如要瞭解如何使用 Dataflow 將資料從 Pub/Sub 串流至 Cloud Storage,並進行轉換,請參閱「使用 Dataflow 從 Pub/Sub 串流訊息」。
事前準備
閱讀本文前,請先熟悉下列內容:
Pub/Sub 的運作方式和不同的 Pub/Sub 術語。
瞭解不同的訂閱項目類型,以及為何建議使用 Cloud Storage 訂閱項目。
Cloud Storage 的運作方式。
Cloud Storage 訂閱項目工作流程
下圖顯示 Cloud Storage 訂閱項目和 Cloud Storage 之間的工作流程。
圖 1. Cloud Storage 訂閱項目的工作流程
以下簡要說明參照圖 1 的工作流程:
Pub/Sub 會使用 Cloud Storage API 將資料傳送至 Cloud Storage 值區。寫入作業成功完成後,API 會傳回
OK
回應。訊息會以批次傳送至 Cloud Storage 值區。單一批次對應至儲存在 Cloud Storage 值區中的物件。您可以根據物件大小和物件建立後經過的時間,設定批次設定。
將物件寫入 Cloud Storage 值區的工作流程需要兩個
OK
回應。訊息成功寫入物件時,系統會傳送第一個OK
回應。當包含訊息的物件完成後,系統會傳送第二個OK
回應。只有在包含訊息的 Cloud Storage 物件已成功完成後,訊息才會顯示在值區中。如果寫入作業發生任何錯誤,Pub/Sub 訊息本身會收到負面確認。系統就會重新傳送郵件。如果訊息寫入作業失敗次數達到一定次數,且您已在訂閱項目上設定無效信件主題,系統就會將訊息移至無效信件主題。
Cloud Storage 訂閱項目的屬性
建立 Cloud Storage 訂閱項目時,您必須指定一些額外的屬性。這些屬性包括常見的訂閱屬性、檔案名稱和格式規定、儲存空間需求等。如要進一步瞭解這些屬性,請參閱「Cloud Storage 訂閱項目屬性」。
處理傳送失敗的訊息
如果 Pub/Sub 訊息無法寫入 Cloud Storage 值區,就無法確認訊息。如要轉寄這類無法傳送的郵件,請在 Cloud Storage 訂閱項目上設定無效信件主題。
如果 Pub/Sub 無法將訊息寫入 Cloud Storage,則會以類似於推送回退行為的方式,停止傳送訊息。
配額
每個區域的 Cloud Storage 訂閱者處理量都會受到配額限制。如要瞭解 Cloud Storage 訂閱項目的配額,請參閱「Pub/Sub 配額與限制」一文中的「匯出訂閱者配額限制」。
定價
如要瞭解 Cloud Storage 訂閱方案的價格,請參閱 Pub/Sub 定價頁面。
後續步驟
- 建立 Cloud Storage 訂閱項目。
排解 Cloud Storage 訂閱項目問題。
探索 Pub/Sub 設定工具: