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\$1MAIL
Amazon RDS prend en charge Oracle UTL\$1MAIL via l'utilisation de l'option UTL\$1MAIL et des serveurs SMTP. Vous pouvez envoyer des e-mails directement à partir de votre base de données en utilisant le package UTL\$1MAIL. Amazon RDS prend en charge UTL\$1MAIL 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\$1MAIL :
+ UTL\$1MAIL 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\$1HTTP à l'aide de certificats et d'un portefeuille Oracle](Oracle.Concepts.ONA.md).
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](https://www.amazontrust.com/repository/).
+ UTL\$1MAIL 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\$1MAIL, 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\$1MAIL.
**Important**
Nous vous recommandons d'activer la fonctionnalité d'audit intégrée d'Oracle pour suivre l'utilisation des procédures UTL\$1MAIL.
## Prérequis pour Oracle UTL\$1MAIL
Les conditions suivantes sont requises pour utiliser Oracle UTL\$1MAIL :
+ 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é](Appendix.Oracle.CommonDBATasks.System.md#Appendix.Oracle.CommonDBATasks.CustomDNS).
## Ajout de l'option UTL\$1MAIL d'Oracle
Le processus général d'ajout de l'option UTL\$1MAIL 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.
1. Ajoutez l'option au groupe d'options.
1. Associez le groupe d'options à l'instance de base de données.
Une fois l'option UTL\$1MAIL ajoutée, dès que le groupe d'options est actif, UTL\$1MAIL est actif.
**Pour ajouter l'option UTL\$1MAIL à 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.
1. 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](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create).
1. Ajouter l'option **UTL\$1MAIL** au groupe d'options. Pour plus d'informations sur l'ajout d'options, consultez [Ajout d’une option à un groupe d’options](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption).
1. 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](USER_CreateDBInstance.md).
+ 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](Overview.DBInstance.Modifying.md).
## Utilisation de l'option UTL\$1MAIL d'Oracle
Une fois que vous activez l'option UTL\$1MAIL, vous devez configurer le serveur SMTP avant de pouvoir commencer à l'utiliser.
Vous configurez le serveur SMTP en définissant le paramètre SMTP\$1OUT\$1SERVER à une adresse IP ou à un nom DNS public valide. Pour le paramètre SMTP\$1OUT\$1SERVER, 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\$1MAIL essaie le serveur suivant et ainsi de suite.
Vous pouvez définir la valeur par défaut SMTP\$1OUT\$1SERVER pour une instance de base de données à l'aide d'un [groupe de paramètres de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html). Vous pouvez définir le paramètre SMTP\$1OUT\$1SERVER pour une session en exécutant le code suivant sur votre base de données dans votre instance de base de données.
```
1. ALTER SESSION SET smtp_out_server = mailserver.domain.com:25;
```
Une fois que l'option UTL\$1MAIL est activée, et que votre SMTP\$1OUT\$1SERVER est configuré, vous pouvez envoyer un message à l'aide de la procédure `SEND`. Pour plus d'informations, consultez [UTL\$1MAIL](http://docs.oracle.com/cd/B19306_01/appdev.102/b14258/u_mail.htm#BABFJJBD) dans la documentation Oracle.
## Suppression de l'option UTL\$1MAIL d'Oracle
Vous pouvez supprimer l'option UTL\$1MAIL d'Oracle d'une instance de base de données.
Pour supprimer l'option UTL\$1MAIL d'une instance de base de données, effectuez une des actions suivantes :
+ Pour supprimer l'option UTL\$1MAIL de plusieurs instances de bases de données, supprimez l'option UTL\$1MAIL 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](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption).
+ Pour supprimer l'option UTL\$1MAIL 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\$1MAIL. 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](Overview.DBInstance.Modifying.md).
## Résolution des problèmes
Problèmes que vous pouvez rencontrer lorsque vous utilisez UTL\$1MAIL 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\$1MAIL et que l'erreur `ORA-29278: SMTP transient error: 421 Service not available` s'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](https://docs.aws.amazon.com/general/latest/gr/api-retries.html) et [Comment traiter une erreur « throttling – Maximum sending rate exceeded »](https://aws.amazon.com/blogs/ses/how-to-handle-a-throttling-maximum-sending-rate-exceeded-error/).
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 ?](https://aws.amazon.com/premiumsupport/knowledge-center/ec2-port-25-throttle/).