Compartilhar via


sp_help_alert (Transact-SQL)

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

Ícone de vínculo de tópico 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)