sysmail_help_queue_sp (Transact-SQL)
Aplica-se a: 
SQL Server
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.
Convenções de sintaxe de 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 do código de retorno
0 (sucesso) ou 1 (falha).
Conjunto de resultados
| Nome da coluna | Tipo de dados | Descrição |
|---|---|---|
queue_type |
nvarchar(6) | O tipo de fila. Os valores possíveis são mail e status. |
length |
int | O número de itens de email na fila especificada. |
state |
nvarchar(64) | Estado do monitor. Os valores possíveis são INACTIVE (fila está inativa), NOTIFIED (a fila foi notificada de recebimento para ocorrer) e RECEIVES_OCCURRING (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 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.
EXEC 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)