sysmail_add_profileaccount_sp (Transact-SQL)
Adiciona uma conta do Database Mail a um perfil do Database Mail. Execute sysmail_add_profileaccount_sp depois que uma Conta de Banco de dados for criada com sysmail_add_account_sp (Transact-SQL) e um Perfil de Banco de dados for criado com sysmail_add_profile_sp (Transact-SQL).
.gif "Ícone de vínculo de tópico")
Sintaxe
sysmail_add_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 em que a conta será adicionada. 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 em que a conta será adicionada. 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 adicionada ao perfil. 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 adicionada ao perfil. account_name é sysname, com um padrão NULL. É necessário especificar a account_id ou o account_name.[ @sequence_number = ] sequence_number
O número de seqüência da conta no perfil. sequence_number é int, sem padrão. O número de seqüência determina a ordem na qual as contas são usadas no perfil.
Valores de código de retorno
0 (êxito) ou 1 (falha)
Comentários
O perfil e a conta já devem existir. Caso contrário, o procedimento armazenado retornará um erro.
Observe que este procedimento armazenado não altera o número de seqüência de uma conta já associada ao perfil especificado. Para obter mais informações sobre como atualizar o número de seqüência de uma conta, consulte sysmail_update_profileaccount_sp (Transact-SQL).
O número de seqüê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 seqüência mais baixo. Se essa conta falhar, o Database Mail usará a conta com o próximo número de seqüê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 seqüência mais alto falhe. Se a conta com o número de seqüência mais alto falhar, o Database Mail irá pausar as tentativas de enviar o email pelo período de tempo configurado no parâmetro AccountRetryDelay de sysmail_configure_sp e, em seguida, iniciará o processo de tentativa de envio do email novamente, começando pelo número de seqüência mais baixo. Use o parâmetro AccountRetryAttempts de sysmail_configure_sppara configurar o número de vezes que o processo de email externo tenta enviar a mensagem de email usando cada conta no perfil especificado.
Se existir mais de uma conta com o mesmo número de seqüê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 seqüência em questão, nem que a mesma conta seja usada em todas as mensagens.
O procedimento armazenado sysmail_add_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 associa o perfil AdventureWorks Administrator à conta Audit Account. A conta de auditoria tem um número de seqüência igual a 1.
EXECUTE msdb.dbo.sysmail_add_profileaccount_sp
@profile_name = 'AdventureWorks Administrator',
@account_name = 'Audit Account',
@sequence_number = 1 ;