Compartilhar via


Configurar o Database Mail

Aplica-se a: SQL Server

Este artigo descreve como habilitar e configurar o Database Mail usando o Assistente de Configuração do Database Mail e como criar um script de configuração do Database Mail usando modelos.

Antes de começar

Use a opção DatabaseMail XPs para habilitar o Database Mail neste servidor. Para obter mais informações, consulte o artigo de referência Opção de Configuração de Servidores XPs do Database Mail.

Limitações e Restrições

A habilitação do SQL Server Service Broker em qualquer banco de dados exige um bloqueio de banco de dados. Se o Service Broker tiver sido desativado no msdb, para habilitar o Database Mail primeiro interrompa o SQL Server Agent para que o Service Broker possa obter o bloqueio necessário.

Segurança

Para configurar o Database Mail, você deve ser membro da função de servidor fixa sysadmin. Para enviar um e-mail com o Database Mail, você deve ser membro da função de banco de dados DatabaseMailUserRole no banco de dados msdb.

Solucionar problemas

Para solucionar problemas do Database Mail, visite:

Usar o Assistente de Configuração do Database Mail

Para configurar o Database Mail usando um assistente

As etapas a seguir usam o SSMS (SQL Server Management Studio). Baixe a versão mais recente do SSMS em aka.ms/ssms.

  1. No Pesquisador de Objetos, expanda o nó da instância em que você deseja configurar o Database Mail.

  2. Expanda o nó Gerenciamento .

  3. Clique com o botão direito do mouse em Database Mail e selecione Configurar Database Mail.

  4. Conclua as etapas das caixas de diálogo do assistente.

Página inicial

Esta página descreve as etapas de configuração do Database Mail.

Não mostrar esta página novamente – marque essa opção para não exibir novamente esta página de boas-vindas.

Avançar – Segue para a página Selecionar uma tarefa de configuração .

Cancelar - Encerra o assistente sem configurar o Database Mail.

Selecionar Tarefa de Configuração

Use a página Selecionar Tarefa de Configuração para indicar qual tarefa será concluída sempre que você usar o assistente. Se você mudar de ideia antes de concluir o assistente, use o botão Voltar para voltar para essa página e selecionar outra tarefa.

Observação

Se o Database Mail não tiver sido habilitado, você receberá a mensagem: O recurso Database Mail não está disponível. Gostaria de ativar esse recurso? Responder Sim, equivale a habilitar o Database Mail usando a opçãoDatabase Mail XPs do procedimento armazenado do sistema sp_configure.

Instalar Database Mail executando as seguintes tarefas
Execute todas as tarefas exigidas para instalar o Database Mail pela primeira vez. Essa opção inclui todas as outras três opções.

Gerenciar contas e perfis do Database Mail
Crie novas contas e perfis do Database Mail ou exiba, altere ou exclua contas e perfis existentes do Database Mail.

Gerenciar segurança do perfil
Configure quais usuários têm acesso a perfis do Database Mail.

Exibir ou alterar parâmetros do sistema
Configure parâmetros de sistema do Database Mail, como o tamanho máximo de arquivo para anexos.

Página Nova Conta

Use esta página para criar uma nova conta do Database Mail. Uma conta do Database Mail contém informações para enviar email a um servidor SMTP.

Uma conta do Database Mail contém as informações que o SQL Server usa para enviar mensagens de email a um servidor SMTP. Cada conta contém informações de um servidor de email.

Uma conta do Database Mail só é usada no Database Mail. Uma conta do Database Mail não corresponde a uma conta do SQL Server ou uma conta do Microsoft Windows. O Database Mail pode ser enviado usando as credenciais do Mecanismo de Banco de Dados do SQL Server, usando outras credenciais que você fornece ou anonimamente. Quando a autenticação básica é usada, o nome do usuário e a senha em uma conta do Database Mail só são usados para autenticação no servidor de email. Uma conta não precisa corresponder a um usuário no SQL Server ou a um usuário no computador que executa o SQL Server.

