sp_add_operator (Transact-SQL)

  • Artículo

Se aplica a:SQL ServerAzure SQL Managed Instance

Crea un operador (destinatario de la notificación) para utilizarlo con las alertas y los trabajos.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_add_operator
    [ @name = ] '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 = ] '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 sysname, sin ningún valor predeterminado.

[ @enabled = ] enabled

Indica el estado actual del operador. @enabled es tinyint, con un valor predeterminado de 1 (habilitado). Si 0es , el operador no está habilitado y no recibe notificaciones.

[ @email_address = ] N'email_address'

Dirección de correo electrónico del operador. Esta cadena se pasa directamente al sistema de correo electrónico. @email_address es nvarchar(100), con un valor predeterminado de NULL.

Puede especificar una dirección de correo electrónico física o un alias para @email_address. Por ejemplo:

fatmir.bregu o fatmir.bregu@contoso.com

Nota:

Debe utilizar la dirección de correo electrónico para Correo electrónico de base de datos.

[ @pager_address = ] N'pager_address'

Dirección del buscapersonas del operador. Esta cadena se pasa directamente al sistema de correo electrónico. @pager_address es nvarchar(100), con un valor predeterminado de NULL.

[ @weekday_pager_start_time = ] weekday_pager_start_time

Hora después de la cual Agente SQL Server envía una notificación del buscapersonas al operador especificado en los días laborables, de lunes a viernes. @weekday_pager_start_time es int, con un valor predeterminado de 090000, que indica 9:00 A.M. en un reloj de 24 horas, y debe escribirse con el formulario HHmmss.

[ @weekday_pager_end_time = ] weekday_pager_end_time

La hora después de la cual Agente SQL Server servicio ya no envía una notificación de buscapersonas al operador especificado en los días laborables, de lunes a viernes. weekday_pager_end_time es int, con un valor predeterminado de 180000, que indica las 6:00 p.m. en un reloj de 24 horas, y debe escribirse con el formulario HHmmss.

[ @saturday_pager_start_time = ] saturday_pager_start_time

Hora después de la cual Agente SQL Server servicio envía una notificación de buscapersonas al operador especificado los sábados. saturday_pager_start_time es int, con un valor predeterminado de 090000, que indica 9:00 A.M. en un reloj de 24 horas, y debe escribirse con el formulario HHmmss.

[ @saturday_pager_end_time = ] saturday_pager_end_time

La hora después de la cual Agente SQL Server servicio ya no envía una notificación de buscapersonas al operador especificado los sábados. @saturday_pager_end_time es int, con un valor predeterminado de 180000, que indica las 6:00 p.m. en un reloj de 24 horas y debe escribirse con el formulario HHmmss.

[ @sunday_pager_start_time = ] sunday_pager_start_time

Hora después de la cual Agente SQL Server servicio envía una notificación de buscapersonas al operador especificado los domingos. @sunday_pager_start_time es int, con un valor predeterminado de 090000, que indica 9:00 A.M. en un reloj de 24 horas, y debe escribirse con el formulario HHmmss.

[ @sunday_pager_end_time = ] sunday_pager_end_time

Hora después de la cual Agente SQL Server servicio ya no envía una notificación del buscapersonas al operador especificado los domingos. @sunday_pager_end_time es int, con un valor predeterminado de 180000, que indica las 6:00 p.m. en un reloj de 24 horas, y debe escribirse con el formulario HHmmss.

[ @pager_days = ] pager_days

Número que indica los días que el operador está disponible para las páginas (sujeto a las horas de inicio y finalización especificadas). @pager_days es tinyint, con un valor predeterminado que 0 indica que el operador nunca está disponible para recibir una página. Los valores válidos son de a través 127de 0 . @pager_days se calcula agregando los valores individuales durante 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.

Value 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 = ] 'category'

El nombre de la categoría de este operador. @category_name es sysname, con un valor predeterminado de NULL.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Conjunto de resultados

Ninguno.

Comentarios

sp_add_operator debe ejecutarse desde la msdb base de datos.

El sistema de correo electrónico debe tener una funcionalidad de correo electrónico a buscapersonas si desea usar la paginación.

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

Este procedimiento almacenado es propiedad del rol db_owner . Puede conceder EXECUTE permisos para cualquier usuario, pero estos permisos se pueden invalidar durante una actualización de SQL Server.

Ejemplos

En este ejemplo se configura la información del operador para danwi. El operador está habilitado. Agente SQL Server envía notificaciones por buscapersonas 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

Contenido relacionado