Compartilhar via

sp_update_alert (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server

Atualiza as configurações de um alerta existente.

Convenções de sintaxe de Transact-SQL

Sintaxe

sp_update_alert
    [ @name = ] N'name'
    [ , [ @new_name = ] N'new_name' ]
    [ , [ @enabled = ] enabled ]
    [ , [ @message_id = ] message_id ]
    [ , [ @severity = ] severity ]
    [ , [ @delay_between_responses = ] delay_between_responses ]
    [ , [ @notification_message = ] N'notification_message' ]
    [ , [ @include_event_description_in = ] include_event_description_in ]
    [ , [ @database_name = ] N'database_name' ]
    [ , [ @event_description_keyword = ] N'event_description_keyword' ]
    [ , [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @occurrence_count = ] occurrence_count ]
    [ , [ @count_reset_date = ] count_reset_date ]
    [ , [ @count_reset_time = ] count_reset_time ]
    [ , [ @last_occurrence_date = ] last_occurrence_date ]
    [ , [ @last_occurrence_time = ] last_occurrence_time ]
    [ , [ @last_response_date = ] last_response_date ]
    [ , [ @last_response_time = ] last_response_time ]
    [ , [ @raise_snmp_trap = ] raise_snmp_trap ]
    [ , [ @performance_condition = ] N'performance_condition' ]
    [ , [ @category_name = ] N'category_name' ]
    [ , [ @wmi_namespace = ] N'wmi_namespace' ]
    [ , [ @wmi_query = ] N'wmi_query' ]
[ ; ]

Argumentos

@name [ = ] N'nome'

O nome do alerta a ser atualizado. @name é sysname, sem padrão.

@new_name [ = ] N'new_name'

Um nome novo para o alerta. O nome deve ser exclusivo. @new_name é sysname, com um padrão de NULL.

@enabled [ = ] habilitado

Especifica se o alerta está habilitado (1) ou não habilitado (0). @enabled é tinyint, com um padrão de NULL. Um alerta deve estar habilitado para ser disparado.

@message_id [ = ] message_id

Uma mensagem nova ou número de erro para a definição alerta. Normalmente, message_id corresponde a um número de erro na tabela sysmessages. @message_id é int, com um padrão de NULL. Uma ID de mensagem só poderá ser usada se a configuração de nível de gravidade do alerta for 0.

@severity [ = ] gravidade

Um novo nível de gravidade (de a 25) para a definição de 1 alerta. Qualquer mensagem do SQL Server enviada para o log de aplicativos do Windows com a gravidade especificada ativa o alerta. @severity é int, com um padrão de NULL. Um nível de gravidade só poderá ser usado se a configuração de ID da mensagem para o alerta for 0.

@delay_between_responses [ = ] delay_between_responses

O novo período de espera, em segundos, entre respostas ao alerta. @delay_between_responses é int, com um padrão de NULL.

@notification_message [ = ] N'notification_message'

O texto revisado de uma mensagem adicional enviada ao operador como parte da notificação de email, envio de rede ou pager. @notification_message é nvarchar(512), com um padrão de NULL.

@include_event_description_in [ = ] include_event_description_in

Especifica se a descrição do erro do SQL Server do log de aplicativos do Windows deve ser incluída na mensagem de notificação. @include_event_description_in é tinyint e pode ser um ou mais desses valores.

Valor Descrição
0 Nenhum
1 Email
2 Pager
4 net send
7 Tudo

@database_name [ = ] N'database_name'

O nome do banco de dados no qual o erro deve ocorrer para que o alerta seja acionado. @database_name é sysname, com um padrão de NULL. Nomes entre colchetes ([]) não são permitidos.

@event_description_keyword [ = ] N'event_description_keyword'

Uma sequência de caracteres que deve ser encontrada na descrição do erro do SQL Server no log de mensagens de erro. @event_description_keyword é nvarchar(100), com um padrão de NULL. Esse parâmetro é útil para filtrar nomes de objetos (por exemplo, customer_table).

Observação

Os caracteres de correspondência de padrões de expressão Transact-SQL LIKE não podem ser usados.

@job_id [ = ] 'job_id'

@job_id é uniqueidentifier, com um padrão de NULL.

@job_name [ = ] N'job_name'

O número de identificação do trabalho. @job_name é sysname, com um padrão de NULL. Se job_id for especificado, job_name deverá ser omitido.

@occurrence_count [ = ] occurrence_count

Redefine o número de vezes em que o alerta ocorreu. @occurrence_count é int, com um padrão de NULL, e só pode ser definido como 0.

@count_reset_date [ = ] count_reset_date

Redefine a data em que a contagem de ocorrências foi redefinida pela última vez. @count_reset_date é int, com um padrão de NULL.

@count_reset_time [ = ] count_reset_time

Redefine a hora em que a contagem de ocorrências foi redefinida pela última vez. @count_reset_time é int, com um padrão de NULL.

@last_occurrence_date [ = ] last_occurrence_date

Redefine a data em que o alerta ocorreu pela última vez. @last_occurrence_date é int, com um padrão de NULL, e pode ser definido apenas como 0.

@last_occurrence_time [ = ] last_occurrence_time

Redefine a hora em que o alerta ocorreu pela última vez. @last_occurrence_time é int, com um padrão de NULLe pode ser definido apenas como 0.

@last_response_date [ = ] last_response_date

Redefine a data em que o alerta foi respondido pela última vez pelo serviço SQLServerAgent. @last_response_date é int, com um padrão de NULL, e pode ser definido apenas como 0.

@last_response_time [ = ] last_response_time

Redefine a hora em que o alerta foi respondido pela última vez pelo serviço SQLServerAgent. @last_response_time é int, com um padrão de NULL, e pode ser definido apenas como 0.

@raise_snmp_trap [ = ] raise_snmp_trap

Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.

@performance_condition [ = ] N'performance_condition'

Um valor expresso no formato <itemcomparatorvalue>. @performance_condition é nvarchar(512) e consiste nos seguintes elementos.

Elemento Format Descrição
Item Um objeto de desempenho, contador de desempenho ou instância nomeada do contador
Comparador Um destes operadores: >, <, =
Valor Valor numérico do contador

@category_name [ = ] N'category_name'

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

@wmi_namespace [ = ] N'wmi_namespace'

O namespace WMI para consulta de eventos. @wmi_namespace é sysname, com um padrão de NULL.

@wmi_query [ = ] N'wmi_query'

A consulta que especifica o evento WMI do alerta. @wmi_query é nvarchar(512), com um padrão de NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

Somente sysmessages gravado no log de aplicativos do Windows pode disparar um alerta.

sp_update_alert altera apenas as configurações de alerta para as quais os valores de parâmetro são fornecidos. Se um parâmetro for omitido, a configuração atual será retida.

Permissões

Para executar esse procedimento armazenado, os usuários devem ser membros da função de servidor fixa sysadmin .

Exemplos

O exemplo a seguir altera a configuração habilitada de Test Alert para 0.

USE msdb;
GO

EXEC dbo.sp_update_alert
    @name = N'Test Alert',
    @enabled = 0;
GO

Conteúdo relacionado