Account name
Digite o nome da nova conta.

Descrição
Digite uma descrição da conta. A descrição é opcional.

Endereço de email
Digite o nome do endereço de email da conta. Este é o endereço de email da conta que o enviou. Por exemplo, uma conta do SQL Server Agent pode enviar email do endereço SqlAgent@Adventure-Works.com.

Nome de exibição
Digite o nome que será exibido nas mensagens de email enviadas por essa conta. O nome para exibição é opcional. Este é o nome exibido em mensagens enviadas desta conta. Por exemplo, uma conta do SQL Server Agent pode exibir o nome "SQL Server Agent Automated Mailer" em mensagens de email.

Email de resposta
Digite o endereço de email que é usado para respostas a mensagens de email enviadas por essa conta. O email de resposta é opcional. Por exemplo, respostas a uma conta do SQL Server Agent podem ir para o administrador de banco de dados, danw@Adventure-Works.com.

Nome do servidor
Digite o nome ou o endereço IP do servidor SMTP que a conta usa para enviar email. Normalmente, isso ocorre em um formato semelhante a smtp.<your_company>.com. Para obter mais ajuda sobre isso, consulte o administrador de mail.

Número da porta
Digite o número da porta do servidor SMTP para a conta. A maioria dos servidores SMTP usa a porta 25 ou 587 ou a porta 465 para conexões SSL.

Esse servidor requer uma conexão segura (SSL)
Criptografa a comunicação usando o Protocolo SSL.

Autenticação do Windows usando as credenciais do serviço Mecanismo de Banco de Dados
A conexão é estabelecida com o servidor SMTP usando as credenciais configuradas para o serviço do Mecanismo de Banco de Dados do SQL Server. A autenticação no servidor de email com as credenciais de serviço é executada por meio da autenticação NTLM, uma opção disponível apenas para o Exchange no local. Para obter mais informações, consulte Autenticação e EWS no Exchange.

Autenticação básica
Especifique o nome do usuário e a senha exibidos pelo servidor SMTP.

Nome de usuário
Digite o nome de usuário que o Database Mail usa para se conectar ao servidor SMTP. O nome do usuário será necessário se o servidor SMTP exigir autenticação básica.

Senha
Digite a senha que o Database Mail usa para se conectar ao servidor SMTP. A senha será necessária se o servidor SMTP exigir autenticação básica.

Confirmar senha
Digite a senha novamente para confirmar. A senha será necessária se o servidor SMTP exigir autenticação básica.

Autenticação anônima
O email é enviado ao servidor SMTP sem credenciais de logon. Use essa opção quando o servidor SMTP não exigir autenticação.

Página Gerenciar Conta Existente

Use esta página para gerenciar uma conta de Database Mail existente.

Account name
Selecione a conta a exibir, atualizar ou excluir.

Delete (excluir)
Excluir a conta selecionada. Você deve remover esta conta de perfis associados, ou excluir esses perfis, antes de excluir a conta selecionada.

Descrição
Exiba ou atualize a descrição da conta. A descrição é opcional.

Endereço de email
Exiba ou atualize o nome do endereço de email da conta. Este é o endereço de email da conta que o enviou. Por exemplo, uma conta do Microsoft SQL Server Agent pode enviar email pelo endereço SqlAgent@Adventure-Works.com.

Nome de exibição
Exiba ou atualize o nome a ser exibido em mensagens de email enviadas desta conta. O nome para exibição é opcional. Este é o nome exibido em mensagens enviadas desta conta. Por exemplo, uma conta do SQL Server Agent pode exibir o nome SQL Server Agent Automated Mailer em mensagens de email.

Email de resposta
Exiba ou atualize o endereço de email que será usado em respostas a mensagens de email enviadas desta conta. O email de resposta é opcional. Por exemplo, respostas a uma conta do SQL Server Agent podem ir para o administrador de banco de dados, danw@Adventure-Works.com.

Nome do servidor
Exibe ou atualiza o nome do servidor SMTP que a conta usa para enviar email. Normalmente, isso ocorre em um formato semelhante a smtp.<your_company>.com. Para obter mais ajuda sobre isso, consulte o administrador de mail.

Número da porta
Exiba ou atualize o número da porta do servidor SMTP desta conta. A maioria dos servidores SMTP usa a porta 25 ou 587 ou a porta 465 para conexões SSL.

Esse servidor requer uma conexão segura (SSL)
Criptografa a comunicação usando o Protocolo SSL.

Autenticação do Windows usando as credenciais do serviço Mecanismo de Banco de Dados
A conexão é estabelecida com o servidor SMTP usando as credenciais configuradas para o serviço do Mecanismo de Banco de Dados do SQL Server.

Autenticação básica
Especifique o nome do usuário e a senha exibidos pelo servidor SMTP.

Nome de usuário
Visualize ou atualize o nome de usuário que o Database Mail usa para se conectar ao servidor SMTP. O nome do usuário será necessário se o servidor SMTP exigir autenticação básica.

Senha
Altere a senha que o Database Mail usa para se conectar ao servidor SMTP. A senha será necessária se o servidor SMTP exigir autenticação básica.

Confirmar senha
Digite a senha novamente para confirmar. A senha será necessária se o servidor SMTP exigir autenticação básica.

Autenticação anônima
O email é enviado ao servidor SMTP sem credenciais de logon. Use essa opção quando o servidor SMTP não exigir autenticação.

Página Novo Perfil

Use essa página para criar um perfil do Database Mail. Um perfil do Database Mail é uma coleção de contas do Database Mail. Os perfis melhoram a confiabilidade nos casos em que um servidor de email não pode ser acessado, oferecendo contas alternativas do Database Mail. É necessário pelo menos uma conta do Database Mail. Para obter mais informações sobre como definir a prioridade das contas do Database Mail no perfil, veja Criar um perfil do Database Mail.

Use os botões Mover para Cima e Mover para Baixo para alterar a ordem na qual as contas do Database Mail são usadas. Essa ordem é determinada por um valor chamado número de sequência. Mover para Cima diminui o número de sequência e Mover para Baixo aumenta o número de sequência. O número de sequê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 sequência mais baixo. Se essa conta falhar, o Database Mail usará a conta com o próximo número de sequê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 sequência mais alto falhe. Se a conta com o número de sequência mais alto falhar, o Database Mail pausará as tentativas de envio de email pelo tempo configurado no parâmetro AccountRetryDelay no Database Mail e iniciará o processo de tentar enviar o email novamente, começando pelo número de sequência mais baixo. Use o parâmetro AccountRetryAttempts do Database Mail para configurar o número de vezes em que o processo de email externo tenta enviar a mensagem de email usando cada conta no perfil especificado. Você pode configurar os parâmetros AccountRetryDelay e AccountRetryAttempts na página Configurar Parâmetros do Sistema do Assistente para Configuração do Database Mail.

Nome do perfil
Digite o nome para o novo perfil. O perfil é criado com esse nome. Não use o nome de um perfil existente.

Observação

Para enviar email usando trabalhos do SQL Agent na Instância Gerenciada de SQL do Azure, o SQL Server Agent pode usar apenas um perfil do Database Mail, e ele deve se chamar AzureManagedInstance_dbmail_profile. 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.

Descrição
Digite uma descrição para o perfil. A descrição é opcional.

Contas SMTP
Escolha uma ou mais contas para o perfil. A prioridade define a ordem na qual o Database Mail usa as contas. Se nenhuma conta estiver listada, você deverá selecionar Adicionar para continuar e adicionar uma nova conta SMTP.

Adicionar
Adiciona uma conta ao perfil.

Remover
Remove a conta selecionada do perfil.

