• Artigo

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.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sysmail_help_queue_sp  [ @queue_type = ] 'queue_type'

Argumentos

  • [ @queue_type = ] 'queue_type'
    Argumento opcional exclui emails do tipo especificado como o queue_type. queue_type é nvarchar(6) sem nenhum 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.

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 (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)