Cloud Storage 訂閱方案

Cloud Storage 訂閱項目是一種匯出訂閱項目，會在收到訊息時，將訊息寫入現有 Cloud Storage bucket。您不需要設定個別的訂閱端。 使用 Google Cloud 控制台、Google Cloud CLI、用戶端程式庫或 Pub/Sub API，建立、更新、列出、取消連結或刪除 Cloud Storage 訂閱項目。

如果沒有 Cloud Storage 訂閱類型，您需要提取或推送訂閱項目和訂閱者 (例如 Dataflow)，才能讀取訊息並將訊息寫入 Cloud Storage 值區。如果訊息不需額外處理，即可儲存至 Cloud Storage bucket，就不必執行 Dataflow 工作，改用 Cloud Storage 訂閱項目即可。

如要輕量修改訊息或屬性，可以將單一訊息轉換附加至 Cloud Storage 訂閱項目。不過，如果 Pub/Sub 系統需要在資料儲存至 Cloud Storage bucket 前進行更複雜的資料轉換，建議使用 Dataflow 管道，特別是想對訊息進行視窗化或彙整時。

如要瞭解如何使用 Dataflow 將 Pub/Sub 中的資料串流至 Cloud Storage 並進行轉換，請參閱「使用 Dataflow 從 Pub/Sub 串流訊息」。

事前準備

閱讀本文前，請先熟悉下列概念：

Cloud Storage 訂閱工作流程

下圖顯示 Cloud Storage 訂閱項目與 Cloud Storage 之間的工作流程。

Cloud Storage 訂閱項目的訊息流程

圖 1. Cloud Storage 訂閱項目工作流程

以下簡要說明圖 1 所示的工作流程：

  1. Pub/Sub 會使用 Cloud Storage API 將資料傳送至 Cloud Storage 值區。寫入作業成功完成後，API 會傳回 OK 回應。

  2. 訊息會分批傳送至 Cloud Storage bucket。 單一批次對應於儲存在 Cloud Storage bucket 中的物件。您可以根據物件大小和物件建立時間，設定批次設定。

  3. 將物件寫入 Cloud Storage 值區的工作流程需要兩次 OK 回應。當訊息成功寫入物件時，系統會傳送第一個 OK 回應。當含有訊息的物件完成最終處理時，系統會傳送第二個 OK 回應。只有在包含訊息的 Cloud Storage 物件成功完成最終化後，訊息才會顯示在值區中。

  4. 如果寫入作業期間發生任何失敗情形，系統會對 Pub/Sub 訊息本身發出否定確認。 然後重新傳送郵件。如果訊息寫入作業失敗次數過多，且您已在訂閱項目中設定無效信件主題，系統就會將訊息移至無效信件主題。

Cloud Storage 訂閱項目的屬性

建立 Cloud Storage 訂閱項目時，您必須指定一些額外屬性。這些屬性包括常見的訂閱屬性、檔案名稱和格式規定、儲存空間規定等。如要進一步瞭解這些屬性，請參閱「Cloud Storage 訂閱項目屬性」。

處理傳送失敗的訊息

如果無法將 Pub/Sub 訊息寫入 Cloud Storage 值區，就無法確認訊息。如要轉送這類無法送達的訊息，請在 Cloud Storage 訂閱項目中設定無效信件主題。

如果 Pub/Sub 無法將訊息寫入 Cloud Storage，Pub/Sub 會以類似推送退避行為的方式，延後傳送訊息。

配額

配額限制適用於每個區域的 Cloud Storage 訂閱者處理量。如要瞭解 Cloud Storage 訂閱項目的配額，請參閱「Pub/Sub 配額和限制」一文中的匯出訂閱者配額限制。

定價

如要瞭解 Cloud Storage 訂閱方案的價格，請參閱 Pub/Sub 定價頁面。

後續步驟