Cloud Storage-Abos

Ein Cloud Storage-Abo ist eine Art Exportabo, das Nachrichten beim Empfang in einen vorhandenen Cloud Storage-Bucket schreibt. Sie müssen keinen separaten Abonnentenclient konfigurieren. Verwenden Sie die Google Cloud Console, die Google Cloud CLI, die Clientbibliotheken oder die Pub/Sub API, um ein Cloud Storage-Abo zu erstellen, zu aktualisieren, aufzulisten, zu trennen oder zu löschen.

Ohne den Cloud Storage-Abotyp 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 erfordern. Sie können stattdessen ein Cloud Storage-Abo verwenden.

Eine Dataflow-Pipeline wird jedoch auch für Pub/Sub-Systeme empfohlen, bei denen eine Datentransformation erforderlich ist, bevor die Daten in einem Cloud Storage-Bucket gespeichert werden.

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

Hinweise

Bevor Sie dieses Dokument lesen, sollten Sie sich mit folgenden Themen vertraut machen:

  • Informationen zur Funktionsweise von Pub/Sub und die verschiedenen Pub/Sub-Begriffe

  • Welche Arten von Abos gibt es und welche Vorteile bietet ein Cloud Storage-Abo?

  • Funktionsweise von Cloud Storage

Workflow für Cloud Storage-Abos

Die folgende Abbildung zeigt den Workflow zwischen einem Cloud Storage-Abo und Cloud Storage.

Nachrichtenfluss für ein Cloud Storage-Abo

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

Hier ist eine kurze Beschreibung des Workflows, der auf Abbildung 1 verweist:

  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, abgeschlossen ist. Eine Nachricht wird im Bucket erst 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 fehlschlägt und Sie für das Abo ein Thema für unzustellbare Nachrichten konfiguriert haben, wird die Nachricht in das Thema für unzustellbare Nachrichten verschoben.

Attribute eines Cloud Storage-Abos

Wenn Sie ein Cloud Storage-Abo erstellen, müssen Sie einige zusätzliche Attribute angeben. Diese Eigenschaften umfassen allgemeine Aboeigenschaften, Anforderungen an Dateinamen und Formate, Speicheranforderungen und mehr. Weitere Informationen zu diesen Attributen finden Sie unter Cloud Storage-Aboeigenschaften.

Pub/Sub-Dienstkontoberechtigungen

Zum Erstellen eines Cloud Storage-Abos muss das Pub/Sub-Dienstkonto die Berechtigung zum Schreiben in den jeweiligen Cloud Storage-Bucket und zum Lesen der Bucket-Metadaten haben.

Weitere Informationen finden Sie unter Dem Pub/Sub-Dienstkonto Cloud Storage-Rollen zuweisen.

Umgang mit Nachrichtenfehlern

Wenn eine Pub/Sub-Nachricht nicht in einen Cloud Storage-Bucket geschrieben werden kann, kann die Nachricht nicht bestätigt werden. Konfigurieren Sie zum Weiterleiten solcher unzustellbarer Nachrichten ein Thema für unzustellbare Nachrichten im Cloud Storage-Abo.

Wenn Pub/Sub keine Nachrichten in Cloud Storage schreiben kann, sichert Pub/Sub die Zustellung von Nachrichten auf ähnliche Weise wie das Push-Backoff-Verhalten.

Kontingente

Für den Cloud Storage-Abonnentendurchsatz für jede Region gelten Kontingentbeschränkungen. Informationen zu Kontingenten für Cloud Storage-Abos finden Sie unter Cloud Pub/Sub-Kontingente und -Limits unter Abonnentenkontingentlimits.

Preise

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

Nächste Schritte