sp_update_alert (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 MicrosoftSQL 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

Consulte também

Referência