sysmail_add_profileaccount_sp (Transact-SQL)

Aplica-se a:SQL Server

Adiciona uma conta do Correio de Base de Dados a um perfil do Correio de Base de Dados. Execute sysmail_add_profileaccount_sp depois que uma Conta de Banco de Dados é criada com sysmail_add_account_sp e um Perfil de Banco de Dados é criado com sysmail_add_profile_sp.

Transact-SQL convenções de sintaxe

Sintaxe

dbo.sysmail_add_profileaccount_sp
    { [ @profile_id = ] profile_id
        | [ @profile_name = ] N'profile_name' }
    , { [ @account_id = ] account_id
        | [ @account_name = ] N'account_name' }
    , [ @sequence_number = ] sequence_number
[ ; ]

Argumentos

@profile_id [ = ] profile_id

O ID do perfil ao qual adicionar a conta. @profile_id é int, com um padrão de NULL. Deve ser especificado @profile_id ou @profile_name .

[ @profile_name = ] N'profile_name'

O nome do perfil ao qual adicionar a conta. @profile_name é sysname, com um padrão de NULL. Deve ser especificado @profile_id ou @profile_name .

@account_id [ = ] account_id

O ID da conta a ser adicionado ao perfil. @account_id é int, com um padrão de NULL. Deve ser especificado @account_id ou @account_name .

[ @account_name = ] N'account_name'

O nome da conta a ser adicionada ao perfil. @account_name é sysname, com um padrão de NULL. Deve ser especificado @account_id ou @account_name .

@sequence_number [ = ] sequence_number

O número sequencial da conta dentro do perfil. @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).

Observações

Tanto o perfil quanto a conta já devem existir. Caso contrário, o procedimento armazenado retornará um erro.

Este procedimento armazenado não altera o número de sequência de uma conta já associada ao perfil especificado. Para obter mais informações sobre como atualizar o número de sequência de uma conta, consulte sysmail_update_profileaccount_sp.

O número de sequência determina a ordem em que o Correio de Base de Dados usa contas no perfil. Para uma nova mensagem de email, o Correio de Base de Dados começa com a conta que tem o número de sequência mais baixo. Se essa conta falhar, o Correio de Base de Dados usará a conta com o próximo número de sequência mais alto, e assim por diante, até que o Correio de Base de Dados 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, o Correio de Base de Dados pausará as tentativas de enviar o email pelo tempo configurado no parâmetro de e, em AccountRetryDelay seguida, iniciará o processo de tentativa de enviar o email novamente, começando com o menor número de sysmail_configure_spsequência. Use o AccountRetryAttempts parâmetro de , para configurar o número de vezes que o processo de email externo tenta enviar a mensagem de sysmail_configure_spemail usando cada conta no perfil especificado.

Se existir mais de uma conta com o mesmo número de sequência, o Correio de Base de Dados usará apenas uma dessas contas para uma determinada mensagem de email. Nesse caso, o Correio de Base de Dados 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_add_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 seguir associa o perfil AdventureWorks Administrator à conta Audit Account. A conta de auditoria tem um número sequencial de 1.

EXECUTE msdb.dbo.sysmail_add_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account',
    @sequence_number = 1;

Conteúdo relacionado

  • Last updated on