sysmail_help_queue_sp (Transact-SQL)

  • Artikel

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)

Zugehöriger Inhalt