Condividi tramite


sp_add_operator (Transact-SQL)

Crea un operatore (destinatario delle notifiche) da utilizzare con avvisi e processi.

Sintassi

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' ] 

Argomenti

  • [ @name= ] 'name'
    Nome di un operatore (destinatario della notifica). Il nome deve essere univoco e non può includere il carattere %. name è di tipo sysname e non prevede alcun valore predefinito.
  • [ @enabled= ] enabled
    Indica lo stato corrente dell'operatore. enabled è di tipo tinyint e il valore predefinito è 1 (attivato). Se è impostato su 0, l'operatore non è attivato e non riceve notifiche.
  • [ @email_address= ] 'email_address'
    Indirizzo di posta elettronica dell'operatore. Questa stringa viene passata direttamente al sistema di posta elettronica. email_address è di tipo nvarchar(100) e il valore predefinito è NULL.

    Per email_address è possibile specificare un indirizzo di posta elettronica fisico o un alias, come illustrato di seguito:

    'jdoe' o 'jdoe@xyz.com'

  • [ @pager_address= ] 'pager_address'
    Indirizzo del cercapersone dell'operatore. Questa stringa viene passata direttamente al sistema di posta elettronica. pager_address è di tipo narchar(100) e il valore predefinito è NULL.
  • [ @weekday_pager_start_time= ] weekday_pager_start_time
    Ora dei giorni feriali da lunedì a venerdì oltre la quale Microsoft SQL Server Agent invia notifiche al cercapersone dell'operatore specificato. weekday_pager_start_timeè di tipo int, con formato HHMMSS. Il valore predefinito è 090000, che indica le ore 9.00 nel formato a 24 ore.
  • [ @weekday_pager_end_time= ] weekday_pager_end_time
    Ora dei giorni feriali da lunedì a venerdì oltre la quale il servizio SQLServerAgent non invia notifiche al cercapersone dell'operatore specificato. weekday_pager_end_timeè di tipo int, con formato HHMMSS. Il valore predefinito è 180000, che indica le ore 18.00 nel formato a 24 ore.
  • [ @saturday_pager_start_time =] saturday_pager_start_time
    Ora del sabato oltre la quale il servizio SQLServerAgent invia notifiche al cercapersone dell'operatore specificato. saturday_pager_start_time è di tipo int, con formato HHMMSS. Il valore predefinito è 090000, che indica le ore 9.00 nel formato a 24 ore.
  • [ @saturday_pager_end_time= ] saturday_pager_end_time
    Ora del sabato oltre la quale il servizio SQLServerAgent non invia notifiche al cercapersone dell'operatore specificato. saturday_pager_end_timeè di tipo int, con formato HHMMSS. Il valore predefinito è 180000, che indica le ore 18.00 nel formato a 24 ore.
  • [ @sunday_pager_start_time= ] sunday_pager_start_time
    Ora della domenica oltre la quale il servizio SQLServerAgent invia notifiche al cercapersone dell'operatore specificato. sunday_pager_start_timeè di tipo int, con formato HHMMSS. Il valore predefinito è 090000, che indica le ore 9.00 nel formato a 24 ore.
  • [ @sunday_pager_end_time =] sunday_pager_end_time
    Ora della domenica oltre la quale il servizio SQLServerAgent non invia notifiche al cercapersone dell'operatore specificato. sunday_pager_end_timeè di tipo int, con formato HHMMSS. Il valore predefinito è 180000, che indica le ore 18.00 nel formato a 24 ore.
  • [ @pager_days= ] pager_days
    Numero che indica i giorni in cui l'operatore può essere rintracciato tramite cercapersone (in base all'ora di inizio e di fine specificate). pager_daysè di tipo tinyint e il valore predefinito è 0, che indica che l'operatore non è mai disponibile per ricevere messaggi sul cercapersone. I valori validi sono compresi tra 0 e 127. pager_daysviene calcolato sommando i singoli valori dei giorni necessari. Il valore per specificare i giorni da lunedì a venerdì, ad esempio, corrisponde alla somma 2+4+8+16+32 = 62. Nella tabella seguente vengono elencati i valori disponibili per ogni giorno della settimana.

    Valore Descrizione

    1

    Domenica

    2

    Lunedì

    4

    Martedì

    8

    Mercoledì

    16

    Giovedì

    32

    Venerdì

    64

    Sabato

  • [ @netsend_address= ] 'netsend_address'
    Indirizzo di rete dell'operatore a cui viene inviato il messaggio di rete. netsend_addressè di tipo nvarchar(100) e il valore predefinito è NULL.
  • [ @category_name= ] 'category'
    Nome della categoria per questo operatore. category è di tipo sysname e il valore predefinito è NULL.

Set di risultati

Nessuno

Osservazioni

La procedura sp_add_operator deve essere eseguita nel database msdb.

L'invio di messaggi sul cercapersone è supportato dal sistema di posta elettronica, in cui deve essere disponibile la funzionalità per il trasferimento di messaggi su cercapersone.

SQL Server Management Studio include uno strumento grafico di facile utilizzo per la gestione dei processi, ed è lo strumento consigliato per la creazione e la gestione dell'infrastruttura dei processi.

Autorizzazioni

Solo i membri del ruolo predefinito del server sysadmin possono eseguire sp_add_operator.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

Esempi

Nell'esempio seguente vengono impostate e attivate le informazioni per l'operatore danwi. L'operatore è attivato. SQL Server Agent invia notifiche tramite cercapersone da lunedì a venerdì, dalle 8 alle 17.

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

Vedere anche

Riferimento

sp_delete_operator (Transact-SQL)
sp_help_operator (Transact-SQL)
sp_update_operator (Transact-SQL)
Stored procedure di sistema (Transact-SQL)

Guida in linea e informazioni

Assistenza su SQL Server 2005