Cloud Storage-Abos

Ein Cloud Storage-Abo ist ein Exportabo, mit dem empfangene Nachrichten in einen vorhandenen Cloud Storage-Bucket geschrieben werden. Sie müssen keinen separaten Abonnentenclient konfigurieren. Sie können die Google Cloud Console, die Google Cloud CLI, die Clientbibliotheken oder die Pub/Sub API verwenden, um ein Cloud Storage-Abo zu erstellen, zu aktualisieren, aufzulisten, zu trennen oder zu löschen.

Ohne das Cloud Storage-Abo benötigen Sie ein Pull- oder Push-Abo und einen Abonnenten (z. B. Dataflow), der Nachrichten liest und in einen Cloud Storage-Bucket schreibt. Der Aufwand für die Ausführung eines Dataflow-Jobs ist nicht erforderlich, wenn Nachrichten vor dem Speichern in einem Cloud Storage-Bucket keine zusätzliche Verarbeitung benötigen. In diesem Fall können Sie stattdessen ein Cloud Storage-Abo verwenden.

Für einfache Änderungen an Nachrichten oder Attributen können Sie Ihrem Cloud Storage-Abo eine Single Message Transform anhängen. Für Pub/Sub-Systeme, in denen eine komplexere Datentransformation erforderlich ist, bevor die Daten in einem Cloud Storage-Bucket gespeichert werden, wird jedoch eine Dataflow-Pipeline empfohlen, insbesondere wenn Sie Fenster oder Aggregate für Nachrichten erstellen möchten.

Informationen zum Streamen von Daten aus Pub/Sub in Cloud Storage mit Transformation mithilfe von Dataflow finden Sie unter Nachrichten mit Dataflow aus Pub/Sub streamen.

Hinweis

Bevor Sie dieses Dokument lesen, sollten Sie mit Folgendem vertraut sein:

Cloud Storage-Abo-Workflow

Das folgende Bild zeigt den Workflow zwischen einem Cloud Storage-Abo und Cloud Storage.

Ablauf von Nachrichten für ein Cloud Storage-Abo

Abbildung 1. Workflow für ein Cloud Storage-Abo

Hier eine kurze Beschreibung des Workflows, der sich auf Abbildung 1 bezieht:

  1. Pub/Sub verwendet die Cloud Storage API, um Daten an den Cloud Storage-Bucket zu senden. Nach erfolgreichem Abschluss eines Schreibvorgangs gibt die API eine OK-Antwort zurück.

  2. Die Nachrichten werden in Batches an den Cloud Storage-Bucket gesendet. Ein einzelner Batch entspricht einem Objekt, das im Cloud Storage-Bucket gespeichert ist. Sie können die Batcheinstellungen basierend auf der Objektgröße und der seit der Erstellung des Objekts verstrichenen Zeit konfigurieren.

  3. Für den Workflow zum Schreiben eines Objekts in einen Cloud Storage-Bucket sind zwei OK-Antworten erforderlich. Die erste OK-Antwort wird gesendet, wenn eine Nachricht erfolgreich in ein Objekt geschrieben wurde. Die zweite OK-Antwort wird gesendet, wenn das Objekt, das die Nachricht enthält, fertiggestellt ist. Eine Nachricht wird erst dann im Bucket sichtbar, wenn das Cloud Storage-Objekt, das sie enthält, erfolgreich abgeschlossen wurde.

  4. Wenn während des Schreibvorgangs Fehler auftreten, wird die Pub/Sub-Nachricht selbst negativ bestätigt. Die Nachricht wird dann noch einmal gesendet. Wenn der Schreibvorgang für Nachrichten oft genug fehlschlägt und Sie ein Thema für unzustellbare Nachrichten für das Abo konfiguriert haben, wird die Nachricht in das Thema für unzustellbare Nachrichten verschoben.

Eigenschaften eines Cloud Storage-Abos

Wenn Sie ein Cloud Storage-Abo erstellen, müssen Sie einige zusätzliche Attribute angeben. Dazu gehören allgemeine Abonnementeigenschaften, Anforderungen an Dateinamen und ‑format, Speicheranforderungen und mehr. Weitere Informationen zu diesen Properties finden Sie unter Cloud Storage-Abo-Properties.

Umgang mit Nachrichtenfehlern

Wenn eine Pub/Sub-Nachricht nicht in einen Cloud Storage-Bucket geschrieben werden kann, kann sie nicht bestätigt werden. Um solche unzustellbaren Nachrichten weiterzuleiten, konfigurieren Sie ein Thema für unzustellbare Nachrichten für das Cloud Storage-Abo.

Wenn Pub/Sub keine Nachrichten in Cloud Storage schreiben kann, wird die Zustellung von Nachrichten ähnlich wie beim Push-Backoff verzögert.

Kontingente

Für den Cloud Storage-Abonnentendurchsatz gelten Kontingentbeschränkungen für jede Region. Informationen zu den Kontingenten für Cloud Storage-Abos finden Sie unter „Kontingente für das Exportieren von Abonnenten“ in Pub/Sub-Kontingente und ‑Limits.

Preise

Informationen zu den Preisen für Cloud Storage-Abos finden Sie auf der Pub/Sub-Preisseite.

Nächste Schritte