sysmail_help_queue_sp (Transact-SQL)
Gilt für: SQL Server
Es gibt zwei Warteschlangen in der Datenbank-E-Mail: die E-Mail-Warteschlange und die Statuswarteschlange. In der E-Mail-Warteschlange werden E-Mail-Elemente gespeichert, die darauf warten, gesendet zu werden. In der Statuswarteschlange wird der Status von Elementen gespeichert, die bereits gesendet wurden. Mit dieser gespeicherten Prozedur können Sie den Status der E-Mail- oder der Statuswarteschlange anzeigen. Wenn der Parameter @queue_type nicht angegeben ist, gibt die gespeicherte Prozedur eine Zeile für jede der Warteschlangen zurück.
Transact-SQL-Syntaxkonventionen
Syntax
sysmail_help_queue_sp [ @queue_type = ] 'queue_type'
[ ; ]
Argumente
[ @queue_type = ] 'queue_type'
Optionales Argument löscht E-Mails des Typs, der als @queue_type angegeben ist. @queue_type ist nvarchar(6) ohne Standard. Gültige Einträge sind mail
und *status
.
Rückgabecodewerte
0
(erfolgreich) oder 1
Fehler.
Resultset
Spaltenname | Datentyp | Beschreibung |
---|---|---|
queue_type |
nvarchar(6) | Der Typ der Warteschlange. Mögliche Werte sind mail und status . |
length |
int | Die Anzahl der E-Mail-Elemente in der angegebenen Warteschlange. |
state |
nvarchar(64) | Der Status des Überwachungsservers. Mögliche Werte sind INACTIVE (Die Warteschlange ist inaktiv), NOTIFIED (die Warteschleife wurde benachrichtigt, dass der Empfang erfolgt) und RECEIVES_OCCURRING (Die Warteschlange empfängt). |
last_empty_rowset_time |
datetime | Das Datum und die Uhrzeit, an dem bzw. zu der die Warteschlange zuletzt leer war. Im Militärischen Zeitformat und gmt Zeitzone. |
last_activated_time |
datetime | Das Datum und die Uhrzeit, an dem bzw. zu der die Warteschlange zuletzt aktiviert war. Im Militärischen Zeitformat und gmt Zeitzone. |
Hinweise
Verwenden Sie sysmail_help_queue_sp
bei der Problembehandlung Datenbank-E-Mail, um zu sehen, wie viele Elemente sich in der Warteschlange befinden, den Status der Warteschlange und wann sie zuletzt aktiviert wurde.
Berechtigungen
Erfordert die CONTROL SERVER
-Berechtigung auf dem Server.
Beispiele
Das folgende Beispiel gibt sowohl die E-Mail- als auch die Statuswarteschlange zurück.
EXECUTE msdb.dbo.sysmail_help_queue_sp;
GO
Hier ist ein Beispiel-Resultset, das für die Länge bearbeitet wurde.
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)