sp_help_alert (Transact-SQL)

  • Artigo

Aplica-se a: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 é nvarchar(128). 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'categoria'

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

@legacy_format [ = ] legacy_format

Se deve produzir um conjunto de resultados legado. @legacy_format é bit, com um padrão de 0. Quando @legacy_format é 1, sp_help_alert retorna o conjunto de resultados retornado pelo sp_help_alert SQL Server 2000 (8.x).

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto 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.
name sysname Nome do alerta (por exemplo, Demonstração: log completo msdb ).
event_source nvarchar(100) Origem do evento. Será MSSQLServer sempre para o Microsoft SQL Server versão 7.0
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 severidade (de 9 até 25, 110, , 130120ou 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 A 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 da occurrence_count última redefinição.
count_reset_time int Hora em que foi occurrence_count reiniciado 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 net send notificação.
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 será NULL.
category_name sysname Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida. Sempre será '[Uncategorized]' para 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

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.
name sysname Nome do alerta (por exemplo, Demonstração: log completo msdb ).
event_source nvarchar(100) Origem do evento. Será sempre MSSQLServer para o SQL Server versão 7.0
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 severidade (de 9 até 25, 110, , 130120ou 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 A 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 É se a descrição do erro do SQL Server do log de aplicativo 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 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 da occurrence_count última redefinição.
count_reset_time int Hora em que foi occurrence_count reiniciado 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 por e-mail
2=tem notificação de pager
4=tem net send notificação.
flags int Identificado apenas para fins informativos. Sem suporte. A compatibilidade futura não é garantida.
performance_condition nvarchar(512) Se type for 2, esta coluna mostra a definição da condição de desempenho. Se type for 3, esta coluna mostra a consulta para o evento WMI. Caso contrário, a coluna será NULL.
category_name sysname Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida. Será sempre [Uncategorized] para o SQL Server 7.0.
type 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 msdb banco de dados.

Permissões

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

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

Conteúdo relacionado