La mensajería por lotes crea un cliente publicador con una configuración de lote personalizada y lo usa para publicar algunos mensajes.
En este documento, se proporciona información sobre el uso de la mensajería por lotes con mensajes publicados en un tema.
Antes de comenzar
Antes de configurar el flujo de trabajo de publicación, asegúrate de haber completado las siguientes tareas:
- Obtén más información sobre los temas y el flujo de trabajo de publicación.
- Crea un tema.
Funciones obligatorias
Si quieres obtener los permisos que necesitas para publicar mensajes en un tema, pídele a tu administrador que te otorgue el rol de IAM Publicador de Pub/Sub (roles/pubsub.publisher
) en el tema.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso.
Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.
Necesitas permisos adicionales para crear o actualizar temas y suscripciones.
Usa mensajes por lotes
Consulta las siguientes muestras de código a fin de obtener información sobre cómo establecer la configuración de los mensajes por lotes para tu publicador.
C++
Antes de probar esta muestra, sigue las instrucciones de configuración de C++ en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para C++.
C#
Antes de probar esta muestra, sigue las instrucciones de configuración de C# en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para C#.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Go.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Java.
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Node.js.
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Node.js.
PHP
Antes de probar esta muestra, sigue las instrucciones de configuración de PHP en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para PHP.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Python.
Rita
Antes de probar esta muestra, sigue las instrucciones de configuración de Ruby en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Ruby.
Inhabilitar los mensajes por lotes
Para desactivar el procesamiento por lotes en tu biblioteca cliente, establece el valor de max_messages
en 1.
Mensajería por lotes y entrega ordenada
Con la entrega ordenada, si no se confirma algún mensaje del lote, se volverán a entregar todos los mensajes del lote, incluidos los enviados antes del mensaje que no se confirmó.
Cuotas y límites de la mensajería por lotes
Antes de configurar los mensajes por lotes, ten en cuenta el efecto de factores como la cuota de capacidad de procesamiento de publicación y el tamaño máximo de un lote. Las bibliotecas cliente de alto nivel garantizan que las solicitudes por lotes se mantengan dentro de los límites especificados.
- 1,000 bytes es el tamaño mínimo de solicitud que se considera para los costos, incluso si el tamaño real del mensaje puede ser menor que 1,000 bytes.
- Pub/Sub tiene un límite de 10 MB o 1,000 mensajes para una sola solicitud de publicación por lotes.
Para obtener más información, consulta Cuotas y límites de Pub/Sub.
¿Qué sigue?
Para aprender a configurar las opciones de publicación avanzada, consulta lo siguiente: