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)