sysmail_help_queue_sp (Transact-SQL)
Há duas filas no Database Mail: a fila de email e a fila de status. A fila de email armazena itens de email que estão esperando para serem enviados. A fila de status armazena o status de itens que já foram enviados. Este procedimento armazenado permite exibir o estado das filas de email ou de status. Se o parâmetro @queue_type não for especificado, o procedimento armazenado retornará uma linha para cada uma das filas.
.gif "Ícone de vínculo de tópico")
Convenções da sintaxe Transact-SQL
Sintaxe
sysmail_help_queue_sp [ @queue_type = ] 'queue_type'
Argumentos
- [ @queue_type = ] 'queue_type'
O argumento opcional exclui emails do tipo especificado como o queue_type. queue_type é nvarchar(6) sem padrão. As entradas válidas são mail e status.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Conjunto de resultados
Nome da coluna |
Tipo de dados |
Descrição |
|---|---|---|
queue_type |
nvarchar(6) |
O tipo de fila. Possíveis valores são mail e status. |
comprimento |
int |
O número de itens de email na fila especificada. |
state |
nvarchar(64) |
Estado do monitor. Os valores possíveis são INACTIVE (a fila é inativa), NOTIFIED (a fila foi notificada para que o recebimento ocorra) e RECEIVES_OCCURRING (a fila está recebendo). |
last_empty_rowset_time |
DATETIME |
A data e a hora em que a fila estava vazia pela última vez. Em formato de hora militar e fuso horário GMT. |
last_activated_time |
DATETIME |
A data e a hora em que a fila foi ativada pela última vez. Em formato de hora militar e fuso horário GMT. |
Comentários
Ao solucionar problemas do Database Mail, use sysmail_help_queue_sp para ver quantos itens estão na fila, o status da fila e quando ela foi ativada pela última vez.
Permissões
Por padrão, somente os membros da função de servidor fixa sysadmin podem acessar esse procedimento.
Exemplos
O exemplo a seguir retorna as filas de email e de status.
EXECUTE msdb.dbo.sysmail_help_queue_sp ;
GO
Este conjunto de resultados de amostra foi editado para comprimento.
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)