sysmail_update_profileaccount_sp (Transact-SQL)

Articolo
06/18/2013

Aggiorna il numero di sequenza di un account all'interno di un profilo di Posta elettronica database.

Icona di collegamento a un argomento Convenzioni della 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 è di tipo int e il valore predefinito è NULL. È necessario specificare profile_id o profile_name.
[ @profile_name = ] 'profile_name'
Nome del profilo da aggiornare. profile_name è di tipo sysname e il valore predefinito è NULL. È necessario specificare profile_id o profile_name.
[ @account_id = ] account_id
ID dell'account da aggiornare. account_id è di tipo int e il valore predefinito è NULL. È necessario specificare account_id o account_name.
[ @account_name = ] 'account_name'
Nome dell'account da aggiornare. account_name è di tipo sysname e il valore predefinito è NULL. È necessario specificare account_id o account_name.
[ @sequence_number = ] sequence_number
Nuovo numero di sequenza dell'account. sequence_number è di tipo int e non prevede alcun valore predefinito. Il numero di sequenza determina l'ordine in cui gli account sono utilizzati nel profilo.

Valori restituiti

0 (esito positivo) o 1 (esito negativo)

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 gli account sono utilizzati da Posta elettronica database nel profilo. Per un nuovo messaggio di posta elettronica, Posta elettronica database inizia con l'account che ha il numero di sequenza più basso. In caso di errore di questo account, Posta elettronica database utilizza l'account con il numero di sequenza più alto successivo, e così via fino a quando Posta elettronica database riesce a completare l'invio del messaggio oppure l'account con il numero di sequenza più alto in assoluto restituisce un errore. 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 database msdb ed è di proprietà dello schema dbo. La procedura deve essere eseguita con un nome in tre parti se il database corrente non è msdb.

Autorizzazioni

Le autorizzazioni di esecuzione per questa procedura vengono assegnate per impostazione predefinita ai membri del ruolo predefinito del server sysadmin.

Esempi

Nell'esempio seguente viene modificato il numero di sequenza dell'account Admin-BackupServer all'interno del profilo AdventureWorks Administrator nel database msdb. 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.

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