sysmail_add_profile_sp (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Cria um novo perfil do Database Mail .

Convenções de sintaxe de Transact-SQL

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 para o novo perfil. @profile_name é sysname, sem padrão.

Para enviar emails usando trabalhos do SQL Server Agent na Instância Gerenciada de SQL do Azure, o SQL Server Agent pode usar apenas um perfil do Database Mail e ele deve ser chamado AzureManagedInstance_dbmail_profilede . Para obter mais informações e um script de exemplo, consulte Notificações de trabalhos do SQL Agent da Instância Gerenciada de SQL 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 para o novo perfil. @profile_id é int, com um padrão de NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

Um perfil 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 esse 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 a ID do perfil permanece constante durante a vida útil 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 retornará 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

Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.

Exemplos

R. Criar um novo perfil

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

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

B. Crie 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 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