sp_add_operator (Transact-SQL)
Crea un operador (destinatario de la notificación) para utilizarlo con las alertas y los trabajos.
.gif "Icono de vínculo a temas")
Sintaxis
sp_add_operator [ @name = ] 'name'
[ , [ @enabled = ] enabled ]
[ , [ @email_address = ] 'email_address' ]
[ , [ @pager_address = ] '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 = ] 'netsend_address' ]
[ , [ @category_name = ] 'category' ]
Argumentos
[ @name= ] 'name'
Nombre de un operador (destinatario de la notificación). Este nombre debe ser único y no puede contener el carácter de porcentaje (%). name es de tipo sysname y no tiene ningún valor predeterminado.[ @enabled= ] enabled
Indica el estado actual del operador. enabled es de tipo tinyint y su valor predeterminado es 1 (habilitado). Si es 0, el operador no está habilitado y no recibe notificaciones.[ @email_address= ] 'email_address'
Dirección de correo electrónico del operador. Esta cadena se pasa directamente al sistema de correo electrónico. email_address es de tipo nvarchar(100) y su valor predeterminado es NULL.Puede especificar una dirección de correo electrónico física o un alias para email_address. Por ejemplo:
'jdoe' o 'jdoe@xyz.com'
Nota
Solamente puede utilizar un alias de correo electrónico para SQL Mail. Debe utilizar la dirección de correo electrónico para Correo electrónico de base de datos.
[ @pager_address= ] 'pager_address'
Dirección del localizador del operador. Esta cadena se pasa directamente al sistema de correo electrónico. pager_address es de tipo narchar(100) y su valor predeterminado es NULL.[ @weekday_pager_start_time= ] weekday_pager_start_time
Hora después de la cual el Agente SQL Server enviará una notificación por localizador al operador especificado los días laborables, de lunes a viernes. weekday_pager_start_timees de tipo int y su valor predeterminado es 090000, lo que indica las 9:00 a.m. en un reloj de 24 horas. Se debe especificar con el formato HHMMSS.[ @weekday_pager_end_time= ] weekday_pager_end_time
Hora después de la cual el servicio SQLServerAgent ya no envía una notificación por localizador al operador especificado los días laborables, de lunes a viernes. weekday_pager_end_timees de tipo int y su valor predeterminado es 180000, lo que indica las 6:00 p.m. en un reloj de 24 horas. Se debe especificar con el formato HHMMSS.[ @saturday_pager_start_time =] saturday_pager_start_time
Hora después de la cual el servicio SQLServerAgent enviará una notificación por localizador al operador especificado los sábados. saturday_pager_start_time es de tipo int y su valor predeterminado es 090000, lo que indica las 9:00 a.m. en un reloj de 24 horas. Se debe especificar con el formato HHMMSS.[ @saturday_pager_end_time= ] saturday_pager_end_time
Hora después de la cual el servicio SQLServerAgent ya no envía una notificación por localizador al operador especificado los sábados. saturday_pager_end_timees de tipo int y su valor predeterminado es 180000, lo que indica las 6:00 p.m. en un reloj de 24 horas. Se debe especificar con el formato HHMMSS.[ @sunday_pager_start_time= ] sunday_pager_start_time
Hora después de la cual el servicio SQLServerAgent envía una notificación por localizador al operador especificado los domingos. sunday_pager_start_timees de tipo int y su valor predeterminado es 090000, lo que indica las 9:00 a.m. en un reloj de 24 horas. Se debe especificar con el formato HHMMSS.[ @sunday_pager_end_time =] sunday_pager_end_time
Hora después de la cual el servicio SQLServerAgent ya no envía una notificación por localizador al operador especificado los domingos. sunday_pager_end_timees de tipo int y su valor predeterminado es 180000, lo que indica las 6:00 p.m. en un reloj de 24 horas. Se debe especificar con el formato HHMMSS.[ @pager_days= ] pager_days
Es un número que indica los días durante los que el operador está disponible para recibir avisos de localización (de acuerdo con las horas de inicio y fin especificadas). pager_dayses de tipo tinyint y su valor predeterminado es 0, lo que indica que el operador no está nunca disponible para recibir un aviso de localización. Los valores válidos son de 0 a 127. pager_daysse calcula sumando los valores individuales de los días necesarios. Por ejemplo, de lunes a viernes es 2+4+8+16+32 = 62. En la siguiente tabla se incluye el valor para cada día de la semana.Valor
Descripción
1
Domingo
2
Lunes
4
Martes
8
Miércoles
16
Jueves
32
Viernes
64
Sábado
[ @netsend_address= ] 'netsend_address'
Dirección de red del operador al que se envía el mensaje de red. netsend_addresses de tipo nvarchar(100) y su valor predeterminado es NULL.[ @category_name= ] 'category'
Nombre de la categoría de este operador. category es de tipo sysname y su valor predeterminado es NULL.
Valores de código de retorno
0 (correcto) o 1 (error)
Conjuntos de resultados
Ninguno
Comentarios
sp_add_operator se debe ejecutar desde la base de datos msdb.
Los avisos de localización son compatibles con el sistema de correo electrónico, que debe disponer de capacidad de correo electrónico a localizador si desea utilizar esta funcionalidad.
SQL Server Management Studio ofrece un método gráfico sencillo para administrar trabajos y es el método recomendado para crear y administrar la infraestructura de trabajo.
Permisos
Sólo los miembros de la función fija de servidor sysadmin pueden ejecutar sp_add_operator.
Ejemplos
En este ejemplo se configura la información del operador para danwi. El operador está habilitado. El Agente SQL Server envía notificaciones por localizador de lunes a viernes, de 8 a.m. a 5 p.m.
USE msdb ;
GO
EXEC dbo.sp_add_operator
@name = N'Dan Wilson',
@enabled = 1,
@email_address = N'danwi',
@pager_address = N'5551290AW@pager.Adventure-Works.com',
@weekday_pager_start_time = 080000,
@weekday_pager_end_time = 170000,
@pager_days = 62 ;
GO