Partilhar via

  • Artigo

sysmail_update_profileaccount_sp (Transact-SQL)

Atualiza o número de sequência de uma conta dentro de um perfil do Database Mail.

Ícone de vínculo de tópicoConvenções de sintaxe 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
    O ID do perfil a ser atualizado. profile_id é int, com um padrão NULL. É necessário especificar a profile_id ou o profile_name.

  • [ @profile_name = ] 'profile_name'
    O nome do perfil a ser atualizado. profile_name é sysname, com um padrão NULL. É necessário especificar a profile_id ou o profile_name.

  • [ @account_id = ] account_id
    O ID da conta a ser atualizada. account_id é int, com um padrão NULL. É necessário especificar a account_id ou o account_name.

  • [ @account_name = ] 'account_name'
    O nome da conta a ser atualizada. account_name é sysname, com um padrão NULL. É necessário especificar a account_id ou o account_name.

  • [ @sequence_number = ] sequence_number
    O novo número de sequência para a 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 de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos 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 inicia com a conta que tem o número de sequê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 armazenado sysmail_update_profileaccount_sp está no banco de dados msdb e pertence ao esquema dbo. O procedimento deverá ser executado com um nome de três partes se o banco de dados atual não for msdb.

Permissões

As permissões de execução deste procedimento usam como padrão membros da função de servidor fixa sysadmin.

Exemplos

O exemplo a seguir altera o número de sequência da conta Admin-BackupServer no perfil AdventureWorks2008R2 Administrator do banco de dados msdb. 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.

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