Share via

sp_update_alert (Transact-SQL)

  • Artículo

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

Contenido relacionado