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 des états 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) ou 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. Format 24 heures et fuseau horaire GMT. |
last_activated_time |
datetime | Date et heure de la dernière activation de la file d'attente. Format 24 heures 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
Par défaut, seuls les membres du rôle serveur fixe sysadmin peuvent accéder à cette procédure.
Exemples
L'exemple suivant renvoie la file d'attente des messages ainsi que celle des états.
EXEC msdb.dbo.sysmail_help_queue_sp;
GO
Il s'agit d'un exemple de jeu de résultats qui a été remis en forme pour des raisons de 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)