Los mensajes por lotes crean un cliente publicador con una configuración de lotes personalizada y lo usan para publicar algunos mensajes.
En este documento, se proporciona información sobre cómo usar los mensajes por lotes con mensajes que se publican en un tema.
Antes de comenzar
Antes de configurar el flujo de trabajo de publicación, asegúrate de haber completado los siguientes pasos: tareas:
- Obtén más información sobre los temas y el flujo de trabajo de publicación.
- Crea un tema.
Roles obligatorios
Para 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 a proyectos, carpetas y organizaciones.
También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.
Necesitas permisos adicionales para crear o actualizar temas y suscripciones.
Usa mensajes por lotes
Consulta las siguientes muestras de código para aprender a configurar los mensajes por lotes de configuración de 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.
Ruby
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 mensajes por lotes
Para desactivar la agrupación por lotes en tu biblioteca cliente, establece el valor de
max_messages
a 1.
Mensajes por lotes y entrega ordenada
Con la entrega ordenada, no confirmar cualquier mensaje en el lote significa que todos los mensajes del lote, incluidos los enviados antes del mensaje que no se confirmaron, se vuelven a entregar.
Cuotas y límites de los mensajes por lotes
Antes de configurar los mensajes por lotes, considera 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 se aseguran de que las solicitudes por lotes se mantengan dentro de los límites especificados.
- 1,000 bytes es el tamaño mínimo de solicitud considerado para fines de costo, incluso si el tamaño real del mensaje podría ser inferior a 1,000 bytes.
- Pub/Sub tiene un límite de 10 MB o 1,000 mensajes para una única 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 opciones de publicación avanzadas, consulta lo siguiente: