

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Oracle UTL\_MAIL
<a name="Oracle.Options.UTLMAIL"></a>

Amazon RDS mendukung Oracle UTL\_MAIL melalui penggunaan opsi UTL\_MAIL dan server SMTP. Anda dapat mengirim email langsung dari basis data Anda menggunakan paket UTL\_MAIL. Amazon RDS mendukung UTL\_MAIL untuk versi Oracle berikut ini: 
+ Oracle Database 21c (21.0.0.0), semua versi
+ Oracle Database 19c (19.0.0.0), semua versi

Berikut adalah beberapa batasan dalam menggunakan UTL\_MAIL: 
+ UTL\_MAIL tidak mendukung Keamanan Lapisan Pengangkutan (TLS) dan oleh karena itu email tidak dienkripsi. 

  Untuk terhubung dengan aman ke SSL/TLS sumber daya jarak jauh dengan membuat dan mengunggah dompet Oracle khusus, ikuti instruksi di. [Mengonfigurasi akses UTL\_HTTP menggunakan sertifikat dan dompet Oracle](Oracle.Concepts.ONA.md)

  Sertifikat khusus yang diperlukan untuk dompet Anda berbeda menurut layanan. Untuk AWS layanan, ini biasanya dapat ditemukan di [repositori layanan kepercayaan Amazon](https://www.amazontrust.com/repository/).
+ UTL\_MAIL tidak mendukung autentikasi dengan server SMTP. 
+ Anda hanya dapat mengirim satu lampiran dalam satu email. 
+ Anda tidak dapat mengirim lampiran yang lebih besar dari 32 K. 
+ Anda hanya dapat menggunakan pengodean karakter ASCII dan Extended Binary Coded Decimal Interchange Code (EBCDIC). 
+ Port SMTP (25) dibatasi berdasarkan kebijakan pemilik antarmuka jaringan elastis. 

Saat Anda mengaktifkan UTL\_MAIL, hanya pengguna master untuk instans DB Anda yang diberikan hak istimewa eksekusi. Jika perlu, pengguna master dapat memberikan hak eksekusi kepada pengguna lain sehingga mereka dapat menggunakan UTL\_MAIL. 

**penting**  
Kami menyarankan Anda mengaktifkan fitur audit default Oracle untuk melacak penggunaan prosedur UTL\_MAIL. 

## Prasyarat untuk Oracle UTL\_MAIL
<a name="Oracle.Options.UTLMAIL.PreReqs"></a>

Berikut adalah prasyarat untuk menggunakan Oracle UTL\_MAIL:
+ Satu server SMTP atau lebih, dan alamat IP yang sesuai atau nama Domain Name Server (DNS) publik atau privat. Untuk informasi lebih lanjut tentang nama DNS privat yang diselesaikan melalui server DNS kustom, lihat [Menyiapkan server DNS kustom](Appendix.Oracle.CommonDBATasks.System.md#Appendix.Oracle.CommonDBATasks.CustomDNS). 

## Menambahkan opsi Oracle UTL\_MAIL
<a name="Oracle.Options.UTLMAIL.Add"></a>

Proses umum untuk menambahkan opsi UTL\_MAIL ke instans DB adalah sebagai berikut: 

1. Buat grup opsi baru, atau salin atau ubah grup opsi yang ada.

1. Tambahkan opsi ke grup opsi.

1. Kaitkan grup opsi tersebut dengan instans DB.

Setelah Anda menambahkan opsi UTL\_MAIL, setelah grup opsi aktif, UTL\_MAIL langsung aktif. 

**Untuk menambahkan opsi UTL\_MAIL ke instans DB**

1. Tentukan grup opsi yang ingin Anda gunakan. Anda dapat membuat grup opsi baru atau menggunakan grup opsi yang ada. Jika Anda ingin menggunakan grup opsi yang ada, lanjutkan ke langkah berikutnya. Jika tidak, buat grup opsi DB kustom dengan pengaturan berikut: 

   1. Untuk **Mesin**, pilih edisi Oracle yang ingin Anda gunakan. 

   1. Untuk **Versi mesin utama**, pilih versi instans DB Anda. 

   Untuk informasi selengkapnya, lihat [Membuat grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 

1. Tambahkan opsi **UTL\_MAIL** ke grup opsi. Untuk informasi selengkapnya tentang cara menambahkan opsi, lihat [Menambahkan opsi ke grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). 

1. Terapkan grup opsi ke instans DB baru atau yang sudah ada: 
   + Untuk instans DB baru, Anda menerapkan grup opsi saat Anda meluncurkan instans. Untuk informasi selengkapnya, lihat [Membuat instans DB Amazon RDS](USER_CreateDBInstance.md). 
   + Untuk instans DB yang ada, Anda menerapkan grup opsi dengan memodifikasi instans dan melampirkan grup opsi baru. Untuk informasi selengkapnya, lihat [Memodifikasi instans DB Amazon RDS](Overview.DBInstance.Modifying.md). 

## Menggunakan Oracle UTL\_MAIL
<a name="Oracle.Options.UTLMAIL.Using"></a>

Setelah Anda mengaktifkan opsi UTL\_MAIL, Anda harus mengonfigurasi server SMTP sebelum Anda dapat mulai menggunakannya. 

Anda mengonfigurasi server SMTP dengan mengatur parameter SMTP\_OUT\_SERVER ke alamat IP atau nama DNS publik yang valid. Untuk parameter SMTP\_OUT\_SERVER, Anda dapat menentukan daftar alamat beberapa server yang dipisahkan koma. Jika server pertama tidak tersedia, UTL\_MAIL mencoba server berikutnya, dan seterusnya. 

Anda dapat mengatur SMTP\_OUT\_SERVER default untuk instans DB menggunakan [grup parameter DB](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_WorkingWithParamGroups.html). Anda dapat mengatur parameter SMTP\_OUT\_SERVER untuk sebuah sesi dengan menjalankan kode berikut di basis data Anda pada instans DB Anda. 

```
1. ALTER SESSION SET smtp_out_server = {{mailserver.domain.com:25}};
```

Setelah opsi UTL\_MAIL diaktifkan, dan SMTP\_OUT\_SERVER Anda dikonfigurasi, Anda dapat mengirim email menggunakan prosedur `SEND`. Untuk informasi lebih lanjut, lihat [UTL\_MAIL](http://docs.oracle.com/cd/B19306_01/appdev.102/b14258/u_mail.htm#BABFJJBD) dalam dokumentasi Oracle. 

## Menghapus opsi Oracle UTL\_MAIL
<a name="Oracle.Options.UTLMAIL.Remove"></a>

Anda dapat menghapus Oracle UTL\_MAIL dari instans DB. 

Untuk menghapus UTL\_MAIL dari instans DB, lakukan salah satu hal berikut: 
+ Untuk menghapus UTL\_MAIL dari beberapa instans DB, hapus opsi UTL\_MAIL dari grup opsi yang mencakupnya. Perubahan ini memengaruhi semua instans DB yang menggunakan grup opsi tersebut. Untuk informasi lebih lanjut, lihat [Menghapus opsi dari grup opsi](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). 
+ Untuk menghapus UTL\_MAIL dari satu instans DB, modifikasi instans DB dan tentukan grup opsi lain yang tidak menyertakan opsi UTL\_MAIL. Anda dapat menentukan grup opsi default (kosong) atau grup opsi kustom yang berbeda. Untuk informasi lebih lanjut, lihat [Memodifikasi instans DB Amazon RDS](Overview.DBInstance.Modifying.md). 

## Pemecahan masalah
<a name="Oracle.Options.UTLMAIL.Troubleshooting"></a>

Berikut ini adalah masalah yang mungkin Anda temui saat menggunakan UTL\_MAIL dengan Amazon RDS. 
+ Throttling. Port SMTP (25) dibatasi berdasarkan kebijakan pemilik antarmuka jaringan elastis. Jika Anda berhasil mengirim email menggunakan UTL\_MAIL dan melihat kesalahan `ORA-29278: SMTP transient error: 421 Service not available`, Anda mungkin sedang dibatasi. Jika Anda mengalami throttling dengan pengiriman email, sebaiknya Anda menerapkan algoritma backoff. Untuk informasi selengkapnya tentang algoritma backoff, lihat [Percobaan ulang kesalahan dan backoff eksponensial di AWS](https://docs.aws.amazon.com/general/latest/gr/api-retries.html) dan [Cara menangani kesalahan "throttling - Laju pengiriman maksimum terlampaui"](https://aws.amazon.com/blogs/ses/how-to-handle-a-throttling-maximum-sending-rate-exceeded-error/). 

  Anda dapat meminta agar throttle ini dihapus. Untuk informasi lebih lanjut, lihat [Bagaimana cara menghapus throttle pada port 25 dari instans EC2 saya?](https://aws.amazon.com/premiumsupport/knowledge-center/ec2-port-25-throttle/).