Mover para Cima
Aumente a prioridade da conta selecionada.

Mover para Baixo
Diminua a prioridade da conta selecionada.

Página Gerenciar Perfil Existente

Use esta página para gerenciar um perfil existente no Database Mail. Um perfil do Database Mail é uma coleção de contas do Database Mail. Os perfis melhoram a confiabilidade nos casos em que um servidor de email não pode ser acessado, oferecendo contas alternativas do Database Mail. É necessário pelo menos uma conta do Database Mail. Para obter mais informações sobre como definir a prioridade das contas do Database Mail no perfil, veja Criar um perfil do Database Mail.

Use os botões Mover para Cima e Mover para Baixo para alterar a ordem na qual as contas do Database Mail são usadas. Essa ordem é determinada por um valor chamado número de sequência. Mover para Cima diminui o número de sequência e Mover para Baixo aumenta o número de sequência. O número de sequê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 sequência mais baixo. Se essa conta falhar, o Database Mail usará a conta com o próximo número de sequê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 sequência mais alto falhe. Se a conta com o número de sequência mais alto falhar, o Database Mail pausará as tentativas de envio de email pelo tempo configurado no parâmetro AccountRetryDelay no Database Mail e iniciará o processo de tentar enviar o email novamente, começando pelo número de sequência mais baixo. Use o parâmetro AccountRetryAttempts do Database Mail para configurar o número de vezes em que o processo de email externo tenta enviar a mensagem de email usando cada conta no perfil especificado. Você pode configurar os parâmetros AccountRetryDelay e AccountRetryAttempts na página Configurar Parâmetros do Sistema do Assistente para Configuração do Database Mail.

Nome do perfil
Selecione o nome do perfil a gerenciar.

Delete (excluir)
Exclui o perfil selecionado. Você será solicitado a selecionar Sim para excluir o perfil selecionado e reprovar todas as mensagens não enviadas, ou a selecionar Não para excluir o perfil selecionado somente se não houver mensagens não enviadas.

Descrição
Exibe ou altera a descrição do perfil selecionado. A descrição é opcional.

Contas SMTP
Escolha uma ou mais contas para o perfil. A prioridade de failover define a ordem na qual o Database Mail usa a conta no caso de um failover.

Adicionar
Adiciona uma conta ao perfil.

Remover
Remove a conta selecionada do perfil.

Mover para Cima
Aumenta a prioridade de failover da conta selecionada.

Mover para Baixo
Diminui a prioridade de failover da conta selecionada.

Prioridade
Exibe a prioridade de failover atual da conta.

Account name
Exibe o nome da conta.

E-mail Address
Exibe o endereço de email da conta.

Página Adicionar conta ao Perfil

Use esta página para escolher a conta a ser adicionada ao perfil. Escolha uma conta existente na caixa Nome da conta ou selecione Nova conta.

Account name
Selecione o nome da conta a ser adicionada ao perfil.

Endereço de email
Visualize o endereço de email da conta selecionada. Não é possível alterar o endereço de email nessa página. Para alterar o endereço de email dessa conta, volte para a página principal do assistente e selecione a opção Gerenciar contas e perfis do Database Mail .

Nome do servidor
Visualize o nome do servidor de email da conta selecionada. Não é possível alterar o nome do servidor nessa página. Para alterar o nome do servidor dessa conta, volte para a página principal do assistente e selecione a opção Gerenciar contas e perfis do Database Mail .

Nova Conta
Crie uma conta nova.

Página Gerenciar Contas e Perfis

Use esta página para escolher uma tarefa para gerenciar um perfil ou conta.

Criar uma conta nova
Crie uma conta nova.

Visualizar, alterar ou excluir uma conta existente
Gerencie ou exclua uma conta existente.

Criar um novo perfil
Criar um novo perfil.

Exibir, alterar ou excluir um perfil existente. Também é possível gerenciar contas associadas ao perfil.
Atualize ou exclua um perfil existente. Essa opção também permite gerenciar contas associadas ao perfil.

