Oracle UTL_MAIL - Amazon Relational Database Service

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

  • Oracle Database 12c version 2 (12.2), toutes les versions

  • Oracle Database 12c version 1 (12.1), version 12.1.0.2.v5 et ultérieure

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é.

  • 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. Ajoutez 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 plus d'informations, consultez Création d'un groupe d'options.

  2. 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.

  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 Amazon RDS.

Résolution des problèmes

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