sp_update_alert (Transact-SQL)

Actualiza la configuración de una alerta existente.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

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'
    Nombre de la alerta que se va a actualizar. name es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @new_name =] 'new_name'
    Nuevo nombre para la alerta. El nombre debe ser único. new_name es de tipo sysname y su valor predeterminado es NULL.

  • [ @enabled =] enabled
    Especifica si la alerta está habilitada (1) o no habilitada (0). enabled es de tipo tinyint y su valor predeterminado es NULL. Para poder activar una alerta, ésta debe estar habilitada.

  • [ @message_id =] message_id
    Nuevo mensaje o número de error para la definición de la alerta. Normalmente, message_id corresponde a un número de error de la tabla sysmessages . message_id es de tipo int y su valor predeterminado es NULL. Un Id. de mensaje sólo se puede utilizar si el valor del nivel de gravedad de la alerta es 0.

  • [ @severity =] severity
    Nuevo nivel de gravedad (de 1 a 25) para la definición de la alerta. Cualquier mensaje de MicrosoftSQL Server enviado al registro de aplicación de Windows que tenga la gravedad especificada activará la alerta. severity es de tipo int y su valor predeterminado es NULL. Un nivel de gravedad sólo puede utilizarse si el valor de Id. de mensaje para la alerta es 0.

  • [ @delay_between_responses =] delay_between_responses
    Nuevo período de espera, en segundos, entre las respuestas a la alerta. delay_between_responses es de tipo int y su valor predeterminado es NULL.

  • [ @notification_message =] 'notification_message'
    Texto revisado de un mensaje adicional que se envía al operador como parte de la notificación por correo electrónico, net send o localizador. notification_message es de tipo nvarchar(512) y su valor predeterminado es NULL.

  • [ @include_event_description_in =] include_event_description_in
    Especifica si se debe incluir en el mensaje de notificación la descripción del error de SQL Server que se encuentra en el registro de aplicación de Windows. include_event_description_in es de tipo tinyint, su valor predeterminado es NULL, y puede tener uno o varios de estos valores.

    Valor

    Descripción

    0

    Ninguna

    1

    Correo electrónico

    2

    Localizador

    4

    net send

    7

    Todas

  • [ @database_name =] 'database'
    Nombre de la base de datos en la que debe producirse el error para que se active la alerta. database es de tipo sysname. No se permiten nombres incluidos entre corchetes ([]). El valor predeterminado es NULL.

  • [ @event_description_keyword =] 'event_description_keyword'
    Secuencia de caracteres que debe encontrarse en la descripción del error en el registro de mensajes de error. Se pueden usar caracteres de coincidencia de patrón de la expresión LIKE de Transact-SQL. event_description_keyword es de tipo nvarchar(100) y su valor predeterminado es NULL. Este parámetro resulta útil para filtrar nombres de objeto (por ejemplo, %customer_table%).

  • [ @job_id =] job_id
    Número de identificación del trabajo. job_id es de tipo uniqueidentifier y su valor predeterminado es NULL. Si se especifica job_id, se debe omitir job_name.

  • [ @job_name =] 'job_name'
    Nombre del trabajo que se ejecuta como respuesta a esta alerta. job_name es de tipo sysname y su valor predeterminado es NULL. Si se especifica job_name, se debe omitir job_id.

  • [ @occurrence_count = ] occurrence_count
    Restablece el número de veces que se ha producido la alerta. occurrence_count es de tipo int, su valor predeterminado es NULL, y sólo se puede establecer en 0.

  • [ @count_reset_date =] count_reset_date
    Restablece la fecha en la que se restableció por última vez el recuento de repeticiones. count_reset_date es de tipo int y su valor predeterminado es NULL.

  • [ @count_reset_time =] count_reset_time
    Restablece la hora en la que se restableció por última vez el recuento de repeticiones. count_reset_time es de tipo int y su valor predeterminado es NULL.

  • [ @last_occurrence_date =] last_occurrence_date
    Restablece la fecha en la que la alerta se produjo por última vez. last_occurrence_date es de tipo int, su valor predeterminado es NULL, y sólo se puede establecer en 0.

  • [ @last_occurrence_time =] last_occurrence_time
    Restablece la hora en la que la alerta se produjo por última vez. last_occurrence_time es de tipo int, su valor predeterminado es NULL, y sólo se puede establecer en 0.

  • [ @last_response_date =] last_response_date
    Restablece la fecha de la última respuesta del servicio SQLServerAgent a la alerta. last_response_date es de tipo int, su valor predeterminado es NULL, y sólo se puede establecer en 0.

  • [ @last_response_time =] last_response_time
    Restablece la hora de la última respuesta del servicio SQLServerAgent a la alerta. last_response_time es de tipo int, su valor predeterminado es NULL, y sólo se puede establecer en 0.

  • [ @raise_snmp_trap =] raise_snmp_trap
    Reservado.

  • [ @performance_condition =] 'performance_condition'
    Valor expresado en formato 'itemcomparatorvalue'. performance_condition es de tipo nvarchar(512), su valor predeterminado es NULL, y consta de estos elementos.

    Elemento de formato

    Descripción

    Item

    Objeto de rendimiento, contador de rendimiento o instancia con nombre del contador.

    Comparator

    Uno de estos operadores: >, <, =.

    Value

    Valor numérico del contador.

  • [ @category_name =] 'category'
    Nombre de la categoría de alerta. category es de tipo sysname y su valor predeterminado es NULL.

  • [ @wmi_namespace= ] 'wmi_namespace'
    Espacio de nombres WMI para consultar eventos. wmi_namespace es de tipo sysname y su valor predeterminado es NULL.

  • [ @wmi_query= ] 'wmi_query'
    Consulta que especifica el evento WMI para la alerta. wmi_query es de tipo nvarchar(512) y su valor predeterminado es NULL.

Valores de código de retorno

0 (correcto) o 1 (error)

Notas

Sólo sysmessages (los mensajes del sistema) escritos en el registro de aplicación de Microsoft Windows pueden activar una alerta.

sp_update_alert sólo cambia los valores de alerta para los que se proporcionan valores de parámetros. Si se omite un parámetro, se conserva la configuración actual.

Permisos

Para ejecutar este procedimiento almacenado, el usuario debe ser miembro de la función fija de servidor sysadmin.

Ejemplos

En el ejemplo siguiente se cambia el valor de habilitación de Test Alert a 0.

USE msdb ;
GO

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