Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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 envoyer des e-mails directement à partir de votre base de données en utilisant le package UTL_MAIL. Amazon RDS prend en charge UTL_MAIL pour les versions suivantes d'Oracle :
Oracle Database 21c (21.0.0.0), toutes les versions
Oracle Database 19c (19.0.0.0), toutes les versions
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 Configuration de l'accès UTL_HTTP à l'aide de certificats et d'un portefeuille 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 politiques 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é.
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 :
Créer un groupe d'options ou copier ou modifier un groupe existant.
Ajoutez l'option au groupe d'options.
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
-
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 :
-
Pour Moteur, sélectionnez l'édition d'Oracle que vous voulez utiliser.
-
Pour Version majeure du moteur, choisissez la version de votre instance de base de données.
Pour plus d'informations, consultez Création d’un groupe d’options.
-
-
Ajouter l'option UTL_MAIL au groupe d'options. Pour plus d'informations sur l'ajout d'options, consultez Ajout d’une option à un groupe d’options.
-
Appliquez le groupe d'options à une instance de base de données nouvelle ou existante:
-
Pour une nouvelle instance de base de données, vous appliquez le groupe d'options lorsque vous lancez l'instance. Pour plus d'informations, consultez Création d'une instance de base de données Amazon RDS.
-
Pour une instance de base de données existante, vous appliquez le groupe d'options en modifiant l'instance et en attachant le nouveau groupe d'options. Pour plus d'informations, consultez Modification d'une instance de base de données Amazon RDS.
-
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
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 Amazon RDS.
Résolution des problèmes
Problèmes que vous pouvez rencontrer lorsque vous utilisez UTL_MAIL avec Amazon RDS :
-
Limitation. Le port SMTP (25) est limité en fonction des politiques du propriétaire de l'interface réseau Elastic. Si vous pouvez envoyer des e-mails en utilisant UTL_MAIL et que l'erreur
ORA-29278: SMTP transient error: 421 Service not availables'affiche, vous faites peut-être l'objet d'une limitation. Si vous rencontrez une limitation dans le cadre de la remise d'e-mails, nous vous recommandons d'implémenter un algorithme d'interruption. Pour plus d'informations sur les algorithmes de backoff, consultez Nouvelles tentatives après erreur et backoff exponentiel dans AWS et Comment traiter une erreur « throttling – Maximum sending rate exceeded ». Vous pouvez demander que cette limitation soit supprimée. Pour de plus amples informations, veuillez consulter Comment supprimer la limitation du port 25 à partir de mon instance EC2 ?
.
