Partilhar via

sysmail_update_profileaccount_sp (Transact-SQL)

Aplica-se a:SQL Server

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

Transact-SQL convenções de sintaxe

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

O ID da conta a ser atualizado. @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 para a conta. @sequence_number é int, sem padrão. O número sequencial determina a ordem em que as contas são usadas no perfil.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

Nenhum.

Observações

Retorna um erro se a conta especificada não estiver associada ao perfil especificado.

O número de sequência determina a ordem em que o Database Mail usa contas no perfil. Para uma nova mensagem de email, o Database Mail começa com a conta que é 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 a conta com o número de sequência mais alto falhar, a mensagem de email falhará.

Se existir mais de uma conta com o mesmo número de sequência, o Database Mail usará apenas uma dessas contas para uma determinada mensagem de email. Nesse caso, o Database Mail não garante qual das contas é usada para esse número de sequência ou que a mesma conta é usada de mensagem para mensagem.

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 msdbfor .

Permissões

Você pode conceder permissões de EXECUTE neste procedimento, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Exemplos

O exemplo a msdb seguir altera o número de sequência da conta Admin-BackupServer dentro do perfil AdventureWorks Administrator no banco de dados. Depois de executar este código, o número de sequência para a conta é 3, indicando que será tentado se as duas primeiras contas falharem.

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

Conteúdo relacionado

  • Last updated on