sp_add_operator (Transact-SQL)
Si applica a:
SQL Server Istanza gestita di SQL di Azure
Crea un operatore (destinatario delle notifiche) da utilizzare con avvisi e processi.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
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' ]
[ ; ]
Argomenti
[ @name = ] 'name'
Nome di un operatore (destinatario della notifica). Questo nome deve essere univoco e non può contenere il carattere percentuale (%). @name è sysname, senza impostazione predefinita.
[ @enabled = ] abilitato
Indica lo stato corrente dell'operatore. @enabled è tinyint, con il valore predefinito 1 (abilitato). Se 0, l'operatore non è abilitato e non riceve notifiche.
[ @email_address = ] N'email_address'
Indirizzo di posta elettronica dell'operatore. Questa stringa viene passata direttamente al sistema di posta elettronica. @email_address è nvarchar(100), con il valore predefinito NULL.
È possibile specificare un indirizzo di posta elettronica fisico o un alias per @email_address. Ad esempio:
fatmir.bregu oppure fatmir.bregu@contoso.com
Nota
È necessario utilizzare l'indirizzo di posta elettronica per Posta elettronica database.
[ @pager_address = ] N'pager_address'
Indirizzo del cercapersone dell'operatore. Questa stringa viene passata direttamente al sistema di posta elettronica. @pager_address è nvarchar(100), con il valore predefinito NULL.
[ @weekday_pager_start_time = ] weekday_pager_start_time
Ora successiva alla quale SQL Server Agent invia una notifica di cercapersone all'operatore specificato nei giorni feriali, da lunedì a venerdì. @weekday_pager_start_time è int, con un valore predefinito 090000, che indica le 9:00 in un orologio di 24 ore e deve essere immesso usando il formato HHmmss.
[ @weekday_pager_end_time = ] weekday_pager_end_time
Ora successiva alla quale il servizio SQL Server Agent non invia più la notifica del cercapersone all'operatore specificato nei giorni feriali, da lunedì a venerdì. weekday_pager_end_time è int, con un valore predefinito 180000, che indica le 18:00 su un orologio di 24 ore e deve essere immesso usando il formato HHmmss.
[ @saturday_pager_start_time = ] saturday_pager_start_time
Ora successiva alla quale il servizio SQL Server Agent invia la notifica del cercapersone all'operatore specificato il sabato. saturday_pager_start_time è int, con un valore predefinito 090000, che indica le 9:00 in un orologio di 24 ore e deve essere immesso usando il formato HHmmss.
[ @saturday_pager_end_time = ] saturday_pager_end_time
Ora successiva alla quale il servizio SQL Server Agent non invia più la notifica del cercapersone all'operatore specificato il sabato. @saturday_pager_end_time è int, con un valore predefinito 180000, che indica le 18:00 in un orologio di 24 ore e deve essere immesso usando il formato HHmmss.
[ @sunday_pager_start_time = ] sunday_pager_start_time
Ora successiva alla quale il servizio SQL Server Agent invia la notifica del cercapersone all'operatore specificato la domenica. @sunday_pager_start_time è int, con un valore predefinito 090000, che indica le 9:00 in un orologio di 24 ore e deve essere immesso usando il formato HHmmss.
[ @sunday_pager_end_time = ] sunday_pager_end_time
Ora successiva alla quale il servizio SQL Server Agent non invia più la notifica del cercapersone all'operatore specificato la domenica. @sunday_pager_end_time è int, con un valore predefinito 180000, che indica le 18:00 in un orologio di 24 ore e deve essere immesso usando il formato HHmmss.
[ @pager_days = ] pager_days
Numero che indica i giorni in cui l'operatore è disponibile per le pagine (soggetto all'ora di inizio/fine specificata). @pager_days è tinyint, con un valore predefinito che 0 indica che l'operatore non è mai disponibile per ricevere una pagina. I valori validi sono compresi tra 0 e 127. @pager_days viene calcolato aggiungendo i singoli valori per i giorni necessari. Ad esempio, da lunedì a venerdì è 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 = ] 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 = ] 'category'
Nome della categoria per questo operatore. @category_name è sysname, con un valore predefinito .NULL
Valori del codice restituito
0 (esito positivo) o 1 (errore).
Set di risultati
Nessuno.
Osservazioni:
sp_add_operator deve essere eseguito dal msdb database.
Se si desidera utilizzare il paging, il sistema di posta elettronica deve disporre di una funzionalità di posta elettronica a pager.
SQL Server Management Studio include un semplice strumento grafico per la gestione dei processi ed è lo strumento consigliato per la creazione e gestione dell'infrastruttura dei processi.
Autorizzazioni
Questa stored procedure è di proprietà del ruolo db_owner . È possibile concedere EXECUTE autorizzazioni per qualsiasi utente, ma queste autorizzazioni possono essere sottoposte a override durante un aggiornamento di SQL Server.
Esempi
Nell'esempio seguente vengono impostate e attivate le informazioni per l'operatore danwi. L'operatore è abilitato. SQL Server Agent invia notifiche tramite cercapersone da lunedì a venerdì dalle 8:00 alle 17:00.
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