sp_help_alert (Transact-SQL)

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

Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

• [ @alert_name =] 'alert_name'
  O nome do alerta. alert_name é nvarchar(128). Se o alert_name não for especificado, serão retornadas informações sobre todos os alertas.

• [ @order_by =] 'order_by'
  A ordem de classificação a ser usada para produzir os resultados. order_byé sysname, com um padrão de N '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 =] 'category'
  A categoria do alerta. category é sysname, com um padrão de NULL.

• [ @legacy_format=] legacy_format
  Especifica se um conjunto de resultados legado deve ser produzido. legacy_format é bit, com um padrão de 0. Quando legacy_format for 1, sp_help_alert retornará o conjunto de resultados retornado por sp_help_alert no Microsoft SQL Server 2000.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Quando @legacy_format é 0, sp_help_alert produz o seguinte conjunto de resultados.

Nome da coluna	Tipo de dados	Descrição
id	int	Identificador inteiro exclusivo atribuído pelo sistema.
nome	sysname	Nome do alerta (por exemplo, Demonstração: log completo do msdb).
event_source	nvarchar(100)	Origem do evento. Sempre será MSSQLServer para o Microsoft SQL Server versão 7.0
event_category_id	int	Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.
event_id	int	Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.
message_id	int	Número de erro de mensagem que define o alerta. (Normalmente corresponde a um número de erro na tabela sysmessages). Se for usada gravidade para definir o alerta, message_id será 0 ou NULL.
severidade	int	Nível de gravidade (de 9 a 25, 110, 120, 130 ou 140) que define o alerta.
habilitado	tinyint	Status que define se o alerta está atualmente habilitado (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 SQLServerAgent.
last_response_time	int	Hora em que o alerta foi respondido pela última vez pelo serviço SQLServerAgent.
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 de 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 occurrence_count foi redefinido pela última vez.
count_reset_time	int	Hora em que occurrence_count foi 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 (unidos por OR): 1= tem notificação de email 2= tem notificação de pager 4= tem notificação de net send.
flags	int	Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.
performance_condition	nvarchar(512)	Se type for 2, esta coluna mostrará a definição da condição de desempenho; caso contrário, a coluna será NULL.
category_name	sysname	Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida. sempre será '[Uncategorized]' para o SQL Server 7.0.
wmi_namespace	sysname	Se type for 3, esta coluna mostrará o namespace do evento WMI.
wmi_query	nvarchar(512)	Se type for 3, esta coluna mostrará a consulta do evento WMI.
tipo	int	Tipo do evento: 1 = alerta de evento do SQL Server 2 = alerta de desempenho do SQL Server 3 = alerta de evento WMI

Quando @legacy_format é 1, sp_help_alert produz o seguinte conjunto de resultados.

Nome da coluna	Tipo de dados	Descrição
id	int	Identificador inteiro exclusivo atribuído pelo sistema.
nome	sysname	Nome do alerta (por exemplo, Demonstração: log completo do msdb).
event_source	nvarchar(100)	Origem do evento. Sempre será MSSQLServer para o SQL Server versão 7.0
event_category_id	int	Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.
event_id	int	Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida.
message_id	int	Número de erro de mensagem que define o alerta. (Normalmente corresponde a um número de erro na tabela sysmessages). Se for usada gravidade para definir o alerta, message_id será 0 ou NULL.
severidade	int	Nível de gravidade (de 9 a 25, 110, 120, 130 ou 140) que define o alerta.
habilitado	tinyint	Status que define se o alerta está atualmente habilitado (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 SQLServerAgent.
last_response_time	int	Hora em que o alerta foi respondido pela última vez pelo serviço SQLServerAgent.
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 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 de 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 occurrence_count foi redefinido pela última vez.
count_reset_time	int	Hora em que occurrence_count foi redefinido pela última vez.
job_id	uniqueidentifier	Número de identificação do trabalho.
job_name	sysname	Um trabalho sob demanda 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 (unidos por OR): 1= tem notificação de email 2= tem notificação de pager 4= tem notificação de net send.
flags	int	Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida..
performance_condition	nvarchar(512)	Se type for 2, esta coluna mostrará a definição da condição de desempenho. Se type for 3, esta coluna mostrará a consulta do evento WMI. Caso contrário, a coluna será NULL.
category_name	sysname	Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não está garantida. sempre será '[Uncategorized]' para o SQL Server 7.0.
tipo	int	Tipo de alerta: 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 banco de dados msdb.

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Deve ser concedida a outros usuários a função de banco de dados fixa SQLAgentOperatorRole no banco de dados msdb.

Para obter detalhes sobre SQLAgentOperatorRole, 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

Consulte também

Referência

sp_add_alert (Transact-SQL)

sp_update_alert (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)