Remarque :

Utilisez le package DBMS_CLOUD_NOTIFICATION pour envoyer un courriel à partir d'Oracle Autonomous Database

Introduction

Oracle Autonomous Database fournit une base de données facile à utiliser et entièrement autonome, d'une capacité élastique et sur laquelle les performances des requêtes sont excellentes. En tant que service, Autonomous Database ne nécessite pas d'administration de base de données.

Oracle Autonomous Database prend en charge le package DBMS_CLOUD_NOTIFICATION pour envoyer des messages et des résultats de requête sous forme de courriel. Ce package prend en charge l'envoi de courriels uniquement aux adresses SMTP publiques.

Remarque : le seul fournisseur de messagerie pris en charge est actuellement le service Oracle Cloud Infrastructure (OCI).

Objectifs

Pour envoyer des messages et la sortie d'une requête sous forme de courriel à partir d'Oracle Autonomous Database à l'aide du package DBMS_CLOUD_NOTIFICATION.

Prérequis

Tâche 1 : identifier et configurer la connexion SMTP

  1. Ouvrez le menu de navigation et cliquez sur Services de développeur. Sous Intégration d'application, cliquez sur Email Delivery.

  2. Dans le menu Ressources, cliquez sur Configuration.

    Configuration

    • Adresse publique : adresse publique à laquelle les courriels ont été envoyés, pour cette région.

    • SMTP Ports : ports SMTP utilisés pour accepter un courriel. Email Delivery prend en charge TLS sur le port 25 ou 587.

    • Sécurité : ce champ indique si TLS, le moyen standard de cryptage en transit des courriels, est utilisé. Les clients doivent crypter les courriels lorsqu'ils transfèrent vers Oracle Cloud Infrastructure Email Delivery. Les adresses électroniques cryptées sont protégées de la lecture pendant le transit.

Tâche 2 : génération d'informations d'identification SMTP pour Email Delivery

  1. Visualiser les détails utilisateur :

    • Si vous générez des informations d'identification SMTP pour vous-même : ouvrez le menu Profil et cliquez sur Paramètres d'utilisateur ou sur le nom de votre compte.
    • Si vous générez des informations d'identification SMTP en tant qu'administrateur pour un autre utilisateur, ouvrez le menu de navigation et cliquez sur Identité et sécurité. Sous Identité, cliquez sur Utilisateurs. Recherchez l'utilisateur dans la liste, puis cliquez sur son nom pour afficher ses détails.

  2. Cliquez sur Informations d'identification SMTP.

  3. Cliquez sur Générer des informations d'identification SMTP.

  4. Entrez la description des informations d'identification SMTP dans la boîte de dialogue.

  5. Cliquez sur Générer des informations d'identification SMTP. Un nom utilisateur et un mot de passe comme ci-dessous apparaissent.

    Informations d'identification

Tâche 3 : création d'un expéditeur approuvé pour Email Delivery

Enregistrez une adresse électronique d'expéditeur à utiliser pour la distribution des courriels.

  1. Ouvrez le menu de navigation et cliquez sur Services de développeur. Sous Intégration d'application, cliquez sur Email Delivery. Sous Email Delivery, cliquez sur Expéditeurs approuvés. Assurez-vous que vous êtes dans le bon compartiment. Votre utilisateur doit appartenir à un groupe doté des autorisations nécessaires pour gérer les expéditeurs approuvés dans ce compartiment.

  2. Sur la page Expédateurs approuvés, cliquez sur Expéditeur approuvé.

  3. Dans la boîte de dialogue Créer un expéditeur approuvé, fournissez les informations suivantes :

    • Saisissez l'adresse électronique à répertorier en tant qu'expéditeur approuvé.
    • (Facultatif) Ajoutez des balises pour organiser la ressource. Pour appliquer une balise définie, vous devez disposer de droits d'accès permettant d'utiliser l'espace de noms de balise. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas certain d'appliquer des balises, ignorez cette option (vous pouvez les appliquer ultérieurement) ou demandez à l'administrateur.

  4. Cliquez sur Créer un expéditeur approuvé.

  5. L'adresse électronique est ajoutée à la liste des émetteurs approuvés.

    Expéditeur

Remarque :

Tâche 4 : envoi de messages sous forme de courriel à partir d'Oracle Autonomous Database

  1. Provisionner une instance Oracle Autonomous Database : accédez à la page Détails, puis cliquez sur Actions de base de données. Une page de connexion s'ouvre pour Database Actions. Utilisez le compte administrateur par défaut de votre instance de base de données, Nom utilisateur - admin, puis cliquez sur Suivant. La page Database Actions apparaît. Dans la zone Développement, cliquez sur SQL.

    Actions de base de données

  2. Créez un objet d'informations d'identification et utilisez DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE pour envoyer un message en tant que courriel. Copiez et collez le fragment de code ci-dessous dans votre feuille de calcul 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;
/

    Utilisez le paramètre params pour spécifier l'expéditeur, smtp_host, l'objet, le destinataire et les destinataires d'une CC ou d'une Cci dans les valeurs string.

    • sender : ID de courriel de l'émetteur approuvé
    • smtp_host : nom d'hôte SMTP
    • subject : objet du courriel
    • recipient : ID de courriel des destinataires
    • to_cc : ID de courriel qui reçoivent une copie du courriel
    • to_bcc : ID de courriel qui reçoivent un Cci du courriel

  3. Veillez à cliquer sur le bouton Exécuter l'instruction pour l'exécuter dans SQL Worksheet.

    Envoyer un message

Une fois la procédure terminée, vous recevrez le courriel.

courriel

Tâche 5 : envoi des résultats de requête sous forme de courriel à partir d'Oracle Autonomous Database

  1. Vous pouvez utiliser le package DBMS_CLOUD_NOTIFICATION pour envoyer les résultats d'une requête sous forme de courriel. Par exemple, utilisez DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE pour envoyer un message avec la sortie de la requête - SELECT tablespace_name FROM dba_tablespaces ; comme courriel. Copiez et collez le fragment de code ci-dessous dans votre feuille de calcul 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. Veillez à cliquer sur le bouton Exécuter l'instruction pour l'exécuter dans SQL Worksheet.

    Envoyer les données

Une fois la procédure terminée, vous recevrez le courriel.

Courriel de requête

Etapes suivantes

Le package DBMS_CLOUD_NOTIFICATION est désormais pris en charge dans Oracle Autonomous Database. Nous venons de voir comment envoyer un courriel à l'aide de ce package. Si vous souhaitez en savoir plus sur Email Delivery ou sur DBMS_CLOUD_NOTIFICATION dans Oracle Autonomous Database, reportez-vous à la documentation Oracle Autonomous Database.

Remerciements

Ressources de formation supplémentaires

Explorez d'autres ateliers sur docs.oracle.com/learn ou accédez à davantage de contenu de formation gratuit sur le canal Oracle Learning YouTube. En outre, accédez à education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour consulter la documentation produit, consultez Oracle Help Center.