sysmail_add_profile_sp (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed Instance

Cria um novo perfil do Correio de Base de Dados .

Transact-SQL convenções de sintaxe

Sintaxe

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

Argumentos

[ @profile_name = ] N'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 Correio de Base de Dados 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 = ] 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 Correio de Base de Dados contém qualquer número de contas do Correio de Base de Dados. Os procedimentos armazenados do Correio de Base de Dados 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 Correio de Base de Dados 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 Correio de Base de Dados 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