Partager via


sysmail_help_queue_sp (Transact-SQL)

S'applique à : SQL Server

Il existe deux files d'attente dans la messagerie de base de données : la file d'attente des messages et la file d'attente des états. La file d'attente des messages stocke les éléments de messagerie en attente d'envoi. La file d’attente d’état stocke l’état des éléments qui ont déjà été envoyés. Cette procédure stockée permet d'afficher l'état de la file d'attente des messages ou des états. Si le paramètre @queue_type n’est pas spécifié, la procédure stockée retourne une ligne pour chacune des files d’attente.

Conventions de la syntaxe Transact-SQL

Syntaxe

sysmail_help_queue_sp [ @queue_type = ] 'queue_type'
[ ; ]

Arguments

[ @queue_type = ] 'queue_type'

L’argument facultatif supprime les e-mails du type spécifié comme @queue_type. @queue_type est nvarchar(6) sans valeur par défaut. Les entrées valides sont mail et *status.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Jeu de résultats

Nom de la colonne Type de données Description
queue_type nvarchar(6) Type de file d'attente. Les valeurs possibles sont mail et status.
length int Nombre d'éléments de messagerie dans la file d'attente spécifiée.
state nvarchar(64) État du moniteur. Les valeurs possibles sont INACTIVE (la file d’attente est inactive), NOTIFIED (la réception de la file d’attente a été avertie) et RECEIVES_OCCURRING (la file d’attente reçoit).
last_empty_rowset_time datetime Date et heure à laquelle la file d'attente était vide pour la dernière fois. Au format de temps militaire, et fuseau horaire GMT.
last_activated_time datetime Date et heure de la dernière activation de la file d'attente. Au format de temps militaire, et fuseau horaire GMT.

Notes

Lors de la résolution des problèmes liés à la messagerie de base de données, utilisez cette option sysmail_help_queue_sp pour voir combien d’éléments se trouvent dans la file d’attente, l’état de la file d’attente et le moment où il a été activé pour la dernière fois.

autorisations

Nécessite l'autorisation CONTROL SERVER sur le serveur.

Exemples

L'exemple suivant renvoie la file d'attente des messages ainsi que celle des états.

EXECUTE msdb.dbo.sysmail_help_queue_sp;
GO

Voici un exemple de jeu de résultats qui a été modifié pour la longueur.

queue_type length      state              last_empty_rowset_time  last_activated_time
---------- -------- ------------------ ----------------------- -----------------------
mail       0        RECEIVES_OCCURRING 2005-10-07 21:14:47.010 2005-10-10 20:52:51.517
status     0        INACTIVE           2005-10-07 21:04:47.003 2005-10-10 21:04:47.003

(2 row(s) affected)