Condividi tramite


sp_add_operator (Transact-SQL)

Si applica a:SQL ServerIstanza gestita di SQL di Azure

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

Convenzioni relative alla sintassi Transact-SQL

Sintassi

dbo.sp_add_operator
    [ @name = ] N'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 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

L'orario di inizio in cui il servizio SQL Server Agent invia notifiche di pager all'operatore, dal lunedì al 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

Il momento finale in cui il servizio SQL Server Agent non invia più notifiche di pager all'operatore, dal lunedì al venerdì. @weekday_pager_end_time è int, con un valore predefinito di 180000, che indica le 18:00 su un orologio di 24 ore, e deve essere inserito usando il modulo HHmmss.

[ @saturday_pager_start_time = ] saturday_pager_start_time

L'orario di inizio è il sabato, quando il servizio SQL Server Agent invia notifiche di cercapersone all'operatore. @saturday_pager_start_time è int, con un default di 090000, che indica le 9:00 del mattino su un orologio di 24 ore, e deve essere inserito usando il modulo HHmmss.

[ @saturday_pager_end_time = ] saturday_pager_end_time

L'orario di fine il sabato, quando il servizio SQL Server Agent non invia più notifiche di pager all'operatore. @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

L'orario di inizio è la domenica, quando il servizio SQL Server Agent invia notifiche di pager all'operatore. @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

L'orario di fine la domenica, quando il servizio SQL Server Agent non invia più notifiche di pager all'operatore. @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 , 0che 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 = ] N'category_name'

Nome della categoria per questo operatore. @category_name è sysname, con un valore predefinito .NULL

Se questo valore è NULL, l'operatore viene sommato con una categoria predefinita di [Uncategorized]. Puoi anche scegliere da una categoria esistente, interrogando la syscategories tabella nel msdb database:

SELECT name
FROM msdb.dbo.syscategories;

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

È possibile concedere EXECUTE autorizzazioni per questa procedura, ma queste autorizzazioni potrebbero 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

EXECUTE 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