sp_add_operator (Transact-SQL)

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

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

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

Notas

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