Observação:

Use o pacote DBMS_CLOUD_NOTIFICATION para enviar um e-mail do Oracle Autonomous Database

Introdução

O Oracle Autonomous Database fornece um banco de dados fácil de usar e totalmente autônomo que é dimensionado elasticamente e oferece rápido desempenho de consulta. Como serviço, o Autonomous Database não exige administração de banco de dados.

O Oracle Autonomous Database suporta o pacote DBMS_CLOUD_NOTIFICATION para enviar mensagens e consultar resultados como e-mail. Este pacote suporta o envio de e-mail apenas para pontos finais SMTP públicos.

Observação: no momento, o único provedor de e-mail suportado é o serviço Email Delivery do Oracle Cloud Infrastructure (OCI).

Objetivos

Para enviar mensagens e saída de uma consulta como e-mail do Oracle Autonomous Database usando o pacote DBMS_CLOUD_NOTIFICATION.

Pré-requisitos

Tarefa 1: Identificar e configurar a conexão SMTP

  1. Abra o menu de navegação e clique em Serviços ao Desenvolvedor. Em Integração do Aplicativo, clique em Email Delivery.

  2. No menu Recursos, clique em Configuração.

    Configuração

    • point público: O ponto final público usado para envio de um e-mail desta região.

    • Portas SMTP: As portas SMTP usadas para aceitar um e-mail. O Email Delivery suporta TLS na porta 25 ou 587.

    • Segurança: Esse campo indica se TLS, o meio padrão de executar criptografia em trânsito para e-mails, está sendo usado. Os clientes devem criptografar os e-mails enquanto estiverem em trânsito para o serviço Oracle Cloud Infrastructure Email Delivery. Os e-mails criptografados são protegidos de leitura durante o trânsito.

Tarefa 2: Gerar credenciais SMTP para o serviço Email Delivery

  1. Exibir os detalhes do usuário:

    • Se você estiver gerando credenciais SMTP para você mesmo: Abra o menu Perfil e clique em Definições do Usuário ou no nome da sua conta.
    • Se você for um administrador que está gerando credenciais SMTP para outro usuário: Abra o menu de navegação e clique em Identidade e Segurança. Em Identidade, clique em Usuários. Clique no nome do usuário para ver os detalhes.

  2. Clique em Credenciais SMTP.

  3. Clique em Gerar Credenciais SMTP.

  4. Digite uma Descrição das Credenciais SMTP na caixa de diálogo.

  5. Clique em Gerar Credenciais SMTP. Um nome de usuário e senha como abaixo é exibido.

    Credenciais

Tarefa 3: Criar remetentes aprovados para o Email Delivery

Registre um endereço de e-mail do remetente a ser usado para entrega de e-mail.

  1. Abra o menu de navegação e clique em Serviços ao Desenvolvedor. Em Integração do Aplicativo, clique em Email Delivery. Em Email Delivery, clique em Remetentes Aprovados. Verifique se você está no compartimento correto. Seu usuário deve estar em um grupo com permissões para gerenciar remetentes aprovados nesse compartimento.

  2. Na página Remetentes Aprovados, clique em Remetente Aprovado.

  3. Na caixa de diálogo Criar Remetente Aprovado, forneça as seguintes informações:

    • Informe o endereço de e-mail que deseja listar como remetente aprovado.
    • (Opcional) Adicione tags para organizar seu recurso. Para aplicar uma tag definida, você deverá ter permissões para usar o namespace de tag. Para obter mais informações sobre tags, consulte Tags de Recurso. Se você não tiver certeza se deve aplicar tags, ignore essa opção (você poderá aplicar tags posteriormente) ou pergunte ao administrador.

  4. Clique em criar remetente aprovado.

  5. O endereço de e-mail é adicionado à sua lista de Enviadores Aprovados.

    Remetente

Observação:

