Parcours des messages

  • Article

Le parcours des messages, ou « Peek », permet à un client Service Bus d’énumérer tous les messages d’une file d’attente ou d’un abonnement, à des fins de diagnostic et de débogage.

L’opération Peek sur une file d’attente ou un abonnement retourne le plus grand nombre de messages demandé. Le tableau suivant indique les types de messages retournés par l’opération Peek.

Type de message Inclus ?
Messages actifs Oui
Messages de lettres mortes Non
Messages verrouillés Oui
Messages arrivés à expiration Peut être (avant mise en file d’attente des messages non distribués)
Messages planifiés Oui pour les files d’attente. Non pour les abonnements

Messages de lettres mortes

Pour afficher un aperçu des messages non distribués mis en file d’attente d’une file d’attente ou d’un abonnement, l’opération Peek doit être exécutée sur la file d’attente des messages non distribués associée à la file d’attente ou à l’abonnement. Pour plus d’informations, consultez Accès aux files d’attente de messages non distribués.

Messages arrivés à expiration

Les messages arrivés à expiration peuvent être inclus dans les résultats retournés par l’opération Peek. Les messages utilisés et arrivés à expiration sont nettoyés par une exécution « nettoyage de la mémoire » asynchrone. Cette étape ne se produit pas nécessairement immédiatement après l’expiration des messages. C’est la raison pour laquelle une opération Peek peut renvoyer des messages qui ont déjà expiré. Ces messages seront supprimés ou mis en file d’attente de lettres mortes la prochaine fois qu’une opération de réception sera appelée sur la file d’attente ou l’abonnement. Gardez ce comportement à l’esprit lorsque vous tentez de récupérer des messages différés de la file d’attente.

Un message arrivé à expiration n’est plus éligible pour la récupération normale par d’autres moyens, même quand il est retourné par Peek. Le renvoi de ces messages est délibéré, car Peek est un outil de diagnostic reflétant l’état actuel du journal.

Messages verrouillés

Peek renvoie également les messages qui ont été verrouillés et qui sont actuellement traités par d’autres destinataires. Toutefois, étant donné que Peek renvoie un instantané déconnecté, l’état de verrou d’un message ne peut pas être observé sur des messages aperçus.

API de l’outil Peek

Peek fonctionne sur les files d’attente, les abonnements et leurs files d’attente de messages non distribués respectives.

Lorsqu’elle est appelée à plusieurs reprises, l’opération Peek énumère tous les messages de la file d’attente ou de l’abonnement, du plus petit numéro de séquence disponible au plus grand. C’est l’ordre dans lequel les messages ont été empilés, et non l’ordre dans lequel ils peuvent être récupérés au final.

Vous pouvez également transmettre un SequenceNumber à une opération Peek. Il permet de déterminer où commencer l’aperçu. Vous pouvez effectuer des appels ultérieurs à l’opération Peek sans spécifier le paramètre à énumérer.

Étapes suivantes

Essayez les exemples dans le langage de votre choix pour explorer les fonctionnalités d’Azure Service Bus.

Recherchez des exemples pour les anciennes bibliothèques clientes .NET et Java ci-dessous :