Partilhar via

sysmail_add_profile_sp (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed Instance

Cria um novo perfil do Database Mail .

Transact-SQL convenções de sintaxe

Sintaxe

sysmail_add_profile_sp [ @profile_name = ] 'profile_name'
    [ , [ @description = ] N'description' ]
    [ , [ @profile_id = ] new_profile_id OUTPUT ]
[ ; ]

Argumentos

@profile_name [ = ] «profile_name»

O nome do novo perfil. @profile_name é sysname, sem padrão.

Para enviar email usando trabalhos do SQL Server Agent na Instância Gerenciada do SQL do Azure, o SQL Server Agent pode usar apenas um perfil do Database Mail e deve ser chamado AzureManagedInstance_dbmail_profilede . Para obter mais informações e um script de exemplo, consulte Notificações de Trabalho do Agente SQL da Instância Gerida do Azure.

[ @description = ] N'descrição'

A descrição opcional para o novo perfil. @description é nvarchar(256), sem padrão.

@profile_id [ = ] new_profile_id SAÍDA

Retorna a ID do novo perfil. @profile_id é int, com um padrão de NULL.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Observações

Um perfil do Database Mail contém qualquer número de contas do Database Mail. Os procedimentos armazenados do Database Mail podem se referir a um perfil pelo nome do perfil ou pela ID do perfil gerada por este procedimento. Para obter mais informações sobre como adicionar uma conta a um perfil, consulte sysmail_add_profileaccount_sp.

O nome e a descrição do perfil podem ser alterados com o procedimento sysmail_update_profile_sparmazenado, enquanto o ID do perfil permanece constante durante toda a vida do perfil.

O nome do perfil deve ser exclusivo na instância do Mecanismo de Banco de Dados do SQL Server ou o procedimento armazenado retorna um erro.

O procedimento sysmail_add_profile_sp armazenado está no msdb banco de dados e pertence ao dbo esquema. 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

Um. Criar um novo perfil

O exemplo a seguir cria um novo perfil do Database Mail chamado AdventureWorks Administrator.

EXECUTE msdb.dbo.sysmail_add_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Profile used for administrative mail.';

B. Criar um novo perfil, salvando o ID do perfil em uma variável

O exemplo a seguir cria um novo perfil do Database Mail chamado AdventureWorks Administrator. O exemplo armazena o número de ID do perfil na variável @profileId e retorna um conjunto de resultados contendo o número de ID do perfil para o novo perfil.

DECLARE @profileId AS INT;

EXECUTE msdb.dbo.sysmail_add_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Profile used for administrative mail.',
    @profile_id = @profileId OUTPUT;

SELECT @profileId;

Conteúdo relacionado

  • Last updated on