Tarefa 4: Enviar mensagens como e-mail do Oracle Autonomous Database

  1. Provisione um Oracle Autonomous Database: vá para a página Detalhes e clique em Database Actions. Uma página de acesso é aberta para o Database Actions. Use a conta de administrador padrão da instância do banco de dados, Nome do Usuário - admin e clique em Próximo. A página Ações do Banco de Dados será aberta. Na caixa Development, clique em SQL.

    Ações do BD

  2. Crie um objeto de credencial e use DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE para enviar uma mensagem como e-mail. Copie e cole o trecho de código abaixo em sua Planilha SQL.

    BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name => 'test',
        username        => 'username',
        password        => '************'
   );
   END;
/
BEGIN
   DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
        provider        => 'email',
        credential_name => 'test',
        message         => 'This message is to confirm that you have received an email from Autonomous Database',
        params          => json_object('recipient' value  '************',
                                       'to_cc'  value '************',
                                       'to_bcc' value ‘************’,
                                       'subject' value 'Test email',
                                       'smtp_host' value 'smtp.email.us-phoenix-1.oci.oraclecloud.com',
                                       'sender'    value  'send.email@test.com' )
   );
   END;
/

    Use o parâmetro params para especificar o remetente, smtp_host, assunto, destinatário e destinatários de um CC ou CCO em valores de string.

    • remetente: ID de e-mail do remetente aprovado
    • smtp_host: Nome do host SMTP
    • Assunto: Assunto do e-mail
    • destinatário: IDs de e-mail de destinatários
    • to_cc: IDs de e-mail que estão recebendo um CC do e-mail
    • to_bcc: IDs de e-mail que estão recebendo um Cco do e-mail

  3. Certifique-se de clicar no botão Executar Instrução para executá-la na Planilha SQL.

    Enviar mensagem

Assim que o procedimento for concluído com sucesso, você receberá o e-mail.

Mensagem de email

Tarefa 5: Enviar resultados da consulta como e-mail do Oracle Autonomous Database

  1. Você pode usar o pacote DBMS_CLOUD_NOTIFICATION para enviar os resultados de uma consulta como e-mail. Por exemplo, use DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE para enviar uma mensagem com a saída da consulta - SELECT tablespace_name FROM dba_tablespaces; como um e-mail. Copie e cole o trecho de código abaixo em sua Planilha SQL.

    BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
        credential_name => 'test',
        username        => ‘username’
        password        => '************'
   );
   END;
/
BEGIN
   DBMS_CLOUD_NOTIFICATION.SEND_DATA(
        provider        => 'email',
        credential_name => 'test',
        query           => 'SELECT tablespace_name FROM dba_tablespaces',
        params          => json_object('recipient' value  '************',
                                       'to_cc'  value '****************',
                                       'to_bcc' value '****************',
                                       'subject' value 'Tablespace Report',
                                       'type' value 'json',
                                       'title' value 'Tablespace report',
                                       'message' value 'Here is the tablespace report',
                                       'smtp_host' value 'smtp.email.us-phoenix-1.oci.oraclecloud.com',
                                       'sender'    value  'send.email@test.com' )
   );
   END;
/

  2. Certifique-se de clicar no botão Executar Instrução para executá-la na Planilha SQL.

    Enviar dados

Assim que o procedimento for concluído com sucesso, você receberá o e-mail.

Pesquisar e-mail

Próximas Etapas

O pacote DBMS_CLOUD_NOTIFICATION agora é suportado no Oracle Autonomous Database e acabamos de ver como enviar um e-mail usando este pacote. Se você quiser saber mais sobre o Email Delivery ou DBMS_CLOUD_NOTIFICATION no Oracle Autonomous Database, consulte a documentação do Oracle Autonomous Database.

Confirmações

Mais Recursos de Aprendizagem

Explore outros laboratórios no site docs.oracle.com/learn ou acesse mais conteúdo de aprendizado gratuito no canal YouTube do Oracle Learning. Além disso, visite education.oracle.com/learning-explorer para se tornar um Oracle Learning Explorer.

Para obter a documentação do produto, visite o Oracle Help Center.