sp_update_alert (Transact-SQL)

Atualiza as configurações de um alerta existente.

Convenções da 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 a ser atualizado. name é sysname, sem padrão.

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

• [ @enabled =] enabled
  Especifica se o alerta está habilitado (1) ou não habilitado (0). enabled é tinyint, com um padrão 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 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 aplicativo do Windows com a gravidade especificada ativará o alerta. severity é int, com um padrão 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 NULL.

• [ @notification_message =] 'notification_message'
  O texto revisado de uma mensagem adicional enviada ao operador como parte do email, net send ou notificação de pager. notification_message é nvarchar(512), com um padrão NULL.

• [ @include_event_description_in =] include_event_description_in
  Especifica se a descrição do erro do SQL Server a partir do log de aplicativo do Windows deve ser incluída na mensagem de notificação. include_event_description_in é tinyint, com um padrão NULL, e pode ser um ou mais desses valores.

  Value	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. Nomes entre colchetes ([ ]) não são permitidos. 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 LIKE do Transact-SQL podem ser usados. event_description_keyword é nvarchar(100), com um padrão 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 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 NULL. Se job_name for especificado, job_id 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 NULL, e pode ser definido somente 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 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 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 NULL, e pode ser definido somente 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 NULL, e pode ser definido somente 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 NULL, e pode ser definido somente 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 NULL, e pode ser definido somente como 0.

• [ @raise_snmp_trap =] raise_snmp_trap
  Reservado.

• [ @performance_condition =] 'performance_condition'
  É um valor é expresso no formato 'itemcomparatorvalue'. performance_condition é nvarchar(512), com um padrão NULL, e consiste nestes elementos.

  Elemento Format	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 NULL.

• [ @wmi_namespace= ] 'wmi_namespace'
  O namespace WMI para consulta de eventos. wmi_namespace é sysname, com um padrão NULL.

• [ @wmi_query= ] 'wmi_query'
  A consulta que especifica o evento WMI do alerta. wmi_query é nvarchar(512), com um padrão 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

Consulte também

Referência

sp_add_alert (Transact-SQL)

sp_help_alert (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)