Cuando se entrega un mensaje a un suscriptor de extracción, este debe procesar y confirmar (ack) el mensaje dentro de la fecha límite de confirmación. De lo contrario, el suscriptor debe extender el plazo límite con una llamada para modificar el plazo límite de confirmación de recepción.
Las bibliotecas cliente de alto nivel de Pub/Sub proporcionan la administración de arrendamientos como una función que extiende automáticamente el plazo de un mensaje que aún no se confirmó. De forma predeterminada, las bibliotecas cliente pueden extender el plazo hasta una hora si envían solicitudes periódicas de modifyAckDeadline.Las bibliotecas cliente de alto nivel para Python, Go y Java usan el percentil 99 del retraso en la confirmación para determinar la duración de cada extensión.
La administración de arrendamientos te permite tener un control más detallado sobre la fecha límite de confirmación de los mensajes en comparación con la configuración de la propiedad a nivel de la suscripción. Si solo usas la fecha límite de confirmación a nivel de la suscripción, debes equilibrar la compensación entre un valor bajo y uno alto. Un valor bajo aumenta la probabilidad de que haya duplicados, y un valor alto retrasa la reentrega de los mensajes fallidos. Determinar el valor correcto puede ser difícil, especialmente cuando el tiempo de procesamiento esperado para diferentes mensajes varía mucho.
Para obtener más información sobre las propiedades de una suscripción, incluida la fecha límite de confirmación, consulta Propiedades de la suscripción.
Configuración de la administración de retenciones
Puedes configurar las siguientes propiedades en las bibliotecas cliente de alto nivel para controlar la administración de arrendamientos.
Período máximo de extensión del reconocimiento. Es la cantidad máxima de tiempo durante la cual la biblioteca cliente puede extender el plazo de confirmación de un mensaje con la solicitud
modify acknowledgment deadline
. Esta propiedad te permite determinar cuánto tiempo quieres que los clientes suscriptores procesen los mensajes.Duración máxima de cada extensión de confirmación. Es la cantidad máxima de tiempo en la que se puede extender la fecha límite de confirmación para cada una de las solicitudes de
modify acknowledgment deadline
. Esta propiedad te permite definir la cantidad de tiempo que Pub/Sub tarda en volver a entregar un mensaje. El reenvío se produce cuando el primer suscriptor que procesa el mensaje falla o deja de estar en buen estado y ya no puede enviar la solicitudmodify acknowledgment deadline
.Duración mínima para cada extensión de reconocimiento. Es la cantidad mínima de tiempo en la que se debe extender la fecha límite de confirmación para cada una de las solicitudes de
modify acknowledgment deadline
. Esta propiedad te permite especificar la cantidad mínima de tiempo que debe transcurrir antes de que se vuelva a entregar un mensaje.
No se garantiza que se respeten los plazos de confirmación, a menos que habilites la entrega exactamente una vez.
Administra las fechas límite de confirmación de forma manual
Para evitar el vencimiento y la reentrega de mensajes cuando se usa la extracción unaria o las bibliotecas cliente de bajo nivel, usa la solicitud modify acknowledgment deadline
para extender los plazos de confirmación. Las excepciones son las bibliotecas cliente de alto nivel de Go y C++, que proporcionan administración de asignación de tiempo cuando se usa la extracción unaria. Consulta los siguientes ejemplos de extracción unaria con administración de asignaciones de tiempo:
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#.
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.
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
En el siguiente ejemplo, se usa la versión 3 de la biblioteca cliente de Pub/Sub de Ruby. Si aún usas la biblioteca de la versión 2, consulta la guía de migración a la versión 3. Para ver una lista de muestras de código de Ruby v2, consulta las muestras de código obsoletas.
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.
¿Qué sigue?
Obtén más información sobre las otras opciones de entrega que puedes configurar para una suscripción:
Cómo controlar los aumentos transitorios con el control de flujo
Controla los errores en los mensajes con la política de reintento de suscripción
Reenvía los mensajes no entregados a un tema de mensajes no entregados
Vuelve a reproducir mensajes confirmados como recibidos o bórralos definitivamente