Cloud Storage-Abos

Ein Cloud Storage-Abo ist ein Exportabo der Nachrichten in einen vorhandenen Cloud Storage-Bucket schreibt als wenn sie empfangen werden. Sie müssen keinen separaten Abonnentenclient konfigurieren. Verwenden Sie die Google Cloud Console, die Google Cloud CLI, die Clientbibliotheken oder die Pub/Sub API verwenden, um ein Cloud Storage-Abo.

Ohne den Cloud Storage-Abotyp benötigen Sie ein Pull- oder Push-Abo (z. B. Dataflow), das Nachrichten liest und in Cloud Storage-Bucket Der Aufwand beim Ausführen eines Dataflow-Job ist nicht erforderlich, wenn für Nachrichten nichts erforderlich ist vor dem Speichern in einem Cloud Storage-Bucket zusätzlich verarbeitet werden. können Sie stattdessen ein Cloud Storage-Abo verwenden.

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

Um zu erfahren, wie Sie Daten von Pub/Sub zu Cloud Storage mit Transformation mithilfe von Dataflow, Siehe Nachrichten aus Pub/Sub mit Dataflow streamen.

Hinweise

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

  • Funktionsweise von Pub/Sub und unterschiedlichen Pub/Sub-Begriffen.

  • Welche Arten von Abos gibt es? und die Vorteile eines Cloud Storage-Abos.

  • Funktionsweise von Cloud Storage

Workflow für Cloud Storage-Abos

In der folgenden Abbildung sehen Sie den Workflow zwischen 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 zum Senden von Daten in den Cloud Storage-Bucket. Nach dem erfolgreichen Abschluss einer schreiben, 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. Sie können die Batch-Einstellungen basierend auf Die Objektgröße und die seit der Erstellung des Objekts verstrichene Zeit.

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

  4. Falls während des Schreibvorgangs Fehler auftreten, Die Pub/Sub-Nachricht selbst wird negativ bestätigt. Die Nachricht wird dann erneut gesendet. Wenn der Nachrichtenschreibvorgang oft genug 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

Beim Erstellen eines Cloud Storage-Abos müssen Sie einige zusätzliche Eigenschaften. Zu diesen Properties gehören gängige Abos Eigenschaften, Dateinamen, Formatanforderungen, Speicheranforderungen und mehr. Weitere Informationen zu diesen Attributen finden Sie unter Cloud Storage-Aboeigenschaften.

Pub/Sub-Dienstkontoberechtigungen

Um ein Cloud Storage-Abo zu erstellen, Das Pub/Sub-Dienstkonto muss die Berechtigung zum Schreiben in den Cloud Storage-Buckets und zum Lesen der Bucket-Metadaten.

Weitere Informationen finden Sie unter Weisen Sie dem Pub/Sub-Dienstkonto Cloud Storage-Rollen zu.

Umgang mit Nachrichtenfehlern

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

Wenn Pub/Sub keine Nachrichten in Cloud Storage schreiben kann, unterstützt Pub/Sub die Zustellung von Nachrichten ähnlich wie Push-Backoff-Verhalten.

Kontingente

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

Preise

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

Nächste Schritte