Dieses Dokument enthält Informationen zur Verwendung der Parallelitätssteuerung mit Nachrichten, die in einem Thema veröffentlicht werden.
Mit der Parallelitätssteuerung können Sie die Standardanzahl der Hintergrund-Threads (E/A) überschreiben, die von der Clientbibliothek zum Veröffentlichen von Nachrichten verwendet werden. So können Publisher-Clients Nachrichten parallel senden.
Die Funktion zur Steuerung der Parallelität ist in der Pub/Sub-Clientbibliothek auf hoher Ebene verfügbar. Sie können auch Ihre eigene Parallelitätssteuerung implementieren, wenn Sie eine Low-Level-Bibliothek verwenden.
Die Unterstützung für die Steuerung der Gleichzeitigkeit hängt von der Programmiersprache der Clientbibliothek ab. Bei Sprachimplementierungen, die parallele Threads wie C++, Go und Java unterstützen, legen die Clientbibliotheken die Anzahl der Threads jeweils anhand ihrer Standardeinstellung fest.
Auf dieser Seite wird das Konzept der Parallelitätssteuerung erläutert und beschrieben, wie Sie die Funktion für Ihre Publisher-Clients einrichten. Informationen zum Konfigurieren Ihrer Abonnentenclients für die Gleichzeitigkeitssteuerung finden Sie unter Mehr Nachrichten mit Gleichzeitigkeitssteuerung verarbeiten.
Hinweise
Bevor Sie den Veröffentlichungs-Workflow konfigurieren, müssen Sie die folgenden Aufgaben ausführen:
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Pub/Sub Publisher (roles/pubsub.publisher
) für das Thema zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie zum Veröffentlichen von Nachrichten in einem Thema benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können 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.
Konfigurationen für die Gleichzeitigkeitserkennung
Die Standardwerte für die Variablen zur Steuerung der Parallelität und die Namen der Variablen können sich je nach Clientbibliothek unterscheiden. In der Java-Clientbibliothek sind die Methoden zum Konfigurieren der Parallelitätssteuerung beispielsweise setExecutorProvider()
und setChannelProvider()
. Weitere Informationen finden Sie in der API-Referenzdokumentation.
Mit setExecutorProvider() können Sie den Executor-Anbieter anpassen, der für die Verarbeitung von Veröffentlichungsantworten verwendet wird. Sie können beispielsweise den Executor-Anbieter in einen Anbieter ändern, der einen einzelnen, gemeinsam genutzten Executor mit einer begrenzten Anzahl von Threads für mehrere Publisher-Clients zurückgibt. Diese Konfiguration trägt dazu bei, die Anzahl der erstellten Threads zu begrenzen.
Mit setChannelProvider() können Sie den Channel-Anbieter anpassen, der zum Öffnen von Verbindungen zu Pub/Sub verwendet wird. Normalerweise konfigurieren Sie diesen Wert nicht, es sei denn, Sie möchten denselben Channel für mehrere Publisher-Clients verwenden. Wenn ein Channel für zu viele Clients wiederverwendet wird, kann dies zu
GOAWAY
- oderENHANCE_YOUR_CALM
-Fehlern führen. Wenn diese Fehler in den Logs Ihrer Anwendung oder in Cloud Logs angezeigt werden, erstellen Sie weitere Channels.
Codebeispiele für die Parallelitätssteuerung
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.
Go
Im folgenden Beispiel wird die Hauptversion der Go Pub/Sub-Clientbibliothek (v2) verwendet. Wenn Sie noch die v1-Bibliothek verwenden, finden Sie hier den Migrationsleitfaden für v2. Eine Liste der Codebeispiele für Version 1 finden Sie unter Eingestellte Codebeispiele.
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 zu 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 zu Pub/Sub Java API.
Ruby
Im folgenden Beispiel wird die Ruby-Pub/Sub-Clientbibliothek v3 verwendet. Wenn Sie noch die v2-Bibliothek verwenden, finden Sie hier die Migrationsanleitung für v3. Eine Liste der Ruby v2-Codebeispiele finden Sie unter Eingestellte Codebeispiele.
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby im Schnellstart: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zu Pub/Sub Ruby API.
Nächste Schritte
Informationen zum Einschränken der Standorte, an denen Pub/Sub Nachrichtendaten speichert, finden Sie unter Pub/Sub-Ressourcenstandorte beschränken.
Weitere Informationen zum Empfangen von Nachrichten finden Sie unter Abo-Typ auswählen.