sp_update_operator (Transact-SQL)
Si applica a: SQL Server
Aggiorna le informazioni relative a un operatore (destinatario di notifiche) utilizzate in avvisi e processi.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
sp_update_operator
[ @name = ] N'name'
[ , [ @new_name = ] N'new_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 = ] N'category_name' ]
[ ; ]
Argomenti
[ @name = ] N'name'
Nome dell'operatore da modificare. @name è sysname, senza impostazione predefinita.
[ @new_name = ] N'new_name'
Nuovo nome dell'operatore. Il nome deve essere univoco. @new_name è sysname, con un valore predefinito .NULL
[ @enabled = ] abilitato
Numero che indica lo stato corrente dell'operatore (1
se attualmente abilitato, 0
in caso contrario). @enabled è tinyint, con un valore predefinito .NULL
Se non è abilitata, un operatore non riceve notifiche di avviso.
[ @email_address = ] N'email_address'
Indirizzo di posta elettronica dell'operatore. @email_address è nvarchar(100), con il valore predefinito NULL
. Questa stringa viene passata direttamente al sistema di posta elettronica.
[ @pager_address = ] N'pager_address'
Indirizzo del cercapersone dell'operatore. @pager_address è nvarchar(100), con il valore predefinito NULL
. Questa stringa viene passata direttamente al sistema di posta elettronica.
[ @weekday_pager_start_time = ] weekday_pager_start_time
Indica l'ora dei giorni lavorativi da lunedì a venerdì oltre la quale è possibile inviare una notifica al cercapersone dell'operatore specificato. @weekday_pager_start_time è int, con un valore predefinito , NULL
e deve essere immesso nel modulo HHmmss
per l'uso con un orologio di 24 ore.
[ @weekday_pager_end_time = ] weekday_pager_end_time
Specifica l'ora dopo la quale non è possibile inviare una notifica di cercapersone all'operatore specificato, da lunedì a venerdì. @weekday_pager_end_time è int, con un valore predefinito NULL
, e deve essere immesso nel modulo HHmmss
per l'uso con un orologio di 24 ore.
[ @saturday_pager_start_time = ] saturday_pager_start_time
Indica l'ora del sabato oltre la quale è possibile inviare una notifica sul cercapersone dell'operatore specificato. @saturday_pager_start_time è int, con un valore predefinito , NULL
e deve essere immesso nel modulo HHmmss
per l'uso con un orologio di 24 ore.
[ @saturday_pager_end_time = ] saturday_pager_end_time
Specifica l'ora dopo la quale non è possibile inviare una notifica di cercapersone all'operatore specificato il sabato. @saturday_pager_end_time è int, con un valore predefinito , NULL
e deve essere immesso nel modulo HHmmss
per l'uso con un orologio di 24 ore.
[ @sunday_pager_start_time = ] sunday_pager_start_time
Indica l'ora della domenica oltre la quale è possibile inviare una notifica sul cercapersone dell'operatore specificato. @sunday_pager_start_time è int, con un valore predefinito , NULL
e deve essere immesso nel modulo HHmmss
per l'uso con un orologio di 24 ore.
[ @sunday_pager_end_time = ] sunday_pager_end_time
Specifica l'ora dopo la quale non è possibile inviare una notifica di cercapersone all'operatore specificato la domenica. @sunday_pager_end_time è int, con un valore predefinito , NULL
e deve essere immesso nel modulo HHmmss
per l'uso con un orologio di 24 ore.
[ @pager_days = ] pager_days
Indica i giorni in cui l'operatore può essere rintracciato tramite cercapersone (in base all'ora di inizio e fine specificata). @pager_days è tinyint, con un valore predefinito , NULL
e deve essere un valore compreso tra 0
127
. @pager_days viene calcolato aggiungendo i singoli valori per i giorni necessari. Ad esempio, da lunedì a venerdì è 2
8
+ 16
+ 32
4
64
+ + = .
valore | Descrizione |
---|---|
1 |
Domenica |
2 |
lunedì |
4 |
Martedì |
8 |
mercoledì |
16 |
giovedì |
32 |
Venerdì |
64 |
Sabato |
[ @netsend_address = ] N'netsend_address'
Indirizzo di rete dell'operatore a cui viene inviato il messaggio di rete. @netsend_address è nvarchar(100), con il valore predefinito NULL
.
[ @category_name = ] N'category_name'
Nome della categoria di questo avviso. @category_name è sysname, con un valore predefinito .NULL
Valori del codice restituito
0
(esito positivo) o 1
(errore).
Osservazioni:
sp_update_operator
deve essere eseguito dal msdb
database.
Autorizzazioni
Le autorizzazioni di esecuzione per questa procedura vengono assegnate per impostazione predefinita ai membri del ruolo predefinito del server sysadmin .
Esempi
L'esempio seguente aggiorna lo stato dell'operatore, impostando @enabled
true
su e imposta i giorni (da lunedì a venerdì, dalle 8.00 alle 17.00) quando l'operatore può essere sottoposto a paging.
USE msdb;
GO
EXEC dbo.sp_update_operator
@name = N'François Ajenstat',
@enabled = 1,
@email_address = N'françoisa',
@pager_address = N'5551290AW@pager.Adventure-Works.com',
@weekday_pager_start_time = 080000,
@weekday_pager_end_time = 170000,
@pager_days = 64;
GO