Amazon Relational Database Service
Guide de l'utilisateur

Oracle UTL_MAIL

Amazon RDS prend en charge Oracle UTL_MAIL via l'utilisation de l'option UTL_MAIL et des serveurs SMTP. Vous pouvez directement envoyez des e-mail de votre base de données à l'aide du package UTL_MAIL. Amazon RDS prend en charge UTL_MAIL pour les versions suivantes d'Oracle :

  • Oracle version 18.0.0.0, toutes les versions

  • Oracle version 12.2.0.1, toutes les versions

  • Oracle, versions 12.1.0.2.v5 et ultérieures

  • Oracle, versions 11.2.0.4.v9 et ultérieures

Voici quelques limitations à l'utilisation de UTL_MAIL :

  • UTL_MAIL ne prend pas en charge le certificat TLS (Transport Layer Security) et les e-mails ne sont donc pas chiffrés.

    Pour vous connecter en toute sécurité aux ressources SSL/TLS distantes en créant et en chargeant des portefeuilles Oracle personnalisés, suivez les instructions dans Utilisation de utl_http, utl_tcp et utl_smtp avec une instance de base de données Oracle.

    Les certificats spécifiques requis pour votre portefeuille varient par service. Pour les services AWS, vous les trouverez généralement dans le Référentiel des services d'approbation Amazon.

  • UTL_MAIL ne prend pas en charge l'authentification avec les serveurs SMTP.

  • Vous ne pouvez envoyer qu'une seule pièce jointe dans un e-mail.

  • Vous ne pouvez pas envoyer de pièces jointes de plus de 32 Ko.

  • Vous pouvez uniquement utiliser des codages de caractères ASCII et EBCDIC (Extended Binary Coded Decimal Interchange Code).

  • Le port SMTP (25) est limité en fonction des stratégies du propriétaire de l'interface réseau Elastic.

Lorsque vous activez UTL_MAIL, seul l'utilisateur principal pour votre instance de base de données se voir accorder le privilège d'exécution. Si nécessaire, l'utilisateur principal peut accorder le privilège d'exécution à d'autres utilisateurs de sorte qu'ils puissent utiliser UTL_MAIL.

Important

Nous vous recommandons d'activer la fonctionnalité d'audit intégrée d'Oracle pour suivre l'utilisation des procédures UTL_MAIL.

Prérequis pour Oracle UTL_MAIL

Les conditions suivantes sont requises pour utiliser Oracle UTL_MAIL :

  • Un ou plusieurs serveurs SMTP et les adresses IP correspondantes ou noms DNS (Domain Name Server) publics ou privés correspondants. Pour plus d'informations sur la résolution des noms DNS privés grâce à un serveur DNS personnalisé, consultez Configuration d'un serveur DNS personnalisé.

  • Pour les versions d'Oracle antérieures à 12c, votre instance de base de données doit également utiliser l'option DB XML. Pour plus d'informations, consultez Oracle XML DB.

Ajout de l'option UTL_MAIL d'Oracle

Le processus général d'ajout de l'option UTL_MAIL d'Oracle à une instance de base de données est le suivant :

  1. Créer un groupe d'options ou copier ou modifier un groupe existant.

  2. Ajouter l'option au groupe d'options.

  3. Associez le groupe d'options à l'instance de base de données.

Une fois l'option UTL_MAIL ajoutée, dès que le groupe d'options est actif, UTL_MAIL est actif.

Pour ajouter l'option UTL_MAIL à une instance de base de données

  1. Déterminez le groupe d'options que vous voulez utiliser. Vous pouvez créer un groupe d'options ou utiliser un groupe d'options existant. Si vous souhaitez utiliser un groupe d'options existant, passez à l'étape suivante. Sinon, créez un groupe d'options DB personnalisé avec les paramètres suivants :

    1. Pour Moteur, sélectionnez l'édition d'Oracle que vous voulez utiliser.

    2. Pour Version majeure du moteur, choisissez la version de votre instance de base de données.

    Pour de plus amples informations, veuillez consulter Création d'un groupe d'options.

  2. Ajouter l'option UTL_MAIL au groupe d'options. Pour de plus amples informations sur l'ajout d'options, veuillez consulter Ajout d'une option à un groupe d'options.

  3. Appliquez le groupe d'options à une instance de base de données nouvelle ou existante:

Utilisation de l'option UTL_MAIL d'Oracle

Une fois que vous activez l'option UTL_MAIL, vous devez configurer le serveur SMTP avant de pouvoir commencer à l'utiliser.

Vous configurez le serveur SMTP en définissant le paramètre SMTP_OUT_SERVER à une adresse IP ou à un nom DNS public valide. Pour le paramètre SMTP_OUT_SERVER, vous pouvez spécifier une liste séparée par des virgules des adresses de plusieurs serveurs. Si le premier serveur n'est pas disponible, UTL_MAIL essaie le serveur suivant et ainsi de suite.

Vous pouvez définir la valeur par défaut SMTP_OUT_SERVER pour une instance de base de données à l'aide d'un groupe de paramètres de base de données. Vous pouvez définir le paramètre SMTP_OUT_SERVER pour une session en exécutant le code suivant sur votre base de données dans votre instance de base de données.

ALTER SESSION SET smtp_out_server = mailserver.domain.com:25;

Une fois que l'option UTL_MAIL est activée, et que votre SMTP_OUT_SERVER est configuré, vous pouvez envoyer un message à l'aide de la procédure SEND. Pour plus d'informations, consultez UTL_MAIL dans la documentation Oracle.

Suppression de l'option UTL_MAIL d'Oracle

Vous pouvez supprimer l'option UTL_MAIL d'Oracle d'une instance de base de données.

Pour supprimer l'option UTL_MAIL d'une instance de base de données, effectuez une des actions suivantes :

  • Pour supprimer l'option UTL_MAIL de plusieurs instances de bases de données, supprimez l'option UTL_MAIL du groupe d'option auquel elles appartiennent. Ce changement affecte toutes les instances de bases de données qui utilisent le groupe d'options. Pour plus d'informations, consultez Suppression d'une option d'un groupe d'options.

  • Pour supprimer l'option UTL_MAIL d'une seule instance de base de données, modifiez l'instance de base de données et spécifiez un autre groupe d'options qui n'inclut pas l'option UTL_MAIL. Vous pouvez spécifier le groupe d'options (vide) par défaut, ou un groupe d'options personnalisées différent. Pour plus d'informations, consultez Modification d'une instance de base de données exécutant le moteur de base de données Oracle.

Dépannage

Problèmes que vous pouvez rencontrer lorsque vous utilisez UTL_MAIL avec Amazon RDS :

Rubriques connexes