sysmail_help_queue_sp (Transact-SQL)
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 renvoie une ligne pour chaque file d'attente.
S'applique à : SQL Server (SQL Server 2008 via la version actuelle). |
.gif "Icône Lien de rubrique")
Conventions de la syntaxe Transact-SQL
Syntaxe
sysmail_help_queue_sp [ @queue_type = ] 'queue_type'
Arguments
- [ @queue_type = ] 'queue_type'
Argument facultatif qui supprime les messages électroniques du type spécifié par le paramètre queue_type. queue_type est de type nvarchar(6) et n'a pas de 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 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 file d'attente a été notifiée que la réception va se produire) et RECEIVES_OCCURRING (la réception est en cours dans la file d'attente). |
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
En cas de dépannage de la messagerie de base de données, utilisez la procédure 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 quand a eu lieu sa dernière activation.
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.
EXECUTE 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)