La messagerie par lot crée un client d'éditeur avec des paramètres de traitement par lot personnalisés et l'utilise pour publier certains messages.
Ce document fournit des informations sur l'utilisation de la messagerie par lot avec les messages publiés dans un sujet.
Avant de commencer
Avant de configurer le workflow de publication, assurez-vous d'avoir effectué les tâches suivantes:
Rôles requis
Pour obtenir les autorisations nécessaires pour publier des messages dans un sujet, demandez à votre administrateur de vous attribuer le rôle IAM Éditeur Pub/Sub (roles/pubsub.publisher
) pour le sujet.
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.
Vous devez disposer d'autorisations supplémentaires pour créer ou mettre à jour des sujets et des abonnements.
Utiliser la messagerie par lots
Consultez les exemples de code suivants pour savoir comment configurer les paramètres de messagerie par lot pour votre éditeur.
C++
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage C++ qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour C++.
C#
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage C# qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour C#.
Go
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Go qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Go.
Java
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Java qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Java.
Node.js
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Node.js qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Node.js.
Node.js
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Node.js qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Node.js.
PHP
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage PHP qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour PHP.
Python
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Python qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Python.
Ruby
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Ruby qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API Pub/Sub pour Ruby.
Désactiver l'envoi de messages par lot
Pour désactiver le traitement par lot dans votre bibliothèque cliente, définissez la valeur de max_messages
sur 1.
Messagerie par lot et livraison commandée
Avec la distribution ordonnée, l'échec d'accusé de réception d'un message du lot signifie que tous les messages du lot, y compris ceux envoyés avant le message non confirmé, sont tous redistribués.
Quotas et limites pour la messagerie par lot
Avant de configurer la messagerie par lot, tenez compte de l'impact de facteurs tels que le quota de débit en publication et la taille maximale d'un lot. Les bibliothèques clientes de haut niveau garantissent que les requêtes par lot restent dans les limites spécifiées.
- 1 000 octets est la taille minimale de la requête prise en compte à des fins de coût, même si la taille réelle du message peut être inférieure à 1 000 octets.
- Pub/Sub impose une limite de taille de 10 Mo ou de 1 000 messages par requête de publication par lot.
Pour en savoir plus, consultez la page Quotas et limites de Pub/Sub.
Étapes suivantes
Pour savoir comment configurer les options de publication avancées, consultez les pages suivantes: