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
È 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 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;