Compartilhar via


sp_update_alert (Transact-SQL)

Atualiza as configurações de um alerta existente.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

sp_update_alert 
     [ @name =] 'name' 
     [ , [ @new_name =] 'new_name'] 
     [ , [ @enabled =] enabled] 
     [ , [ @message_id =] message_id] 
     [ , [ @severity =] severity] 
     [ , [ @delay_between_responses =] delay_between_responses] 
     [ , [ @notification_message =] 'notification_message'] 
     [ , [ @include_event_description_in =] include_event_description_in] 
     [ , [ @database_name =] 'database'] 
     [ , [ @event_description_keyword =] 'event_description_keyword'] 
     [ , [ @job_id =] job_id | [@job_name =] '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 =] 'performance_condition' ] 
     [ , [ @category_name =] 'category']
     [ , [ @wmi_namespace = ] 'wmi_namespace' ]
     [ , [ @wmi_query = ] 'wmi_query' ]

Argumentos

  • [ @name =] 'name'
    O nome do alerta que será atualizado. name é sysname, sem padrão.

  • [ @new_name =] 'new_name'
    Um nome novo para o alerta. O nome da deve ser exclusivo. new_name é sysname, com um padrão de NULL.

  • [ @enabled =] enabled
    Especifica se o alerta está habilitado (1) ou desabilitado (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. Em geral, 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 usada apenas se a configuração do nível de gravidade do alerta for 0.

  • [ @severity =] severity
    Um novo nível de gravidade (de 1 a 25) para definição do alerta. Qualquer mensagem do Microsoft SQL Server enviada ao log de aplicativos do Windows a gravidade indicada ativará o alerta. severity é int, com um padrão de NULL. Um nível de gravidade pode ser usado apenas se a configuração da ID de mensagem do 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 =] 'notification_message'
    O texto revisado de uma mensagem adicional opcional enviada ao operador como parte da notificação de email, net send 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 deve do log de aplicativos do Windows deve ser incluída como na mensagem de notificação. include_event_description_in é tinyint, com um padrão de NULL, podendo ser um ou mais desses valores.

    Valor

    Descrição

    0

    Nenhum

    1

    Email

    2

    Pager

    4

    net send

    7

    Todos

  • [ @database_name =] 'database'
    O nome do banco de dados no qual o erro deve ocorrer para que o alerta seja acionado. database é sysname. Não são permitidos nomes entre colchetes ([ ]). O valor padrão é NULL.

  • [ @event_description_keyword =] 'event_description_keyword'
    Uma cadeia de caracteres que deve ser localizada na descrição do erro no log de mensagens de erro. Os caracteres correspondentes ao padrão da expressão Transact-SQL LIKE podem ser usados. event_description_keyword é nvarchar(100), com um padrão de NULL. Esse parâmetro é útil para filtrar nomes de objeto (por exemplo, %customer_table%).

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

  • [ @job_name =] 'job_name'
    O nome do trabalho executado em resposta a esse alerta. job_name é sysname, com um padrão de NULL. Se job_name for especificado, job_id deverá ser omitido.

  • [ @occurrence_count = ] occurrence_count
    Redefine o número de vezes que o alerta ocorreu. occurrence_count é int, com um padrão de NULL e pode ser definido somente como 0.

  • [ @count_reset_date =] count_reset_date
    Redefine a data da última vez em que ocorreu uma redefinição da contagem. count_reset_date é int, com um padrão de NULL.

  • [ @count_reset_time =] count_reset_time
    Redefine a hora da última vez em que ocorreu uma redefinição da contagem. count_reset_time é int, com um padrão de NULL.

  • [ @last_occurrence_date =] last_occurrence_date
    Redefine a data em que o alerta ocorreu. last_occurrence_date é int, com um padrão de NULL e pode ser definido somente como 0.

  • [ @last_occurrence_time =] last_occurrence_time
    Redefine a hora em que o alerta ocorreu. last_occurrence_time é int, com um padrão de NULL e pode ser definido somente como 0.

  • [ @last_response_date =] last_response_date
    Redefine a data em que o alerta obteve sua última resposta do serviço SQLServerAgent. last_response_date é int, com um padrão de NULL e pode ser definido somente como 0.

  • [ @last_response_time =] last_response_time
    Redefine a hora em que obteve a última resposta do serviço SQLServerAgent. last_response_time é int, com um padrão de NULL e pode ser definido somente como 0.

  • [ @raise_snmp_trap =] raise_snmp_trap
    Reservada.

  • [ @performance_condition =] 'performance_condition'
    Um valor expresso no formato 'itemcomparatorvalue'. performance_condition é nvarchar(512), com um padrão NULL e composto por estes elementos.

    Elemento do formato

    Descrição

    Item

    Um objeto de desempenho, contador de desempenho ou instância nomeada do contador.

    Comparator

    Um destes operadores: >, <, =

    Value

    Valor numérico do contador.

  • [ @category_name =] 'category'
    O nome da categoria do alerta. category é sysname, com um padrão de NULL.

  • [ @wmi_namespace= ] 'wmi_namespace'
    O namespace WMI no qual examinar a existência de eventos. wmi_namespace é sysname, com um padrão de NULL.

  • [ @wmi_query= ] 'wmi_query'
    A consulta que especifica o evento WMI para o alerta. wmi_query é nvarchar(512), com um padrão de NULL.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

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

sp_update_alert altera somente as configurações de alerta para as quais são fornecidos valores de parâmetro. 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