Oracle UTL_MAIL or UTL_SMTP and Amazon Simple Notification Service - Oracle to Aurora MySQL Migration Playbook
Oracle UTL_MAIL UsageOracle UTL_SMTP UsageMySQL Usage
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Oracle UTL_MAIL or UTL_SMTP and Amazon Simple Notification Service

Feature compatibility Amazon SCT / Amazon DMS automation level Amazon SCT action code index Key differences

Two star feature compatibility

No automation

N/A

Use Lambda integration.

Oracle UTL_MAIL Usage

The Oracle UTL_MAIL package provides functionality for sending email messages. Unlike UTL_SMTP, which is more complex and provided in earlier versions of Oracle, UTL_MAIL supports attachments. For most cases, UTL_MAIL is a better choice.

Examples

Install the required mail packages.

@{ORACLE_HOME}/rdbms/admin/utlmail.sql
@{ORACLE_HOME}/rdbms/admin/prvtmail.plb

Set the smtp_out_server parameter.

ALTER SYSTEM SET smtp_out_server = 'smtp.domain.com' SCOPE=BOTH;

Send an email message.

exec utl_mail.send('Sender@mailserver.com', 'recipient@mailserver.com', NULL, NULL, 'This is the subject', 'This is the message body', NULL, 3, NULL);

For more information, see UTL_MAIL in the Oracle documentation.

Oracle UTL_SMTP Usage

The Oracle UTL_SMTP package provides functionality for sending email messages and is useful for sending alerts about database events. Unlike UTL_MAIL, UTL SMTP is more complex and doesn’t support attachments. For most cases, UTL_MAIL is a better choice.

Examples

The following example demonstrates using UTL_SMTP procedures to send email messages.

Install the required scripts.

In oracle 12c:
@{ORACLE_HOME}/rdbms/admin/utlsmtp.sql

In oracle 11g:
@{ORACLE_HOME}/javavm/install/initjvm.sql
@{ORACLE_HOME}/rdbms/admin/initplsj.sql

Create and send an email message.

  • UTL_SMTP.OPEN_CONNECTION opens a connection to the smtp server.

  • UTL_SMTP.HELO initiates a handshake with the smtp server.

  • UTL_SMTP.MAIL Initiates a mail transaction that obtains the senders details.

  • UTL_SMTP.RCPT adds a recipient to the mail transaction.

  • UTL_SMTP.DATA adds the message content.

  • UTL_SMTP.QUIT terminates the SMTP transaction.

DECLARE
smtpconn utl_smtp.connection;
BEGIN
smtpconn := UTL_SMTP.OPEN_CONNECTION('smtp.mailserver.com', 25);
UTL_SMTP.HELO(smtpconn, 'smtp.mailserver.com');
UTL_SMTP.MAIL(smtpconn, 'sender@mailserver.com');
UTL_SMTP.RCPT(smtpconn, 'recipient@mailserver.com');
UTL_SMTP.DATA(smtpconn,'Message body');
UTL_SMTP.QUIT(smtpconn);
END;
/

For more information, see Managing Resources with Oracle Database Resource Manager in the Oracle documentation.

MySQL Usage

Aurora MySQL does not support direct configuration of engine alerts. Use the Event Notifications Infrastructure to collect history logs or receive event notifications in near real-time.

The Amazon Relational Database Service (Amazon RDS) uses the Amazon Simple Notification Service (Amazon SNS) to provide notifications for events. Amazon SNS can send notifications in any form supported by the region including email, text messages, or calls to HTTP endpoints for response automation.

Events are grouped into categories. You can only subscribe to event categories, not individual events. SNS sends notifications when any event in a category occurs.

You can subscribe to alerts for database instances, database clusters, database snapshots, database cluster snapshots, database security groups, and database parameter groups. For example, a subscription to the Backup category for a specific database instance sends notifications when backup-related events occur on that instance. A subscription to the Configuration Change category for a database security group sends notifications when the security group changes.

Note

For Amazon Aurora, some events occur at the cluster rather than instance level. You will not receive those events if you subscribe to an Aurora DB instance.

Amazon SNS sends event notifications to the address specified when the subscription was created. Typically, administrators create several subscriptions. For example, one subscription to receive logging events and another to receive only critical events for a production environment requiring immediate responses.

You can disable notifications without deleting a subscription by setting the Enabled radio button to No in the Amazon RDS console. Alternatively, use the Amazon Command Line Interface (CLI) or Amazon RDS API to change the Enabled setting.

Subscriptions are identified by the Amazon Resource Name (ARN) of an Amazon SNS topic. The Amazon RDS console creates ARNs when subscriptions are created. When using the CLI or API, you must create the ARN using the Amazon SNS console or the Amazon SNS API.

Examples

The following walkthrough demonstrates how to create an Event Notification Subscription:

  1. Sign in to your Amazon console and choose RDS.

  2. Choose Events. If you have not previously subscribed to events, the screen displays zero events.

  3. Choose Event subscriptions, and then choose Create event subscription.

  4. For Name, enter the name of the subscription.

  5. For Target, choose ARN or New email topic. For email subscriptions, enter values for Topic name and With these recipients.

  6. Choose the event source and then choose specific event categories to be monitored from the drop-down menu.

  7. Choose Create.

  8. On the Amazon RDS dashboard, choose Recent events.

For more information, see Working with Amazon RDS event notification in the Amazon Relational Database Service User Guide.

For application email requirements, consider using a dedicated email framework. If the code generating email messages must reside in the database, consider using a queue table. Replace all occurrences of UTL_SMTP and UTL_MAIL with an INSERT into the queue table. Design external applications to connect, read the queue, send an email message, and then update the status periodically. With this approach, messages can be populated with a query result similar to UTL_SMTP and UTL_MAIL with the query option.

The only way to send email from the database is to use Amazon Lambda integration. For more information about Amazon Lambda, see Amazon Lambda.

For an example of sending an email message from Aurora MySQL using Amazon Lambda integration, see Invoking a Lambda Function from an Amazon Aurora MySQL DB Cluster.