sp_update_operator (Transact-SQL)
Se aplica a: SQL Server
Actualiza información acerca de un operador (destinatario de la notificación) para utilizarla con las alertas y los trabajos.
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_update_operator
[ @name = ] N'name'
[ , [ @new_name = ] N'new_name' ]
[ , [ @enabled = ] enabled ]
[ , [ @email_address = ] N'email_address' ]
[ , [ @pager_address = ] N'pager_address' ]
[ , [ @weekday_pager_start_time = ] weekday_pager_start_time ]
[ , [ @weekday_pager_end_time = ] weekday_pager_end_time ]
[ , [ @saturday_pager_start_time = ] saturday_pager_start_time ]
[ , [ @saturday_pager_end_time = ] saturday_pager_end_time ]
[ , [ @sunday_pager_start_time = ] sunday_pager_start_time ]
[ , [ @sunday_pager_end_time = ] sunday_pager_end_time ]
[ , [ @pager_days = ] pager_days ]
[ , [ @netsend_address = ] N'netsend_address' ]
[ , [ @category_name = ] N'category_name' ]
[ ; ]
Argumentos
[ @name = ] N'name'
El nombre del operador que se va a modificar. @name es sysname, sin ningún valor predeterminado.
[ @new_name = ] N'new_name'
Nuevo nombre del operador. El nombre debe ser único. @new_name es sysname, con un valor predeterminado de NULL
.
[ @enabled = ] enabled
Número que indica el estado actual del operador (1
si está habilitado actualmente, 0
si no). @enabled es tinyint, con un valor predeterminado de NULL
. Si no está habilitado, un operador no recibe notificaciones de alerta.
[ @email_address = ] N'email_address'
Dirección de correo electrónico del operador. @email_address es nvarchar(100), con un valor predeterminado de NULL
. Esta cadena se pasa directamente al sistema de correo electrónico.
[ @pager_address = ] N'pager_address'
Dirección del buscapersonas del operador. @pager_address es nvarchar(100), con un valor predeterminado de NULL
. Esta cadena se pasa directamente al sistema de correo electrónico.
[ @weekday_pager_start_time = ] weekday_pager_start_time
Especifica la hora a partir de la cual puede enviarse una notificación por buscapersonas a este operador, de lunes a viernes. @weekday_pager_start_time es int, con un valor predeterminado de NULL
y debe escribirse en el formulario HHmmss
para su uso con un reloj de 24 horas.
[ @weekday_pager_end_time = ] weekday_pager_end_time
Especifica la hora después de la cual no se puede enviar una notificación de buscapersonas al operador especificado, de lunes a viernes. @weekday_pager_end_time es int, con un valor predeterminado de NULL
y debe escribirse en el formulario HHmmss
para su uso con un reloj de 24 horas.
[ @saturday_pager_start_time = ] saturday_pager_start_time
Especifica la hora a partir de la cual puede enviarse una notificación por buscapersonas los sábados al operador especificado. @saturday_pager_start_time es int, con un valor predeterminado de NULL
y debe escribirse en el formulario HHmmss
para su uso con un reloj de 24 horas.
[ @saturday_pager_end_time = ] saturday_pager_end_time
Especifica la hora después de la cual no se puede enviar una notificación de buscapersonas al operador especificado los sábados. @saturday_pager_end_time es int, con un valor predeterminado de NULL
y debe escribirse en el formulario HHmmss
para su uso con un reloj de 24 horas.
[ @sunday_pager_start_time = ] sunday_pager_start_time
Especifica la hora a partir de la cual puede enviarse una notificación por buscapersonas los domingos al operador especificado. @sunday_pager_start_time es int, con un valor predeterminado de NULL
y debe escribirse en el formulario HHmmss
para su uso con un reloj de 24 horas.
[ @sunday_pager_end_time = ] sunday_pager_end_time
Especifica la hora después de la cual no se puede enviar una notificación de buscapersonas al operador especificado los domingos. @sunday_pager_end_time es int, con un valor predeterminado de NULL
y debe escribirse en el formulario HHmmss
para su uso con un reloj de 24 horas.
[ @pager_days = ] pager_days
Especifica los días en que el operador está disponible para recibir mensajes por buscapersonas (de acuerdo con las horas inicial y final especificadas). @pager_days es tinyint, con un valor predeterminado de NULL
y debe ser un valor de a través 127
de 0
. @pager_days se calcula agregando los valores individuales durante los días necesarios. Por ejemplo, de lunes a viernes es 2
64
= 32
+ + + 16
+ 4
8
.
Valor | Descripción |
---|---|
1 |
Domingo |
2 |
Lunes |
4 |
Martes |
8 |
Miércoles |
16 |
Jueves |
32 |
Viernes |
64 |
Sábado |
[ @netsend_address = ] N'netsend_address'
La dirección de red del operador al que se envía el mensaje de red. @netsend_address es nvarchar(100), con un valor predeterminado de NULL
.
[ @category_name = ] N'category_name'
El nombre de la categoría de esta alerta. @category_name es sysname, con un valor predeterminado de NULL
.
Valores de código de retorno
0
(correcto) o 1
(erróneo).
Comentarios
sp_update_operator
debe ejecutarse desde la msdb
base de datos.
Permisos
Los permisos de ejecución para este procedimiento corresponden de forma predeterminada a los miembros del rol fijo de servidor sysadmin .
Ejemplos
En el ejemplo siguiente se actualiza el estado del operador, se establece @enabled
true
en y se establecen los días (de lunes a viernes, de 8 A.M. a 5 p.m.) cuando el operador se puede paginar.
USE msdb;
GO
EXEC dbo.sp_update_operator
@name = N'François Ajenstat',
@enabled = 1,
@email_address = N'françoisa',
@pager_address = N'5551290AW@pager.Adventure-Works.com',
@weekday_pager_start_time = 080000,
@weekday_pager_end_time = 170000,
@pager_days = 64;
GO