sysmail_update_profileaccount_sp (Transact-SQL)
Aplica-se a: SQL Server
Atualiza o número de sequência de uma conta dentro de um perfil do Database Mail.
Convenções de sintaxe de Transact-SQL
Sintaxe
sysmail_update_profileaccount_sp { [ @profile_id = ] profile_id
| [ @profile_name = ] 'profile_name' } ,
{ [ @account_id = ] account_id | [ @account_name = ] 'account_name' } ,
[ @sequence_number = ] sequence_number
[ ; ]
Argumentos
@profile_id [ = ] profile_id
A ID do perfil a ser atualizado. @profile_id é int, com um padrão de NULL
. O @profile_id ou o @profile_name devem ser especificados.
@profile_name [ = ] 'profile_name'
O nome do perfil a ser atualizado. @profile_name é sysname, com um padrão de NULL
. O @profile_id ou o @profile_name devem ser especificados.
@account_id [ = ] account_id
A ID da conta a ser atualizada. @account_id é int, com um padrão de NULL
. O @account_id ou o @account_name devem ser especificados.
@account_name [ = ] 'account_name'
O nome da conta a ser atualizada. @account_name é sysname, com um padrão de NULL
. O @account_id ou o @account_name devem ser especificados.
@sequence_number [ = ] sequence_number
O novo número de sequência da conta. @sequence_number é int, sem padrão. O número de sequência determina a ordem na qual as contas são usadas no perfil.
Valores do código de retorno
0
(sucesso) ou 1
(falha).
Conjunto de resultados
Nenhum.
Comentários
Retorna um erro se a conta especificada não estiver associada ao perfil especificado.
O número de sequência determina a ordem na qual o Database Mail usa as contas no perfil. Para uma nova mensagem de email, o Database Mail começa com a conta que é o número de seqüência mais baixo. Se essa conta falhar, o Database Mail usará a conta com o próximo número de sequência mais alto, e assim por diante, até que o Database Mail envie a mensagem com êxito ou a conta com o número de sequência mais alto falhe. Se houver falha na conta com o número de sequência mais alto, a mensagem de email falhará.
Se existir mais de uma conta com o mesmo número de sequência, o Database Mail utilizará apenas uma delas para uma dada mensagem de email. Nesse caso, o Database Mail não pode garantir qual das contas será usada para o número de sequência em questão nem que a mesma conta seja usada em todas as mensagens.
O procedimento sysmail_update_profileaccount_sp
armazenado está no msdb
banco de dados e pertence ao esquema dbo . O procedimento deve ser executado com um nome de três partes se o banco de dados atual não msdb
for .
Permissões
Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE
permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.
Exemplos
O exemplo a seguir altera o número de sequência da conta Admin-BackupServer
dentro do perfil AdventureWorks Administrator
no msdb
banco de dados. Depois de executar este código, o número de sequência da conta será 3
, indicando que ela será tentada no caso das duas primeiras contas falharem.
EXEC msdb.dbo.sysmail_update_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Admin-BackupServer',
@sequence_number = 3;