Gerenciar Segurança do Perfil, guia Público

Use essa página para configurar um perfil público.

Perfis são públicos ou privados. Um perfil privado é acessível somente para usuários ou funções específicas. Um perfil público permite a qualquer usuário ou função com acesso ao banco de dados do host de email (msdb) enviar um email usando esse perfil.

Um perfil pode ser um perfil padrão. Nesse caso, usuários ou funções podem enviar e-mails por meio do perfil sem especificá-lo explicitamente. Se o usuário ou função que envia a mensagem de e-mail tiver um perfil privado padrão, o Database Mail irá utilizá-lo. Se o usuário ou a função não tiver um perfil privado padrão, sp_send_dbmail usará o perfil público padrão para o banco de dados msdb. Se não houver um perfil privado padrão para o usuário ou a função e nenhum perfil público padrão para o banco de dados, sp_send_dbmail retornará um erro. Somente um perfil pode ser marcado como o perfil padrão.

Pública
Selecione essa opção para tornar público o perfil especificado.

Profile Name
Exibe o nome do perfil.

Observação

Para enviar email usando trabalhos do SQL Agent na Instância Gerenciada de SQL do Azure, o SQL Server Agent pode usar apenas um perfil do Database Mail, e ele deve se chamar AzureManagedInstance_dbmail_profile. 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.

Perfil Padrão
Selecione essa opção para transformar o perfil especificado em perfil padrão.

Mostrar somente os perfis públicos existentes
Selecione essa opção para mostrar somente perfis públicos no banco de dados especificado.

Gerenciar Segurança do Perfil, guia Particular

Use essa página para configurar um perfil privado.

Perfis são públicos ou privados. Um perfil privado é acessível somente para usuários ou funções específicas. Um perfil público permite a qualquer usuário ou função com acesso ao banco de dados do host de email (msdb) enviar um email usando esse perfil.

Um perfil pode ser um perfil padrão. Nesse caso, usuários ou funções podem enviar e-mails por meio do perfil sem especificá-lo explicitamente. Se o usuário ou função que envia a mensagem de e-mail tiver um perfil privado padrão, o Database Mail irá utilizá-lo. Se o usuário ou a função não tiver um perfil privado padrão, sp_send_dbmail usará o perfil público padrão para o banco de dados msdb. Se não houver um perfil privado padrão para o usuário ou a função e nenhum perfil público padrão para o banco de dados, sp_send_dbmail retornará um erro.

Nome de usuário
Selecione o nome de um usuário ou de uma função no banco de dados msdb.

Acesso
Selecione se o usuário ou função tem acesso ao perfil especificado.

Nome do perfil
Exibir nome do perfil.

É Perfil Padrão
Selecione se o perfil é o perfil padrão para o usuário ou função. Cada usuário ou função pode ter apenas um perfil de padrão.

Mostrar somente os perfis particulares existentes deste usuário
Selecione essa opção para exibir apenas perfis aos quais o usuário ou função especificados já tenham acesso.

Configurar Parâmetros do Sistema

Use esta página para especificar parâmetros de sistema do Database Mail. Exibe os parâmetros de sistema e o valor atual de cada parâmetro. Selecione um parâmetro para exibir uma breve descrição no painel de informações.

Tentativas de Repetição de Conta
O número de vezes que o processo de email externo tenta enviar a mensagem de email usando cada conta no perfil especificado.

Atraso na Repetição de Conta (segundos)
O tempo, em segundos em que o processo de email externo espera, depois de tentar enviar uma mensagem usando todas as contas no perfil, antes de tentar todas as contas novamente.

Tamanho Máximo do Arquivo (Bytes)
O tamanho máximo de um anexo, em bytes.

Extensões de Arquivo de Anexo Proibidas
Uma lista separada por vírgula de extensões que não podem ser enviadas como um anexo a uma mensagem de email. Selecione o botão de navegação (...) para adicionar outras extensões.

