Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengekspor data snapshot DB ke Amazon S3 untuk Amazon RDS
Anda dapat mengekspor data snapshot DB ke bucket Amazon S3. Proses ekspor berjalan di latar belakang dan tidak memengaruhi kinerja database aktif Anda.
Saat Anda mengekspor snapshot DB, Amazon RDS mengekstrak data dari snapshot dan menyimpannya di bucket Amazon S3. Data disimpan dalam format Apache Parquet yang dikompresi dan konsisten.
Anda dapat mengekspor semua jenis snapshot DB—termasuk snapshot manual, snapshot sistem otomatis, dan snapshot yang dibuat oleh layanan. AWS Backup Secara default, semua data dalam snapshot akan diekspor. Namun, Anda dapat memilih untuk mengekspor set basis data, skema, atau tabel tertentu.
Setelah data diekspor, Anda dapat menganalisis data yang diekspor secara langsung melalui alat seperti Amazon Athena atau Amazon Redshift Spectrum. *Untuk informasi lebih lanjut tentang menggunakan Athena untuk membaca data Parket, lihat [Parket di Panduan Pengguna SerDe](https://docs.aws.amazon.com/athena/latest/ug/parquet-serde.html) Amazon Athena.* Untuk informasi selengkapnya tentang cara menggunakan Redshift Spectrum untuk membaca data Parquet, lihat [COPY dari format data berkolom](https://docs.aws.amazon.com/redshift/latest/dg/copy-usage_notes-copy-from-columnar.html) dalam *Panduan Developer Basis Data Amazon Redshift*.
**Awas**
Anda tidak dapat memulihkan data snapshot yang diekspor dari S3 ke instans DB baru atau mengimpor data snapshot dari S3 ke instans DB yang ada. Namun, Anda dapat memproses data menggunakan Amazon Athena atau Redshift Spectrum untuk analisis. Selain itu, Anda dapat menggunakan AWS Glue untuk mengubah data dan kemudian mengimpornya ke Amazon RDS menggunakan alat seperti AWS DMS atau skrip khusus.
Untuk informasi selengkapnya tentang mengekspor snapshot DB ke Amazon S3, lihat topik berikut.
**Topik**
+ [Memantau ekspor snapshot untuk Amazon RDS](USER_ExportSnapshot.Monitoring.md)
+ [Membatalkan tugas ekspor snapshot untuk Amazon RDS](USER_ExportSnapshot.Canceling.md)
+ [Pesan kegagalan untuk tugas ekspor Amazon S3 untuk Amazon RDS](USER_ExportSnapshot.failure-msg.md)
+ [Pemecahan masalah RDS untuk kesalahan izin PostgreSQL](USER_ExportSnapshot.postgres-permissions.md)
+ [Konvensi penamaan file untuk ekspor ke Amazon S3 untuk Amazon RDS](USER_ExportSnapshot.FileNames.md)
+ [Konversi data saat mengekspor ke bucket Amazon S3 untuk Amazon RDS](USER_ExportSnapshot.data-types.md)
## Ikhtisar pengeksporan data snapshot
Anda menggunakan proses berikut untuk mengekspor data snapshot DB ke bucket Amazon S3. Untuk detail selengkapnya, lihat bagian berikut.
1. Identifikasi snapshot yang akan diekspor.
Gunakan snapshot otomatis atau manual yang ada, atau buat snapshot manual dari instans DB atau cluster DB multi-AZ.
1. Siapkan akses ke bucket Amazon S3.
*Bucket* adalah kontainer untuk objek atau file Amazon S3. Untuk memberikan informasi agar dapat mengakses bucket, lakukan langkah-langkah berikut:
1. Identifikasi bucket S3 tempat snapshot akan diekspor. Bucket S3 harus berada di AWS Wilayah yang sama dengan snapshot. Untuk informasi selengkapnya, lihat [Mengidentifikasi bucket Amazon S3 untuk ekspor](#USER_ExportSnapshot.SetupBucket).
1. Buat peran AWS Identity and Access Management (IAM) yang memberikan akses tugas ekspor snapshot ke bucket S3. Untuk informasi selengkapnya, lihat [Memberikan akses ke bucket Amazon S3 menggunakan peran IAM](#USER_ExportSnapshot.SetupIAMRole).
1. Buat enkripsi simetris AWS KMS key untuk enkripsi sisi server. Kunci KMS digunakan oleh tugas ekspor snapshot untuk mengatur enkripsi AWS KMS sisi server saat menulis data ekspor ke S3.
Kebijakan kunci KMS harus menyertakan izin `kms:CreateGrant` dan `kms:DescribeKey`. Untuk informasi selengkapnya tentang menggunakan kunci KMS di Amazon RDS, lihat [AWS KMS key manajemen](Overview.Encryption.Keys.md).
Jika Anda memiliki pernyataan penolakan dalam kebijakan kunci KMS Anda, pastikan untuk secara eksplisit mengecualikan prinsip layanan. AWS `export.rds.amazonaws.com`
Anda dapat menggunakan kunci KMS dalam AWS akun Anda, atau Anda dapat menggunakan kunci KMS lintas akun. Untuk informasi selengkapnya, lihat [Menggunakan akun silang AWS KMS key untuk mengenkripsi ekspor Amazon S3](#USER_ExportSnapshot.CMK).
1. Ekspor snapshot ke Amazon S3 menggunakan konsol atau perintah CLI `start-export-task`. Untuk informasi selengkapnya, lihat [Mengekspor data snapshot DB ke bucket Amazon S3](#USER_ExportSnapshot.Exporting).
1. Untuk mengakses data Anda yang diekspor di bucket Amazon S3 lihat [Mengunggah, mengunduh, dan mengelola objek](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/upload-download-objects.html) dalam *Panduan Pengguna Amazon Simple Storage Service*.
## Menyiapkan akses ke bucket Amazon S3
Untuk mengekspor data snapshot DB ke file Amazon S3 Anda terlebih dahulu memberikan izin snapshot untuk mengakses bucket Amazon S3. Kemudian, Anda membuat peran IAM untuk memungkinkan layanan Amazon RDS menulis ke bucket Amazon S3.
**Topics**
+ [Mengidentifikasi bucket Amazon S3 untuk ekspor](#USER_ExportSnapshot.SetupBucket)
+ [Memberikan akses ke bucket Amazon S3 menggunakan peran IAM](#USER_ExportSnapshot.SetupIAMRole)
+ [Menggunakan bucket Amazon S3 lintas akun](#USER_ExportSnapshot.Setup.XAcctBucket)
+ [Menggunakan akun silang AWS KMS key untuk mengenkripsi ekspor Amazon S3](#USER_ExportSnapshot.CMK)
### Mengidentifikasi bucket Amazon S3 untuk ekspor
Identifikasi bucket Amazon S3 untuk mengekspor snapshot DB. Gunakan bucket S3 yang ada atau buat bucket S3 baru.
**catatan**
Bucket S3 yang akan diekspor harus berada di AWS Wilayah yang sama dengan snapshot.
Untuk informasi selengkapnya tentang cara bekerja dengan bucket Amazon S3, lihat informasi berikut dalam *Panduan Pengguna Amazon Simple Storage Service*:
+ [ Bagaimana cara melihat properti untuk bucket S3?](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/view-bucket-properties.html)
+ [ Bagaimana cara mengaktifkan enkripsi default untuk bucket Amazon S3?](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/default-bucket-encryption.html)
+ [ Bagaimana cara membuat bucket S3?](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/create-bucket.html)
### Memberikan akses ke bucket Amazon S3 menggunakan peran IAM
Sebelum Anda mengekspor data snapshot DB ke Amazon S3, beri tugas ekspor snapshot izin akses tulis ke bucket Amazon S3.
Untuk memberikan izin ini, buat kebijakan IAM yang memberikan akses ke bucket, lalu buat peran IAM dan lampirkan kebijakan ke peran tersebut. Kemudian, tetapkan peran IAM ke tugas ekspor snapshot Anda.
Untuk informasi tentang alat manajemen akses Amazon S3 lainnya, lihat [Kontrol akses di Amazon S3 di](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-management.html) Panduan Pengguna Amazon *S3*.
**penting**
Jika Anda berencana untuk menggunakan Konsol Manajemen AWS untuk mengekspor snapshot Anda, Anda dapat memilih untuk membuat kebijakan IAM dan peran secara otomatis ketika Anda mengekspor snapshot. Untuk petunjuk, lihat [Mengekspor data snapshot DB ke bucket Amazon S3](#USER_ExportSnapshot.Exporting).
**Untuk memberi tugas snapshot DB akses ke Amazon S3**
1. Buat kebijakan IAM. Kebijakan ini memberikan bucket dan izin objek yang memungkinkan tugas ekspor snapshot Anda mengakses Amazon S3.
Dalam kebijakan tersebut, sertakan tindakan yang diperlukan berikut untuk mengizinkan transfer file dari Amazon RDS ke bucket S3:
+ `s3:PutObject*`
+ `s3:GetObject*`
+ `s3:ListBucket`
+ `s3:DeleteObject*`
+ `s3:GetBucketLocation`
Dalam kebijakan tersebut, sertakan sumber daya berikut untuk mengidentifikasi bucket S3 dan objek dalam bucket. Daftar sumber daya berikut menunjukkan format Amazon Resource Name (ARN) untuk mengakses Amazon S3.
+ `arn:aws:s3:::amzn-s3-demo-bucket`
+ `arn:aws:s3:::amzn-s3-demo-bucket/*`
Untuk mengetahui informasi selengkapnya tentang cara membuat kebijakan IAM untuk Amazon RDS, lihat [Membuat dan menggunakan kebijakan IAM untuk akses basis data IAM](UsingWithRDS.IAMDBAuth.IAMPolicy.md). Lihat juga [Tutorial: Membuat dan melampirkan kebijakan yang dikelola pelanggan pertama Anda](https://docs.aws.amazon.com//IAM/latest/UserGuide/tutorial_managed-policies.html) di *Panduan Pengguna IAM*.
AWS CLI Perintah berikut membuat kebijakan IAM bernama `ExportPolicy` dengan opsi ini. Perintah ini akan memberikan akses ke bucket bernama *amzn-s3-demo-bucket*.
**catatan**
Setelah Anda membuat kebijakan, catat ARN kebijakan tersebut. Anda memerlukan ARN ini untuk langkah berikutnya ketika Anda melampirkan kebijakan ke peran IAM.
```
aws iam create-policy --policy-name ExportPolicy --policy-document '{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "ExportPolicy",
"Effect": "Allow",
"Action": [
"s3:PutObject*",
"s3:ListBucket",
"s3:GetObject*",
"s3:DeleteObject*",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}'
```
1. Buat peran IAM, sehingga Amazon RDS dapat mengambil peran IAM ini atas nama Anda untuk mengakses bucket Amazon S3. Lihat mengetahui informasi yang lebih lengkap di [Membuat peran untuk melimpahkan izin ke pengguna IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_roles_create_for-user.html) dalam *Panduan Pengguna IAM*.
Contoh berikut menunjukkan menggunakan AWS CLI perintah untuk membuat peran bernama`rds-s3-export-role`.
```
aws iam create-role --role-name rds-s3-export-role --assume-role-policy-document '{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "export.rds.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}'
```
1. Lampirkan kebijakan IAM yang Anda buat pada peran IAM yang Anda buat.
AWS CLI Perintah berikut melampirkan kebijakan yang dibuat sebelumnya ke peran bernama`rds-s3-export-role`. Ganti `your-policy-arn` dengan ARN kebijakan yang Anda catat di langkah sebelumnya.
```
aws iam attach-role-policy --policy-arn your-policy-arn --role-name rds-s3-export-role
```
### Menggunakan bucket Amazon S3 lintas akun
Anda dapat menggunakan bucket Amazon S3 di seluruh akun. AWS Untuk menggunakan bucket lintas akun, tambahkan kebijakan bucket untuk mengizinkan akses ke peran IAM yang Anda gunakan untuk ekspor S3. Untuk informasi selengkapnya, lihat [Contoh 2: Pemilik bucket yang memberikan izin bucket lintas akun](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-walkthroughs-managing-access-example2.html).
Lampirkan kebijakan bucket pada bucket Anda, seperti yang ditunjukkan dalam contoh berikut.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::123456789012:role/Admin"
},
"Action": [
"s3:PutObject*",
"s3:ListBucket",
"s3:GetObject*",
"s3:DeleteObject*",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-destination-bucket",
"arn:aws:s3:::amzn-s3-demo-destination-bucket/*"
]
}
]
}
```
------
### Menggunakan akun silang AWS KMS key untuk mengenkripsi ekspor Amazon S3
Anda dapat menggunakan akun silang AWS KMS key untuk mengenkripsi ekspor Amazon S3. Pertama-tama, tambahkan kebijakan kunci ke akun lokal, lalu tambahkan kebijakan IAM di akun eksternal. Untuk informasi selengkapnya, lihat [Mengizinkan pengguna di akun lain untuk menggunakan kunci KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying-external-accounts.html).
**Untuk menggunakan kunci KMS lintas akun**
1. Tambahkan kebijakan kunci ke akun lokal.
Contoh berikut memberi `ExampleRole` dan `ExampleUser` di akun eksternal 444455556666 izin di akun lokal 123456789012.
```
{
"Sid": "Allow an external account to use this KMS key",
"Effect": "Allow",
"Principal": {
"AWS": [
"arn:aws:iam::444455556666:role/ExampleRole",
"arn:aws:iam::444455556666:user/ExampleUser"
]
},
"Action": [
"kms:Encrypt",
"kms:Decrypt",
"kms:ReEncrypt*",
"kms:GenerateDataKey*",
"kms:CreateGrant",
"kms:DescribeKey",
"kms:RetireGrant"
],
"Resource": "*"
}
```
1. Tambahkan kebijakan IAM ke akun eksternal tersebut.
Contoh kebijakan IAM berikut memungkinkan pengguna utama menggunakan kunci KMS di akun 123456789012 untuk operasi kriptografi. Untuk memberikan izin ini ke `ExampleRole` dan `ExampleUser` di akun 444455556666, [lampirkan kebijakan](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_managed-using.html#attach-managed-policy-console) di akun tersebut.
```
{
"Sid": "Allow use of KMS key in account 123456789012",
"Effect": "Allow",
"Action": [
"kms:Encrypt",
"kms:Decrypt",
"kms:ReEncrypt*",
"kms:GenerateDataKey*",
"kms:CreateGrant",
"kms:DescribeKey",
"kms:RetireGrant"
],
"Resource": "arn:aws:kms:us-west-2:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab"
}
```
## Mengekspor data snapshot DB ke bucket Amazon S3
Anda dapat memiliki hingga lima tugas ekspor snapshot DB bersamaan yang sedang berlangsung per. Akun AWS
**catatan**
Mengekspor snapshot RDS dapat memerlukan banyak waktu, tergantung pada jenis dan ukuran basis data Anda. Tugas ekspor akan terlebih dahulu memulihkan dan menskalakan seluruh basis data sebelum mengekstrak data ke Amazon S3. Dalam fase ini, progres tugas tersebut akan ditampilkan sebagai **Memulai**. Saat tugas beralih menjadi mengekspor data ke S3, progres akan ditampilkan sebagai **Sedang berlangsung**.
Waktu yang diperlukan untuk menyelesaikan ekspor tergantung pada data yang disimpan di basis data. Misalnya, tabel yang berisi kolom indeks atau kunci primer numerik yang terdistribusi dengan baik akan diekspor paling cepat. Tabel yang tidak berisi kolom yang sesuai untuk partisi dan tabel yang hanya berisi satu indeks pada kolom berbasis string memerlukan waktu lebih lama. Waktu ekspor yang lebih lama ini terjadi karena ekspor menggunakan proses alur tunggal yang lebih lambat.
Anda dapat mengekspor snapshot DB ke Amazon S3 menggunakan, Konsol Manajemen AWS API, AWS CLI atau RDS. Untuk mengekspor snapshot DB ke bucket Amazon S3 lintas akun, gunakan atau RDS AWS CLI API.
Jika Anda menggunakan fungsi Lambda untuk mengekspor snapshot, tambahkan tindakan `kms:DescribeKey` ke kebijakan fungsi Lambda. Untuk informasi selengkapnya, lihat [izin AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-permissions.html).
### Konsol
Opsi konsol **Ekspor ke Amazon S3** hanya muncul untuk snapshot yang dapat diekspor ke Amazon S3. Snapshot mungkin tidak tersedia untuk diekspor karena alasan berikut:
+ Mesin DB tidak didukung untuk ekspor S3.
+ Versi mesin DB tidak didukung untuk ekspor S3.
+ Ekspor S3 tidak didukung di AWS Wilayah tempat snapshot dibuat.
**Untuk mengekspor snapshot DB**
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon RDS di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Di panel navigasi, pilih **Snapshot**.
1. Dari tabnya, pilih jenis snapshot yang ingin Anda ekspor.
1. Dalam daftar snapshot, pilih snapshot yang ingin Anda ekspor.
1. Untuk **Tindakan**, pilih **Ekspor ke Amazon S3**.
Jendela **Ekspor ke Amazon S3** akan muncul.
1. Untuk **Pengidentifikasi ekspor**, masukkan nama untuk mengidentifikasi tugas ekspor. Nilai ini juga akan digunakan untuk nama file yang dibuat di bucket S3.
1. Pilih data yang akan diekspor:
+ Pilih **Semua** untuk mengekspor semua data dalam snapshot.
+ Pilih **Sebagian** untuk mengekspor bagian tertentu dari snapshot. Untuk mengidentifikasi bagian snapshot yang akan diekspor, masukkan satu atau beberapa basis data, skema, atau tabel untuk **Pengidentifikasi**, dipisahkan dengan spasi.
Gunakan format berikut:
```
database[.schema][.table] database2[.schema2][.table2] ... databasen[.scheman][.tablen]
```
Contohnya:
```
mydatabase mydatabase2.myschema1 mydatabase2.myschema2.mytable1 mydatabase2.myschema2.mytable2
```
1. Untuk **Bucket S3**, pilih bucket yang akan dijadikan tujuan ekspor.
Untuk menetapkan data yang diekspor ke jalur folder dalam bucket S3, masukkan jalur opsional untuk **Prefiks S3**.
1. Untuk **Peran IAM**, pilih peran yang memberi Anda akses tulis ke bucket S3 yang Anda pilih, atau buat peran baru.
+ Jika Anda membuat peran dengan mengikuti langkah-langkah di [Memberikan akses ke bucket Amazon S3 menggunakan peran IAM](#USER_ExportSnapshot.SetupIAMRole), pilih peran tersebut.
+ Jika Anda tidak membuat peran yang memberi Anda akses tulis ke bucket S3 yang Anda pilih, pilih **Buat peran baru** untuk membuat peran secara otomatis. Berikutnya, masukkan nama untuk peran tersebut di **Nama peran IAM**.
1. Untuk **AWS KMS key**, masukkan ARN untuk kunci yang akan digunakan untuk mengenkripsi data yang diekspor.
1. Pilih **Ekspor ke Amazon S3**.
### AWS CLI
Untuk mengekspor snapshot DB ke Amazon S3 menggunakan AWS CLI, gunakan perintah dengan [start-export-task](https://docs.aws.amazon.com/cli/latest/reference/rds/start-export-task.html)opsi yang diperlukan berikut:
+ `--export-task-identifier`
+ `--source-arn`
+ `--s3-bucket-name`
+ `--iam-role-arn`
+ `--kms-key-id`
Dalam contoh berikut, tugas ekspor snapshot diberi nama*my-snapshot-export*, yang mengekspor snapshot ke bucket S3 bernama. *amzn-s3-demo-bucket*
**Example**
Untuk Linux, macOS, atau Unix:
```
1. aws rds start-export-task \
2. --export-task-identifier my-snapshot-export \
3. --source-arn arn:aws:rds:AWS_Region:123456789012:snapshot:snapshot-name \
4. --s3-bucket-name amzn-s3-demo-bucket \
5. --iam-role-arn iam-role \
6. --kms-key-id my-key
```
Untuk Windows:
```
1. aws rds start-export-task ^
2. --export-task-identifier my-snapshot-export ^
3. --source-arn arn:aws:rds:AWS_Region:123456789012:snapshot:snapshot-name ^
4. --s3-bucket-name amzn-s3-demo-bucket ^
5. --iam-role-arn iam-role ^
6. --kms-key-id my-key
```
Berikut adalah contoh output.
```
{
"Status": "STARTING",
"IamRoleArn": "iam-role",
"ExportTime": "2019-08-12T01:23:53.109Z",
"S3Bucket": "my-export-bucket",
"PercentProgress": 0,
"KmsKeyId": "my-key",
"ExportTaskIdentifier": "my-snapshot-export",
"TotalExtractedDataInGB": 0,
"TaskStartTime": "2019-11-13T19:46:00.173Z",
"SourceArn": "arn:aws:rds:AWS_Region:123456789012:snapshot:snapshot-name"
}
```
Untuk menyediakan jalur folder di bucket S3 untuk ekspor snapshot, sertakan `--s3-prefix` opsi dalam perintah. [start-export-task](https://docs.aws.amazon.com/cli/latest/reference/rds/start-export-task.html)
### API RDS
Untuk mengekspor snapshot DB ke Amazon S3 menggunakan API Amazon RDS, gunakan operasi [StartExportTask](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_StartExportTask.html) dengan parameter yang diperlukan berikut ini:
+ `ExportTaskIdentifier`
+ `SourceArn`
+ `S3BucketName`
+ `IamRoleArn`
+ `KmsKeyId`
## Ketersediaan wilayah dan versi
Ketersediaan dan dukungan fitur bervariasi di seluruh versi spesifik dari setiap mesin basis data dan di seluruh Wilayah AWS. Untuk mengetahui informasi selengkapnya tentang versi dan ketersediaan Wilayah pengeksporan snapshot ke S3, lihat [Daerah yang Didukung dan engine DB untuk mengekspor snapshot ke S3 di Amazon RDS](Concepts.RDS_Fea_Regions_DB-eng.Feature.ExportSnapshotToS3.md).
## Batasan
Mengekspor data snapshot DB ke Amazon S3 memiliki batasan sebagai berikut:
+ Anda tidak dapat menjalankan beberapa tugas ekspor untuk snapshot DB yang sama secara bersamaan. Ini berlaku untuk ekspor penuh dan sebagian.
+ Mengekspor snapshot dari database yang menggunakan penyimpanan magnetik tidak didukung.
+ Ekspor ke S3 tidak mendukung awalan S3 yang berisi titik dua (:).
+ Karakter berikut di jalur file S3 akan diubah menjadi garis bawah (\$1) selama ekspor berlangsung:
```
\ ` " (space)
```
+ Jika basis data, skema, atau tabel memiliki karakter dalam namanya selain yang berikut ini, maka ekspor parsial tidak didukung. Namun, Anda dapat mengekspor seluruh snapshot DB.
+ Huruf latin (A-Z)
+ Digit (0–9)
+ Simbol dolar (\$1)
+ Garis bawah (\$1)
+ Spasi ( ) dan karakter-karakter tertentu tidak didukung dalam nama kolom tabel basis data. Tabel yang nama kolomnya berisi karakter berikut akan dilewati selama ekspor berlangsung:
```
, ; { } ( ) \n \t = (space)
```
+ Tabel dengan garis miring (/) di namanya dilewati selama ekspor.
+ Tabel sementara dan yang tidak tercatat RDS for PostgreSQL dilewati selama ekspor.
+ Jika data berisi objek besar, seperti BLOB atau CLOB, yang mendekati atau lebih dari 500 MB, ekspor tersebut gagal.
+ Jika suatu tabel berisi baris besar yang berukuran mendekati atau lebih dari 2 GB, maka tabel tersebut akan dilewati selama ekspor berlangsung.
+ Untuk ekspor sebagian, `ExportOnly` daftar memiliki ukuran maksimum 200 KB.
+ Sebaiknya Anda menggunakan nama unik untuk setiap tugas ekspor. Jika tidak menggunakan nama tugas yang unik, Anda mungkin menerima pesan kesalahan berikut:
ExportTaskAlreadyExistsFault: Terjadi kesalahan (ExportTaskAlreadyExists) saat memanggil StartExportTask operasi: Tugas ekspor dengan ID *xxxxx* sudah ada.
+ Anda dapat menghapus snapshot saat sedang mengekspor datanya ke S3, tetapi Anda masih dikenai biaya penyimpanan untuk snapshot tersebut hingga tugas ekspor selesai.
+ Anda tidak dapat memulihkan data snapshot yang diekspor dari S3 ke instans DB baru atau mengimpor data snapshot dari S3 ke instans DB yang ada.
+ Anda dapat memiliki hingga lima tugas ekspor snapshot DB bersamaan yang sedang berlangsung per. Akun AWS
+ Untuk mengekspor snapshot DB ke bucket Amazon S3 lintas akun, Anda harus menggunakan atau RDS AWS CLI API.
+ Setelah Amazon RDS menyelesaikan tugas ekspor, Anda mungkin harus menunggu beberapa saat untuk memulai tugas ekspor lain dari snapshot DB yang sama.
+ Anda tidak dapat mengekspor tampilan atau tampilan terwujud.
+ Ekspor RDS ke S3 tidak mendukung kontrol akses berbasis tag untuk. GuardDuty Malware Protection for S3
# Memantau ekspor snapshot untuk Amazon RDS
Anda dapat memantau ekspor snapshot DB menggunakan Konsol Manajemen AWS, AWS CLI, atau file. RDS API
## Konsol
**Untuk memantau ekspor snapshot DB**
1. Masuk ke Konsol Manajemen AWS dan buka RDS konsol Amazon di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Di panel navigasi, pilih **Snapshot**.
1. Untuk melihat daftar ekspor snapshot, pilih tab **Ekspor di Amazon S3**.
1. Untuk melihat informasi tentang ekspor snapshot khusus, pilih tugas ekspor.
## AWS CLI
Untuk memantau ekspor snapshot DB menggunakan AWS CLI, gunakan perintah. [describe-export-tasks](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-export-tasks.html)
Contoh berikut menunjukkan cara menampilkan informasi saat ini tentang semua ekspor snapshot Anda.
**Example**
```
1. aws rds describe-export-tasks
2.
3. {
4. "ExportTasks": [
5. {
6. "Status": "CANCELED",
7. "TaskEndTime": "2019-11-01T17:36:46.961Z",
8. "S3Prefix": "something",
9. "ExportTime": "2019-10-24T20:23:48.364Z",
10. "S3Bucket": "amzn-s3-demo-bucket",
11. "PercentProgress": 0,
12. "KmsKeyId": "arn:aws:kms:AWS_Region:123456789012:key/K7MDENG/bPxRfiCYEXAMPLEKEY",
13. "ExportTaskIdentifier": "anewtest",
14. "IamRoleArn": "arn:aws:iam::123456789012:role/export-to-s3",
15. "TotalExtractedDataInGB": 0,
16. "TaskStartTime": "2019-10-25T19:10:58.885Z",
17. "SourceArn": "arn:aws:rds:AWS_Region:123456789012:snapshot:parameter-groups-test"
18. },
19. {
20. "Status": "COMPLETE",
21. "TaskEndTime": "2019-10-31T21:37:28.312Z",
22. "WarningMessage": "{\"skippedTables\":[],\"skippedObjectives\":[],\"general\":[{\"reason\":\"FAILED_TO_EXTRACT_TABLES_LIST_FOR_DATABASE\"}]}",
23. "S3Prefix": "",
24. "ExportTime": "2019-10-31T06:44:53.452Z",
25. "S3Bucket": "amzn-s3-demo-bucket1",
26. "PercentProgress": 100,
27. "KmsKeyId": "arn:aws:kms:AWS_Region:123456789012:key/2Zp9Utk/h3yCo8nvbEXAMPLEKEY",
28. "ExportTaskIdentifier": "thursday-events-test",
29. "IamRoleArn": "arn:aws:iam::123456789012:role/export-to-s3",
30. "TotalExtractedDataInGB": 263,
31. "TaskStartTime": "2019-10-31T20:58:06.998Z",
32. "SourceArn": "arn:aws:rds:AWS_Region:123456789012:snapshot:rds:example-1-2019-10-31-06-44"
33. },
34. {
35. "Status": "FAILED",
36. "TaskEndTime": "2019-10-31T02:12:36.409Z",
37. "FailureCause": "The S3 bucket edgcuc-export isn't located in the current AWS Region. Please, review your S3 bucket name and retry the export.",
38. "S3Prefix": "",
39. "ExportTime": "2019-10-30T06:45:04.526Z",
40. "S3Bucket": "amzn-s3-demo-bucket2",
41. "PercentProgress": 0,
42. "KmsKeyId": "arn:aws:kms:AWS_Region:123456789012:key/2Zp9Utk/h3yCo8nvbEXAMPLEKEY",
43. "ExportTaskIdentifier": "wednesday-afternoon-test",
44. "IamRoleArn": "arn:aws:iam::123456789012:role/export-to-s3",
45. "TotalExtractedDataInGB": 0,
46. "TaskStartTime": "2019-10-30T22:43:40.034Z",
47. "SourceArn": "arn:aws:rds:AWS_Region:123456789012:snapshot:rds:example-1-2019-10-30-06-45"
48. }
49. ]
50. }
```
Untuk menampilkan informasi tentang ekspor snapshot tertentu, sertakan opsi `--export-task-identifier` dengan perintah `describe-export-tasks`. Sertakan opsi `--Filters` untuk memfilter output. Untuk opsi lainnya, lihat [describe-export-tasks](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-export-tasks.html)perintah.
## RDS API
Untuk menampilkan informasi tentang ekspor snapshot DB menggunakan Amazon RDSAPI, gunakan operasi. [DescribeExportTasks](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeExportTasks.html)
Untuk melacak penyelesaian alur kerja ekspor atau memulai alur kerja lainnya, Anda dapat berlangganan topik Amazon Simple Notification Service. Untuk informasi lebih lanjut tentang AmazonSNS, lihat[Bekerja dengan pemberitahuan RDS acara Amazon](USER_Events.md).
# Membatalkan tugas ekspor snapshot untuk Amazon RDS
Anda dapat membatalkan tugas ekspor snapshot DB menggunakan Konsol Manajemen AWS, file AWS CLI, atau file. RDS API
**catatan**
Membatalkan tugas ekspor snapshot tidak akan menghapus data apa pun yang telah diekspor ke Amazon S3. Untuk informasi tentang cara menghapus data menggunakan konsol, lihat [Bagaimana cara menghapus objek dari bucket S3?](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/delete-objects.html) Untuk menghapus data menggunakanCLI, gunakan perintah [delete-object](https://docs.aws.amazon.com/cli/latest/reference/s3api/delete-object.html).
## Konsol
**Untuk membatalkan tugas ekspor snapshot**
1. Masuk ke Konsol Manajemen AWS dan buka RDS konsol Amazon di [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Di panel navigasi, pilih **Snapshot**.
1. Pilih tab **Ekspor di Amazon S3**.
1. Pilih tugas ekspor snapshot yang ingin Anda batalkan.
1. Pilih **Batalkan**.
1. Pilih **Batalkan tugas ekspor** di halaman konfirmasi.
## AWS CLI
Untuk membatalkan tugas ekspor snapshot menggunakan AWS CLI, gunakan [cancel-export-task](https://docs.aws.amazon.com/cli/latest/reference/rds/cancel-export-task.html)perintah. Perintah tersebut memerlukan opsi `--export-task-identifier`.
**Example**
```
1. aws rds cancel-export-task --export-task-identifier my_export
2. {
3. "Status": "CANCELING",
4. "S3Prefix": "",
5. "ExportTime": "2019-08-12T01:23:53.109Z",
6. "S3Bucket": "amzn-s3-demo-bucket",
7. "PercentProgress": 0,
8. "KmsKeyId": "arn:aws:kms:AWS_Region:123456789012:key/K7MDENG/bPxRfiCYEXAMPLEKEY",
9. "ExportTaskIdentifier": "my_export",
10. "IamRoleArn": "arn:aws:iam::123456789012:role/export-to-s3",
11. "TotalExtractedDataInGB": 0,
12. "TaskStartTime": "2019-11-13T19:46:00.173Z",
13. "SourceArn": "arn:aws:rds:AWS_Region:123456789012:snapshot:export-example-1"
14. }
```
## RDS API
Untuk membatalkan tugas ekspor snapshot menggunakan Amazon RDSAPI, gunakan [CancelExportTask](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CancelExportTask.html)operasi dengan `ExportTaskIdentifier` parameter.
# Pesan kegagalan untuk tugas ekspor Amazon S3 untuk Amazon RDS
Tabel berikut menjelaskan pesan yang akan ditampilkan jika tugas ekspor Amazon S3 gagal.
| Pesan kegagalan | Deskripsi |
| --- | --- |
| Terjadi kesalahan internal yang tidak diketahui. | Tugas telah gagal karena kesalahan yang tidak diketahui, pengecualian, atau kegagalan. |
| Terjadi kesalahan internal yang tidak diketahui saat menulis metadata tugas ekspor ke bucket S3 [nama bucket]. | Tugas telah gagal karena kesalahan yang tidak diketahui, pengecualian, atau kegagalan. |
| RDSEkspor gagal menulis metadata tugas ekspor karena tidak dapat mengambil IAM peran [peranARN]. | Tugas ekspor mengasumsikan IAM peran Anda untuk memvalidasi apakah diperbolehkan menulis metadata ke bucket S3 Anda. Jika tugas tidak dapat mengambil IAM peran Anda, itu gagal. |
| RDSEkspor gagal menulis metadata tugas ekspor ke bucket S3 [nama bucket] menggunakan IAM role [roleARN] dengan KMS kunci [key ID]. Kode kesalahan: [kode kesalahan] | Satu atau beberapa izin tidak ada, sehingga tugas ekspor tidak dapat mengakses bucket S3. Pesan kegagalan ini muncul saat menerima salah satu kode kesalahan berikut: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.failure-msg.html) Kode kesalahan ini menunjukkan pengaturan salah dikonfigurasi untuk IAM peran, bucket S3, atau KMS kunci. |
| IAMRole [roleARN] tidak diizinkan untuk memanggil [S3 action] pada bucket S3 [nama bucket]. Tinjau izin Anda dan coba lagi ekspor. | IAMKebijakan ini salah dikonfigurasi. Izin untuk tindakan S3 tertentu pada bucket S3 tidak ada, sehingga menyebabkan tugas ekspor gagal. |
| KMSpemeriksaan kunci gagal. Periksa kredensil pada KMS kunci Anda dan coba lagi. | Pemeriksaan KMS kredensi kunci gagal. |
| Pemeriksaan kredensial S3 gagal. Periksa izin pada bucket dan IAM kebijakan S3 Anda. | Pemeriksaan kredensial S3 gagal. |
| Bucket S3 [nama bucket] tidak valid. Baik tidak terletak di Wilayah AWS saat ini maupun tidak ada. Tinjau nama bucket S3 Anda dan coba lagi ekspor. | Bucket S3 tidak valid. |
| Bucket S3 [nama bucket] tidak terletak di AWS Wilayah saat ini. Tinjau nama bucket S3 Anda, lalu coba lagi ekspor. | Bucket S3 berada di AWS Wilayah yang salah. |
# Pemecahan masalah RDS untuk kesalahan izin PostgreSQL
Saat mengekspor basis data PostgreSQL ke Amazon S3, Anda mungkin melihat kesalahan `PERMISSIONS_DO_NOT_EXIST` yang menyatakan bahwa tabel tertentu dilewati. Kesalahan ini biasanya terjadi ketika superuser, yang Anda tentukan saat membuat database, tidak memiliki izin untuk mengakses tabel tersebut.
Untuk memperbaiki kesalahan ini, jalankan perintah berikut:
```
GRANT ALL PRIVILEGES ON ALL TABLES IN SCHEMA schema_name TO superuser_name
```
Untuk informasi selengkapnya tentang hak pengguna super, lihat [Hak akses akun pengguna master](UsingWithRDS.MasterAccounts.md).
# Konvensi penamaan file untuk ekspor ke Amazon S3 untuk Amazon RDS
Data yang diekspor untuk tabel tertentu disimpan dalam format `base_prefix/files`, dengan prefiks dasar sebagai berikut:
```
export_identifier/database_name/schema_name.table_name/
```
Contohnya:
```
export-1234567890123-459/rdststdb/rdststdb.DataInsert_7ADB5D19965123A2/
```
Ada dua konvensi cara penamaan file.
+ Konvensi saat ini:
```
batch_index/part-partition_index-random_uuid.format-based_extension
```
Indeks batch adalah nomor urut yang mewakili batch data yang dibaca dari tabel. Jika kami tidak dapat mempartisi tabel Anda menjadi bagian-bagian kecil untuk diekspor secara paralel, akan ada beberapa indeks batch. Hal yang sama akan terjadi jika tabel Anda dipartisi menjadi beberapa tabel. Beberapa indeks batch akan tersedia, dengan satu untuk setiap partisi tabel dari tabel utama Anda.
Jika kami dapat mempartisi tabel Anda menjadi bagian-bagian kecil yang akan dibaca secara paralel, hanya akan ada folder `1` indeks batch.
Di dalam folder indeks batch, akan ada satu atau beberapa file Parquet yang berisi data tabel Anda. Prefiks file Parket adalah `part-partition_index`. Jika tabel Anda dipartisi, akan ada beberapa file yang diawali dengan indeks partisi `00000`.
Mungkin ada kesenjangan dalam urutan indeks partisi. Hal ini terjadi karena setiap partisi diperoleh dari kueri dengan rentang di tabel Anda. Jika tidak ada data dalam rentang partisi tersebut, maka nomor urut itu akan dilewati.
Misalnya, anggap kolom `id` adalah kunci primer tabel, dan nilai minimum dan maksimumnya adalah `100` dan `1000`. Saat kami mencoba mengekspor tabel ini dengan sembilan partisi, kami membacanya dengan kueri paralel seperti berikut:
```
SELECT * FROM table WHERE id <= 100 AND id < 200
SELECT * FROM table WHERE id <= 200 AND id < 300
```
Partisi ini akan menghasilkan sembilan file, dari `part-00000-random_uuid.gz.parquet` hingga `part-00008-random_uuid.gz.parquet`. Namun, jika tidak ada baris dengan IDs antara `200` dan`350`, salah satu partisi selesai kosong, dan tidak ada file yang dibuat untuk itu. Dalam contoh sebelumnya, `part-00001-random_uuid.gz.parquet` tidak dibuat.
+ Konvensi yang lebih lama:
```
part-partition_index-random_uuid.format-based_extension
```
Konvensi ini sama seperti konvensi saat ini, tetapi tanpa prefiks `batch_index`, contohnya:
```
part-00000-c5a881bb-58ff-4ee6-1111-b41ecff340a3-c000.gz.parquet
part-00001-d7a881cc-88cc-5ab7-2222-c41ecab340a4-c000.gz.parquet
part-00002-f5a991ab-59aa-7fa6-3333-d41eccd340a7-c000.gz.parquet
```
Konvensi penamaan file dapat berubah sewaktu-waktu. Oleh karena itu, saat membaca tabel target, sebaiknya baca segala sesuatu di dalam prefiks dasar untuk tabel tersebut.
# Konversi data saat mengekspor ke bucket Amazon S3 untuk Amazon RDS
Saat Anda mengekspor snapshot DB ke bucket Amazon S3, Amazon RDS mengonversi data ke, mengekspor data dalam, dan menyimpan data dalam format Parquet. Untuk mengetahui informasi selengkapnya tentang Parquet, lihat situs web [Parquet Apache](https://parquet.apache.org/docs/).
Parquet menyimpan semua data sebagai salah satu jenis primitif berikut:
+ BOOLEAN
+ INT32
+ INT64
+ INT96
+ FLOAT
+ DOUBLE
+ BYTE\$1ARRAY – Array byte dengan panjang variabel, juga dikenal sebagai biner
+ FIXED\$1LEN\$1BYTE\$1ARRAY – Array byte dengan panjang tetap yang digunakan saat nilai memiliki ukuran konstan
Jenis data Parquet berjumlah sedikit untuk mengurangi kerumitan membaca dan menulis format. Parquet menyediakan jenis logis untuk memperluas jenis primitif. *Jenis logis* diimplementasikan sebagai anotasi dengan data di kolom metadata `LogicalType`. Anotasi jenis logis menjelaskan cara menginterpretasikan jenis primitif.
Saat jenis logis `STRING` yang menandai jenis `BYTE_ARRAY`, menunjukkan bahwa rangkaian byte harus diinterpretasikan sebagai string karakter yang dienkode UTF-8. Setelah tugas ekspor selesai, Amazon RDS memberi tahu Anda jika terjadi konversi string. Data ekspor yang mendasarinya selalu sama dengan data dari sumber. Namun, karena perbedaan encoding dalam UTF-8, beberapa karakter mungkin terlihat berbeda dari sumber saat dibaca di alat seperti Athena.
Untuk mengetahui informasi selengkapnya, lihat [Parquet logical type definitions](https://github.com/apache/parquet-format/blob/master/LogicalTypes.md) dalam dokumentasi Parquet.
**Topics**
+ [Pemetaan jenis data MySQL dan MariaDB ke Parquet](#USER_ExportSnapshot.data-types.MySQL)
+ [Pemetaan jenis data PostgreSQL ke Parquet](#USER_ExportSnapshot.data-types.PostgreSQL)
## Pemetaan jenis data MySQL dan MariaDB ke Parquet
Tabel berikut menunjukkan pemetaan dari jenis data MySQL dan MariaDB ke jenis data Parquet saat data dikonversi dan diekspor ke Amazon S3.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/AmazonRDS/latest/UserGuide/USER_ExportSnapshot.data-types.html)
## Pemetaan jenis data PostgreSQL ke Parquet
Tabel berikut menunjukkan pemetaan dari dan jenis data PostgreSQL ke jenis data Parquet saat data dikonversi dan diekspor ke Amazon S3.
| Jenis data PostgreSQL | Jenis primitif Parquet | Anotasi jenis logis | Catatan pemetaan |
| --- | --- | --- | --- |
| Jenis data numerik |
| BIGINT | INT64 | | |
| BIGSERIAL | INT64 | | |
| DECIMAL | BYTE\$1ARRAY | STRING | Tipe DECIMAL dikonversi ke string dalam tipe BYTE\$1ARRAY dan dikodekan sebagai. UTF8Konversi ini dimaksudkan untuk menghindari kerumitan akibat presisi data dan nilai data yang bukan berupa angka (NaN). |
| DOUBLE PRECISION | DOUBLE | | |
| INTEGER | INT32 | | |
| MONEY | BYTE\$1ARRAY | STRING | |
| REAL | FLOAT | | |
| SERIAL | INT32 | | |
| SMALLINT | INT32 | INT (16, benar) | |
| SMALLSERIAL | INT32 | INT (16, benar) | |
| Jenis data string dan terkait |
| ARRAY | BYTE\$1ARRAY | STRING | Array dikonversi ke string dan dikodekan sebagai BINARY ()UTF8. Konversi ini dimaksudkan untuk menghindari kerumitan akibat presisi data, nilai data yang bukan berupa angka (NaN), dan nilai data waktu. |
| BIT | BYTE\$1ARRAY | STRING | |
| BIT VARYING | BYTE\$1ARRAY | STRING | |
| BYTEA | BINARY | | |
| CHAR | BYTE\$1ARRAY | STRING | |
| CHAR(N) | BYTE\$1ARRAY | STRING | |
| ENUM | BYTE\$1ARRAY | STRING | |
| NAME | BYTE\$1ARRAY | STRING | |
| TEXT | BYTE\$1ARRAY | STRING | |
| TEXT SEARCH | BYTE\$1ARRAY | STRING | |
| VARCHAR(N) | BYTE\$1ARRAY | STRING | |
| XML | BYTE\$1ARRAY | STRING | |
| Jenis data tanggal dan waktu |
| DATE | BYTE\$1ARRAY | STRING | |
| INTERVAL | BYTE\$1ARRAY | STRING | |
| TIME | BYTE\$1ARRAY | STRING | |
| TIME WITH TIME ZONE | BYTE\$1ARRAY | STRING | |
| TIMESTAMP | BYTE\$1ARRAY | STRING | |
| TIMESTAMP WITH TIME ZONE | BYTE\$1ARRAY | STRING | |
| Jenis data geometris |
| BOX | BYTE\$1ARRAY | STRING | |
| CIRCLE | BYTE\$1ARRAY | STRING | |
| LINE | BYTE\$1ARRAY | STRING | |
| LINESEGMENT | BYTE\$1ARRAY | STRING | |
| PATH | BYTE\$1ARRAY | STRING | |
| POINT | BYTE\$1ARRAY | STRING | |
| POLYGON | BYTE\$1ARRAY | STRING | |
| Jenis data JSON |
| JSON | BYTE\$1ARRAY | STRING | |
| JSONB | BYTE\$1ARRAY | STRING | |
| Jenis data lainnya |
| BOOLEAN | BOOLEAN | | |
| CIDR | BYTE\$1ARRAY | STRING | Jenis data jaringan |
| COMPOSITE | BYTE\$1ARRAY | STRING | |
| DOMAIN | BYTE\$1ARRAY | STRING | |
| INET | BYTE\$1ARRAY | STRING | Jenis data jaringan |
| MACADDR | BYTE\$1ARRAY | STRING | |
| OBJECT IDENTIFIER | N/A | | |
| PG\$1LSN | BYTE\$1ARRAY | STRING | |
| RANGE | BYTE\$1ARRAY | STRING | |
| UUID | BYTE\$1ARRAY | STRING | |