sysmail_update_profileaccount_sp (Transact-SQL)

Si applica a: SQL Server

Aggiorna il numero di sequenza di un account in un profilo di Posta elettronica database.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

sysmail_update_profileaccount_sp { [ @profile_id = ] profile_id
| [ @profile_name = ] 'profile_name' } ,
    { [ @account_id = ] account_id | [ @account_name = ] 'account_name' } ,
    [ @sequence_number = ] sequence_number
[ ; ]

Argomenti

[ @profile_id = ] profile_id

ID del profilo da aggiornare. @profile_id è int, con il valore predefinito NULL. È necessario specificare il @profile_id o il @profile_name .

[ @profile_name = ] 'profile_name'

Nome del profilo da aggiornare. @profile_name è sysname, con il valore predefinito NULL. È necessario specificare il @profile_id o il @profile_name .

[ @account_id = ] account_id

ID dell'account da aggiornare. @account_id è int, con il valore predefinito NULL. È necessario specificare il @account_id o il @account_name .

[ @account_name = ] 'account_name'

Nome dell'account da aggiornare. @account_name è sysname, con un valore predefinito .NULL È necessario specificare il @account_id o il @account_name .

[ @sequence_number = ] sequence_number

Nuovo numero di sequenza dell'account. @sequence_number è int, senza impostazione predefinita. Il numero di sequenza determina l'ordine in cui gli account sono utilizzati nel profilo.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Nessuno.

Osservazioni:

Restituisce un errore se l'account specificato non è associato al profilo specificato.

Il numero di sequenza determina l'ordine in cui Posta elettronica database utilizza gli account nel profilo. Per un nuovo messaggio di posta elettronica, Posta elettronica database inizia con l'account con il numero di sequenza più basso. Se l'invio del messaggio con tale account ha esito negativo, Posta elettronica database prova con l'account con il numero di sequenza successivo e così via, finché il messaggio non viene inviato o finché anche l'invio con l'account con il numero di sequenza più alto non ha esito negativo. Se l'account con il numero di sequenza più alto restituisce un errore, l'invio del messaggio non viene completato.

Se esistono più account con lo stesso numero di sequenza, Posta elettronica database utilizza solo uno di questi account per un messaggio di posta specifico. In questo caso, non viene garantito quale account viene utilizzato per quel numero di sequenza né che venga utilizzato lo stesso account per ogni messaggio.

La stored procedure sysmail_update_profileaccount_sp si trova nel msdb database ed è di proprietà dello schema dbo . La procedura deve essere eseguita con un nome in tre parti se il database corrente non msdbè .

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 viene modificato il numero di sequenza dell'account Admin-BackupServer all'interno del profilo AdventureWorks Administrator nel msdb database. Dopo l'esecuzione del codice, il numero di sequenza dell'account è 3, ad indicare che sarà utilizzato se i primi due account restituiscono un messaggio di errore.

EXEC msdb.dbo.sysmail_update_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Admin-BackupServer',
    @sequence_number = 3;