Condividi tramite

sp_add_operator (Transact-SQL)

  • Articolo

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

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

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). Questo nome deve essere univoco e non può includere il carattere di percentuale (%). 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 (abilitato). Se è impostato su 0, l'operatore non è abilitato 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, ad esempio:

    'jdoe' o 'jdoe@xyz.com'

    [!NOTA]

    È necessario utilizzare l'indirizzo di posta elettronica per Posta elettronica database.

  • [ @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
    Data e ora successivamente alle quali SQL Server Agent invia notifica tramite cercapersone all'operatore specificato nei giorni della settimana, dal lunedì al venerdì. weekday_pager_start_time* *è di tipo int e il valore predefinito è 090000 che indica le ore 9.00 nel formato a 24 ore e deve essere immesso nel formato HHMMSS.

  • [ @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 e il valore predefinito è 180000 che indica le ore 18.00 nel formato a 24 ore e deve essere immesso nel formato HHMMSS.

  • [ @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 e il valore predefinito è 090000 che indica le 9.00 nel formato a 24 ore e deve essere immesso nel formato HHMMSS.

  • [ @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 e il valore predefinito è 180000 che indica le ore 18.00 nel formato a 24 ore e deve essere immesso nel formato HHMMSS.

  • [ @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 e il valore predefinito è 090000 che indica le ore 9.00 nel formato a 24 ore e deve essere immesso nel formato HHMMSS.

  • [ @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 e il valore predefinito è 180000 che indica le ore 18.00 nel formato a 24 ore e deve essere immesso nel formato HHMMSS.

  • [ @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 a 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.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

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 un semplice metodo grafico per la gestione dei processi ed è il metodo 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.

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

Vedere anche

Riferimento

sp_delete_operator (Transact-SQL)

sp_help_operator (Transact-SQL)

sp_update_operator (Transact-SQL)

Stored procedure di sistema (Transact-SQL)