Mit der Batch-Messaging-Funktion wird ein Publisher-Client mit benutzerdefinierten Batch-Einstellungen erstellt und verwendet, um einige Nachrichten zu veröffentlichen.
Dieses Dokument enthält Informationen zur Verwendung des Batch-Messaging mit Nachrichten, die in einem Thema veröffentlicht wurden.
Hinweise
Bevor Sie den Veröffentlichungsworkflow konfigurieren, müssen Sie die folgenden Aufgaben ausgeführt haben:
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Pub/Sub Publisher (roles/pubsub.publisher
) für das Thema zu gewähren, um die Berechtigungen zu erhalten, die Sie zum Veröffentlichen von Nachrichten zu einem Thema benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.
Möglicherweise können Sie die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Sie benötigen zusätzliche Berechtigungen, um Themen und Abos zu erstellen oder zu aktualisieren.
Batch-Messaging verwenden
In den folgenden Codebeispielen erfahren Sie, wie Sie Einstellungen für Batchnachrichten für Ihren Publisher konfigurieren.
C++
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für C++ in der Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub C++ API.
C#
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für C# in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub C# API.
Einfach loslegen (Go)
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Go in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Go API.
Java
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Java in der Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Java API.
Node.js
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für PHP in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Node.js API.
Node.js
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für PHP in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Node.js API.
PHP
Folgen Sie der Einrichtungsanleitung für PHP unter Schnellstart: Clientbibliotheken verwenden, bevor Sie dieses Beispiel ausprobieren. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub PHP API.
Python
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Python in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Python API.
Ruby
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Ruby in der Schnellstart-Anleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur Pub/Sub Ruby API.
Batchnachrichten deaktivieren
Wenn Sie die Batchverarbeitung in Ihrer Clientbibliothek deaktivieren möchten, legen Sie den Wert von max_messages
auf 1 fest.
Batch-Messaging und geordnete Zustellung
Wenn bei einer sortierten Zustellung eine Nachricht im Batch nicht bestätigt wird, werden alle Nachrichten im Batch noch einmal zugestellt, einschließlich der Nachrichten, die vor der nicht bestätigten Nachricht gesendet wurden.
Kontingente und Limits für Batchnachrichten
Bevor Sie das Batch-Messaging konfigurieren, sollten Sie die Auswirkungen von Faktoren wie dem Durchsatzkontingent für Veröffentlichungen und der maximalen Größe eines Batches berücksichtigen. Die übergeordneten Clientbibliotheken sorgen dafür, dass Batchanfragen innerhalb der angegebenen Limits bleiben.
- 1.000 Byte ist die minimale Anfragegröße, die für Kostenzwecke berücksichtigt wird, auch wenn die tatsächliche Nachrichtengröße möglicherweise kleiner als 1.000 Byte ist.
- Pub/Sub hat ein Limit von 10 MB oder 1.000 Nachrichten für eine einzelne Batch-Veröffentlichungsanfrage.
Weitere Informationen finden Sie unter Pub/Sub-Kontingente und -Limits.
Nächste Schritte
Hier erfahren Sie, wie Sie erweiterte Veröffentlichungsoptionen konfigurieren: