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. Die Angabe erfolgt im 24-Stunden-Format und in der GMT-Zeitzone. |
last_activated_time |
datetime | Das Datum und die Uhrzeit, an dem bzw. zu der die Warteschlange zuletzt aktiviert war. Die Angabe erfolgt im 24-Stunden-Format und in der 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
Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin auf diese Prozedur zugreifen.
Beispiele
Das folgende Beispiel gibt sowohl die E-Mail- als auch die Statuswarteschlange zurück.
EXEC msdb.dbo.sysmail_help_queue_sp;
GO
Dies ist ein Beispielresultset, das auf Zeilenlänge umformatiert 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)