Tempo Mínimo de Vida do Executável do Database Mail (segundos)
O período mínimo de tempo, em segundos, que o processo de email externo permanece ativo. O processo permanece ativo enquanto houver emails na fila do Database Mail. Esse parâmetro especifica o tempo que o processo permanece ativo se não houver nenhuma mensagem a processar.

Nível de log
Especifique quais mensagens são registradas no log do Database Mail. Os valores possíveis são:

  • Normal - só registra erros

  • Estendido - registra erros, avisos e mensagens informativas

  • Detalhado - registra erros, avisos, mensagens informativas, mensagens de êxito e mensagens internas adicionais. Use log detalhado para solucionar problemas.

O valor padrão é Estendido.

Redefinir Tudo
Selecione esta opção para restaurar os valores da página aos valores padrão originais.

Página Concluir o Assistente

Use essa página para revisar as ações executadas pelo Assistente de Configuração do Database Mail. Nenhuma alteração é feita até que você conclua o assistente.

Página Enviar Email de Teste

Para obter um tutorial rápido para enviar um email de teste, consulte Enviar um email de teste com database mail.

Use a página Enviar Email de Teste de<nome_instância> para enviar uma mensagem de email usando o perfil do Database Mail especificado. Só os membros da função de servidor fixa sysadmin podem enviar email de teste usando essa página.

Perfil do Database Mail
Selecione um perfil da lista do Database Mail. Esse é um campo obrigatório. Se nenhum perfil for exibido, significa que não há perfis ou que você não tem permissão para um perfil. Use o Assistente para Configuração do Database Mail para criar e configurar perfis. Se nenhum perfil for listado, use o Assistente para Configuração do Database Mail para criar um perfil para seu uso.

Para
O endereço de email dos destinatários da mensagem. Exige-se pelo menos um destinatário.

Assunto
A linha de assunto para o email de teste. Altere o assunto padrão para identificar melhor seu email para solucionar problemas.

Corpo
O corpo do email de teste. Altere o assunto padrão para identificar melhor seu email para solucionar problemas.

A caixa de diálogo Email de Teste do Database Mail confirma que o Database Mail tentou enviar a mensagem de teste e fornece a mailitem_id para a mensagem de teste de email. Confirme com o destinatário para determinar se o email foi recebido. Geralmente, o email é recebido dentro de poucos minutos, mas o email pode ser atrasado por um desempenho lento da rede, por uma lista de pendências de mensagens no servidor de email ou caso o servidor esteja temporariamente indisponível. Use mailitem_id para solucionar problemas.

Enviar email

A mailitem_id da mensagem de teste de email.

Solucionar problemas

Selecionar esse botão leva você a este documento, Configurar o Database Mail.

Usar modelos do SQL Server Management Studio para gerar T-SQL

Para criar um script T-SQL de configuração do Database Mail

  1. No SQL Server Management Studio (SSMS), na página Visualizar menu, selecione Explorador de Modelos.

  2. Na janela Explorador de Modelos , expanda a pasta Database Mail .

  3. Clique duas vezes em Configuração Simples do Database Mail. O modelo é aberto em uma nova janela de consulta.

  4. No menu Consulta , selecione Especificar Valores para Parâmetros de Modelo. A janela Substituir Parâmetros de Modelo é exibida.

  5. Digite os valores para profile_name, account_name, SMTP_servername, email_addresse display_name. O SQL Server Management Studio preenche o modelo com os valores fornecidos por você.

  6. Execute o script para criar a configuração.

  7. O script não concede acesso ao perfil para nenhum usuário do banco de dados. Portanto, por padrão, o perfil pode ser usado apenas por membros da função de segurança fixa sysadmin . Para obter mais informações sobre como conceder acesso a perfis, consulte sysmail_add_principalprofile_sp (Transact-SQL)