sp_update_alert (Transact-SQL)
Se aplica a: 
SQL Server
Actualiza la configuración de una alerta existente.
Convenciones de sintaxis de Transact-SQL
Sintaxis
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'name'
Nombre de la alerta que se va a actualizar. @name es sysname, sin ningún valor predeterminado.
[ @new_name = ] N'new_name'
Nuevo nombre para la alerta. El nombre debe ser único. @new_name es sysname, con un valor predeterminado de NULL.
[ @enabled = ] enabled
Especifica si la alerta está habilitada (1) o no (0). @enabled es tinyint, con un valor predeterminado de 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 en la tabla sysmessages . @message_id es int, con un valor predeterminado de NULL. Solo se puede usar un identificador de mensaje si la configuración de nivel de gravedad de la alerta es 0.
[ @severity = ] gravedad
Nuevo nivel de gravedad (desde 1 hasta 25) para la definición de alerta. Cualquier mensaje de SQL Server enviado al registro de aplicaciones de Windows con la gravedad especificada activa la alerta. @severity es int, con un valor predeterminado de NULL. Solo se puede usar un nivel de gravedad si la configuración del identificador de mensaje para la alerta es 0.
[ @delay_between_responses = ] delay_between_responses
El nuevo intervalo de espera, en segundos, entre respuestas a la alerta. @delay_between_responses es int, con un valor predeterminado de NULL.
[ @notification_message = ] N'notification_message'
Texto revisado de un mensaje adicional enviado al operador como parte de la notificación de correo electrónico, net send o buscapersonas. @notification_message es nvarchar(512), con un valor predeterminado de NULL.
[ @include_event_description_in = ] include_event_description_in
Especifica si la descripción del error de SQL Server del registro de aplicaciones de Windows debe incluirse en el mensaje de notificación. @include_event_description_in es tinyint y puede ser uno o varios de estos valores.
| Valor | Descripción |
|---|---|
0 |
None |
1 |
Correo electrónico |
2 |
Buscapersonas |
4 |
net send |
7 |
All |
[ @database_name = ] N'database_name'
Nombre de la base de datos en la que debe ocurrir el error para que se active la alerta. @database_name es sysname, con un valor predeterminado de NULL. No se permiten nombres entre corchetes ([]).
[ @event_description_keyword = ] N'event_description_keyword'
Secuencia de caracteres que se deben encontrar en la descripción del error de SQL Server en el registro de mensajes de error. @event_description_keyword es nvarchar(100), con un valor predeterminado de NULL. Este parámetro es útil para filtrar nombres de objeto (por ejemplo, customer_table).
Nota:
No se pueden usar caracteres de coincidencia de patrones de expresión de Transact-SQL LIKE .
[ @job_id = ] 'job_id'
@job_id es uniqueidentifier, con un valor predeterminado de NULL.
[ @job_name = ] N'job_name'
Número de identificación del trabajo. @job_name es sysname, con un valor predeterminado de NULL. Si se especifica job_id , se debe omitir job_name .
[ @occurrence_count = ] occurrence_count
Restablece el número de veces que se ha producido la alerta. @occurrence_count es int, con un valor predeterminado de NULLy solo se puede establecer 0en .
[ @count_reset_date = ] count_reset_date
Restablece la fecha en que el recuento de repeticiones se restableció por última vez. @count_reset_date es int, con un valor predeterminado de NULL.
[ @count_reset_time = ] count_reset_time
Restablece la hora en que el recuento de repeticiones se restableció por última vez. @count_reset_time es int, con un valor predeterminado de NULL.
[ @last_occurrence_date = ] last_occurrence_date
Restablece la fecha en que la alerta se produjo por última vez. @last_occurrence_date es int, con un valor predeterminado de NULLy solo 0se puede establecer en .
[ @last_occurrence_time = ] last_occurrence_time
Restablece la hora en que la alerta se produjo por última vez. @last_occurrence_time es int, con un valor predeterminado de NULLy solo se puede establecer en 0.
[ @last_response_date = ] last_response_date
Restablece la fecha de la última respuesta a la alerta por parte del servicio SQLServerAgent. @last_response_date es int, con un valor predeterminado de NULLy solo 0se puede establecer en .
[ @last_response_time = ] last_response_time
Restablece la hora de la última respuesta a la alerta por parte del servicio SQLServerAgent. @last_response_time es int, con un valor predeterminado de NULLy solo 0se puede establecer en .
[ @raise_snmp_trap = ] raise_snmp_trap
Solamente se identifica con fines informativos. No compatible. La compatibilidad con versiones posteriores no está garantizada.
[ @performance_condition = ] N'performance_condition'
Valor expresado en el formato <itemcomparatorvalue>. @performance_condition es nvarchar(512) y consta de los siguientes elementos.
| Elemento de formato | Descripción |
|---|---|
| Elemento | Objeto de rendimiento, contador de rendimiento o instancia con nombre del contador |
| Comparador | Uno de estos operadores: >, <, = |
| Valor | Valor numérico del contador |
[ @category_name = ] N'category_name'
El nombre de la categoría de alerta. @category_name es sysname, con un valor predeterminado de NULL.
[ @wmi_namespace = ] N'wmi_namespace'
Es el espacio de nombres WMI para consultar eventos. @wmi_namespace es sysname, con un valor predeterminado de NULL.
[ @wmi_query = ] N'wmi_query'
La consulta que especifica el evento WMI para la alerta. @wmi_query es nvarchar(512), con un valor predeterminado de NULL.
Valores de código de retorno
0 (correcto) o 1 (erróneo).
Comentarios
Solo sysmessages se puede activar una alerta escrita en el registro de aplicaciones de Windows.
sp_update_alert solo cambia la configuración de alerta para la que se proporcionan los valores de parámetro. Si se omite un parámetro, se conserva la configuración actual.
Permisos
Para ejecutar este procedimiento almacenado, los usuarios deben ser miembros del rol fijo 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