In diesem Dokument erfahren Sie, wie Sie die Nebenläufigkeitserkennung für Nachrichten verwenden, die in einem Thema veröffentlicht werden.
Mit der Nebenläufigkeitserkennung 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 die Publisher-Clients Nachrichten parallel senden.
Die Nebenläufigkeitserkennung ist eine verfügbare Funktion in der Pub/Sub Clientbibliothek auf hoher Ebene. Sie können auch Ihre eigene Nebenläufigkeitserkennung implementieren, wenn Sie eine Bibliothek auf niedriger Ebene verwenden.
Die Unterstützung für die Nebenläufigkeitserkennung 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 Nebenläufigkeitserkennung erläutert und wie Sie die Funktion für Ihre Publisher-Clients einrichten. Informationen zum Konfigurieren Ihrer Abonnenten-Clients für die Nebenläufigkeitserkennung finden Sie unter Mehr Nachrichten mit Nebenläufigkeitserkennung verarbeiten.
Hinweis
Bevor Sie den Veröffentlichungs-Workflow konfigurieren, müssen Sie die folgenden Aufgaben ausgeführt haben:
- Informationen zu Themen und zum Veröffentlichungs-Workflow
- Thema erstellen.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen für Ihr Thema die IAM-Rolle Pub/Sub-Publisher (roles/pubsub.publisher) 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 Nebenläufigkeitserkennung
Die Standardwerte für die Variablen der Nebenläufigkeitserkennung und die Namen der Variablen können sich zwischen den Clientbibliotheken unterscheiden. In der Java-Clientbibliothek sind die Methoden zum Konfigurieren der Nebenläufigkeitserkennung beispielsweise setExecutorProvider() und setChannelProvider(). Weitere Informationen finden Sie unter
der
API-Referenzdokumentation.
Mit setExecutorProvider() können Sie den Executor-Provider anpassen, der zum Verarbeiten von Veröffentlichungsantworten verwendet wird. Sie können den Executor-Bereitsteller beispielsweise in einen ändern, der einen einzelnen, freigegebenen 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-Provider anpassen, der zum Öffnen von Verbindungen zu Pub/Sub verwendet wird. Normalerweise konfigurieren Sie diesen Wert nur, wenn Sie denselben Channel für mehrere Publisher-Clients verwenden möchten. Wenn Sie einen Channel für zu viele Clients wiederverwenden, kann dies zu
GOAWAY- oderENHANCE_YOUR_CALM-Fehlern führen. Wenn diese Fehler in den Logs Ihrer Anwendung oder in Cloud Loggingangezeigt werden, erstellen Sie weitere Channels.
Codebeispiele für die Nebenläufigkeitserkennung
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 (Version 2) verwendet. Wenn Sie noch die Version 1-Bibliothek verwenden, finden Sie weitere Informationen im Migrationsleitfaden zu Version 2. Eine Liste der Codebeispiele für Version 1 finden Sie unter Veraltete Codebeispiele.
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Go in der Kurzanleitung: 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 Version 3 verwendet. Wenn Sie noch die Version 2-Bibliothek verwenden, finden Sie weitere Informationen im Migrationsleitfaden zu Version 3. Eine Liste der Codebeispiele für Ruby Version 2 finden Sie unter Veraltete Codebeispiele.
Bevor Sie dieses Beispiel testen, folgen Sie der Einrichtungsanleitung für Ruby in der Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur 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 einschränken.
Weitere Informationen zum Empfangen von Nachrichten finden Sie unter Abotyp auswählen.