Condividi tramite


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