sysmail_help_queue_sp (Transact-SQL)

  • Artigo

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)

Conteúdo relacionado