Compartilhar via

sp_help_alert (Transact-SQL)

  • Artigo

Aplica-se: SQL Server

Relata informações sobre os alertas definidos para o servidor.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_help_alert
    [ [ @alert_name = ] N'alert_name' ]
    [ , [ @order_by = ] N'order_by' ]
    [ , [ @alert_id = ] alert_id ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @legacy_format = ] legacy_format ]
[ ; ]

Argumentos

@alert_name [ = ] N'alert_name'

O nome do alerta. @alert_name é sysname, com um padrão de NULL. Se @alert_name não for especificado, as informações sobre todos os alertas serão retornadas.

@order_by [ = ] N'order_by'

A ordem de classificação a ser usada para produzir os resultados. @order_by é sysname, com um padrão do @alert_name.

@alert_id [ = ] alert_id

O número de identificação do alerta sobre o qual relatar informações. @alert_id é int, com um padrão de NULL.

@category_name [ = ] N'category_name'

A categoria do alerta. @category_name é sysname, com um padrão de NULL.

@legacy_format [ = ] legacy_format

Especifica se um conjunto de resultados herdado deve ser produzido. @legacy_format é bit, com um padrão de 0. Quando @legacy_format é 1, sp_help_alert retorna o conjunto de resultados retornado por sp_help_alert no SQL Server 2000 (8.x).

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto de resultados

Esta tabela mostra a saída somente quando @legacy_format é 0, para SQL Server 2005 (9.x) e versões posteriores.

Nome da coluna Tipo de dados Descrição
id int Identificador inteiro exclusivo atribuído pelo sistema.
name sysname Nome do alerta (por exemplo, Demo: Full msdb log).
event_source nvarchar(100) Origem do evento.
event_category_id int Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.
event_id int Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.
message_id int Número de erro de mensagem que define o alerta. (Geralmente corresponde a um número de erro na sysmessages tabela). Se a severidade for usada para definir o alerta, message_id é 0 ou NULL.
severity int Nível de gravidade (de 9 até 25, 110, , 130120, ou 140) que define o alerta.
enabled tinyint Status de se o alerta está habilitado no momento (1) ou não (0). Um alerta não habilitado não é enviado.
delay_between_responses int Período de espera, em segundos, entre respostas ao alerta.
last_occurrence_date int Data em que o alerta ocorreu pela última vez.
last_occurrence_time int Hora em que o alerta ocorreu pela última vez.
last_response_date int Data em que o alerta foi respondido pela última vez pelo serviço SQL Server Agent.
last_response_time int Hora em que o alerta foi respondido pela última vez pelo serviço SQL Server Agent.
notification_message nvarchar(512) Mensagem adicional opcional enviada ao operador como parte do email ou notificação de pager.
include_event_description tinyint Define se a descrição do erro do SQL Server a partir do log de aplicativos do Microsoft Windows deve ser incluída como parte da mensagem de notificação.
database_name sysname Banco de dados no qual o erro deve acontecer para que o alerta seja acionado. Se o nome do banco de dados for NULL, o alerta será acionado independentemente de onde o erro ocorreu.
event_description_keyword nvarchar(100) Descrição do erro do SQL Server no log de aplicativos do Windows que deve ser como a sequência de caracteres fornecida.
occurrence_count int Número de vezes que o alerta ocorreu.
count_reset_date int Data em que foi occurrence_count redefinido pela última vez.
count_reset_time int Hora em que foi occurrence_count redefinido pela última vez.
job_id uniqueidentifier Número de identificação do trabalho a ser executado em resposta a um alerta.
job_name sysname Nome do trabalho a ser executado em resposta a um alerta.
has_notification int Diferente de zero se um ou mais operadores forem notificados para este alerta. O valor é um ou mais dos seguintes valores (ORed juntos):

1 = tem notificação por e-mail
2 = tem notificação de pager
4 = tem notificação de envio líquido.
flags int Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.
performance_condition nvarchar(512) Se type for 2, esta coluna mostra a definição da condição de desempenho; caso contrário, a coluna é NULL.
category_name sysname Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida. Será [Uncategorized] sempre para o SQL Server 7.0.
wmi_namespace sysname Se type for 3, esta coluna mostra o namespace para o evento WMI.
wmi_query nvarchar(512) Se type for 3, esta coluna mostra a consulta para o evento WMI.
type int Tipo do evento:

1 = Alerta de evento do SQL Server
2 = Alerta de desempenho do SQL Server
3 = alerta de evento WMI

Comentários

sp_help_alert deve ser executado a partir do msdb banco de dados.

Permissões

Você pode conceder EXECUTE permissões nesse procedimento, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Outros usuários devem receber uma das seguintes funções de banco de dados fixas do msdb SQL Server Agent no banco de dados:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Para obter detalhes sobre as permissões dessas funções, consulte Funções de banco de dados fixas do SQL Server Agent.

Exemplos

O exemplo a seguir relata informações sobre o alerta Demo: Sev. 25 Errors.

USE msdb;
GO

EXEC sp_help_alert @alert_name = 'Demo: Sev. 25 Errors';
GO

Conteúdo relacionado