Menggunakan Amazon DocumentDB sebagai target AWS untuk Database Migration Service

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

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

Untuk informasi tentang versi Amazon DocumentDB (dengan kompatibilitas MongoDB) yang mendukung, lihat. AWS DMS Target untuk AWS DMS Anda dapat menggunakan AWS DMS untuk memigrasikan data ke Amazon DocumentDB (dengan kompatibilitas MongoDB) dari salah satu mesin data sumber yang didukung AWS DMS . Mesin sumber dapat berada di layanan AWS terkelola seperti Amazon RDS, Aurora, atau Amazon S3. Atau mesin dapat berada di database yang dikelola sendiri, seperti MongoDB yang berjalan di EC2 Amazon atau lokal.

Anda dapat menggunakan AWS DMS untuk mereplikasi data sumber ke database, koleksi, atau dokumen Amazon DocumentDB.

MongoDB menyimpan data dalam format JSON biner (BSON). AWS DMS mendukung semua tipe data BSON yang didukung oleh Amazon DocumentDB. Untuk daftar tipe data ini, lihat APIsMongoDB, operasi, dan tipe data yang didukung di Panduan Pengembang Amazon DocumentDB.

Jika titik akhir sumber adalah database relasional, AWS DMS memetakan objek database ke Amazon DocumentDB sebagai berikut:

Jika titik akhir sumber adalah Amazon S3, maka objek Amazon DocumentDB yang dihasilkan sesuai dengan AWS DMS aturan pemetaan untuk Amazon S3. Contohnya, perhatikan URI berikut ini.

s3://mybucket/hr/employee

Dalam hal ini, AWS DMS memetakan objek mybucket ke Amazon DocumentDB sebagai berikut:

Untuk informasi lebih lanjut tentang aturan pemetaan untuk Amazon S3, lihat Menggunakan Amazon S3 sebagai sumber untuk AWS DMS.

Untuk detail tambahan tentang bekerja dengan Amazon DocumentDB sebagai target, lihat AWS DMS bagian berikut:

Pemetaan data dari sumber ke target Amazon DocumentDB

AWS DMS membaca catatan dari titik akhir sumber, dan membangun dokumen JSON berdasarkan data yang dibacanya. Untuk setiap dokumen JSON, AWS DMS harus menentukan _id bidang untuk bertindak sebagai pengidentifikasi unik. Kemudian menulis dokumen JSON ke koleksi Amazon DocumentDB, menggunakan _id sebagai kunci primer.

Sumber data yang berupa kolom tunggal

Jika sumber data terdiri dari satu kolom, data harus bertipe string. (Tergantung pada mesin sumber, tipe data sebenarnya mungkin VARCHAR, NVARCHAR, TEXT, LOB, CLOB, atau serupa.) AWS DMS mengasumsikan bahwa data tersebut adalah dokumen JSON yang valid, dan mereplikasi data ke Amazon DocumentDB apa adanya.

Jika dokumen JSON yang dihasilkan berisi field bernama _id, maka field tersebut digunakan sebagai unik _id di Amazon DocumentDB.

Jika JSON tidak berisi field _id, maka Amazon DocumentDB menghasilkan nilai _id secara otomatis.

Sumber data yang terdiri dari beberapa kolom

Jika data sumber terdiri dari beberapa kolom, kemudian AWS DMS membangun dokumen JSON dari semua kolom ini. Untuk menentukan _id bidang dokumen, AWS DMS lanjutkan sebagai berikut:

Memaksakan tipe data pada titik akhir target

AWS DMS dapat memodifikasi struktur data saat menulis ke titik akhir target Amazon DocumentDB. Anda dapat meminta perubahan ini dengan mengubah nama kolom dan tabel di titik akhir sumber, atau dengan menyediakan aturan transformasi yang diterapkan ketika tugas berjalan.

Menggunakan dokumen JSON nested (json_prefix)

Untuk memaksakan tipe data, Anda dapat mengawali nama kolom sumber dengan json_ (yaitu, json_columnName) baik secara manual atau menggunakan transformasi. Dalam kasus ini, kolom dibuat sebagai dokumen JSON nested dalam dokumen target, bukan sebagai field string.

Misalnya, anggaplah Anda ingin memigrasikan dokumen berikut dari titik akhir sumber MongoDB.

{
    "_id": "1", 
    "FirstName": "John", 
    "LastName": "Doe",
    "ContactDetails": "{"Home": {"Address": "Boston","Phone": "1111111"},"Work": { "Address": "Boston", "Phone": "2222222222"}}"
}

Jika Anda tidak memaksa salah satu tipe sumber data, dokumen ContactDetails yang tertanam akan dimigrasi sebagai string.

{
    "_id": "1", 
    "FirstName": "John", 
    "LastName": "Doe",
    "ContactDetails": "{\"Home\": {\"Address\": \"Boston\",\"Phone\": \"1111111\"},\"Work\": { \"Address\": \"Boston\", \"Phone\": \"2222222222\"}}"
}

Namun, Anda dapat menambahkan aturan transformasi untuk memaksa ContactDetailsmenjadi objek JSON. Misalnya, anggaplah bahwa nama kolom sumber asli adalah ContactDetails. Untuk memaksa tipe data sebagai Nested JSON, kolom di titik akhir sumber perlu diganti namanya menjadi json_ContactDetails” baik dengan menambahkan awalan “*json_*” pada sumber secara manual atau melalui aturan transformasi. Misalnya, Anda dapat menggunakan aturan transformasi di bawah ini:

{
    "rules": [
    {
    "rule-type": "transformation",
    "rule-id": "1",
    "rule-name": "1",
    "rule-target": "column",
    "object-locator": {
    "schema-name": "%",
    "table-name": "%",
    "column-name": "ContactDetails"
     },
    "rule-action": "rename",
    "value": "json_ContactDetails",
    "old-value": null
    }
    ]
}
                    

AWS DMS mereplikasi ContactDetails bidang sebagai JSON bersarang, sebagai berikut.

{
    "_id": "1",
    "FirstName": "John",
    "LastName": "Doe",
    "ContactDetails": {
        "Home": {
            "Address": "Boston",
            "Phone": "1111111111"
        },
        "Work": {
            "Address": "Boston",
            "Phone": "2222222222"
        }
    }
}

Menggunakan array JSON (array_prefix)

Untuk memaksakan tipe data, Anda dapat mengawali nama kolom dengan array_ (yaitu, array_columnName), baik secara manual maupun menggunakan transformasi. Dalam hal ini, AWS DMS pertimbangkan kolom sebagai array JSON, dan membuatnya seperti itu dalam dokumen target.

Misalnya Anda ingin memigrasikan dokumen berikut dari titik akhir sumber MongoDB.

{
    "_id" : "1",
    "FirstName": "John",
    "LastName": "Doe",

    "ContactAddresses": ["Boston", "New York"],
            
    "ContactPhoneNumbers": ["1111111111", "2222222222"]
}

Jika Anda tidak memaksakan salah satu tipe sumber data, dokumen ContactDetails yang tertanam akan dimigrasi sebagai string.

{
    "_id": "1",
    "FirstName": "John",
    "LastName": "Doe",

    "ContactAddresses": "[\"Boston\", \"New York\"]",
            
    "ContactPhoneNumbers": "[\"1111111111\", \"2222222222\"]"

}                

Namun, Anda dapat menambahkan aturan transformasi untuk memaksa ContactAddress dan ContactPhoneNumbers ke array JSON, seperti yang ditunjukkan pada tabel berikut.

AWS DMS mereplikasi ContactAddress dan ContactPhoneNumbers sebagai berikut.

{
    "_id": "1",
    "FirstName": "John",
    "LastName": "Doe",
    "ContactAddresses": [
        "Boston",
        "New York"
    ],
    "ContactPhoneNumbers": [
        "1111111111",
        "2222222222"
    ]
}             

Menghubungkan ke Amazon DocumentDB menggunakan TLS

Secara default, klaster Amazon DocumentDB yang baru dibuat hanya menerima sambungan aman menggunakan Keamanan Lapisan Pengangkutan (TLS). Ketika TLS diaktifkan, setiap sambungan ke Amazon DocumentDB memerlukan kunci publik.

Anda dapat mengambil kunci publik untuk Amazon DocumentDB dengan mengunduh rds-combined-ca-bundle.pem file,, dari bucket Amazon S3 yang AWS dihosting. Untuk informasi lebih lanjut tentang mengunduh file ini, lihat Mengenkripsi sambungan menggunakan TLS dalam Panduan Developer Amazon DocumentDB

Setelah mengunduh file.pem ini, Anda dapat mengimpor kunci publik yang dikandungnya AWS DMS seperti yang dijelaskan berikut.

AWS Management Console

AWS CLI

Gunakan perintah aws dms import-certificate seperti pada contoh berikut.

aws dms import-certificate \
    --certificate-identifier docdb-cert \
    --certificate-pem file://./rds-combined-ca-bundle.pem

Saat Anda membuat titik akhir AWS DMS target, berikan pengenal sertifikat (misalnya,docdb-cert). Juga, tetapkan parameter mode SSL ke verify-full.

Menghubungkan ke Amazon DocumentDB Elastic Clusters sebagai target

Di AWS DMS versi 3.4.7 dan yang lebih tinggi, Anda dapat membuat titik akhir target Amazon DocumentDB sebagai Elastic Cluster. Jika Anda membuat titik akhir target sebagai Elastic Cluster, Anda harus melampirkan sertifikat SSL baru ke titik akhir Amazon DocumentDB Elastic Cluster karena sertifikat SSL yang ada tidak akan berfungsi.

Sertifikat SSL baru dari SFSRootCAG2.pem file yang diunduh sekarang dilampirkan ke titik akhir Amazon DocumentDB Elastic Cluster Anda.

Replikasi berkelanjutan dengan Amazon DocumentDB sebagai target

Jika replikasi yang sedang berlangsung (ubah pengambilan data, CDC) diaktifkan untuk Amazon DocumentDB sebagai target AWS DMS , versi 3.5.0 dan yang lebih tinggi memberikan peningkatan kinerja yang dua puluh kali lebih besar daripada rilis sebelumnya. Dalam rilis sebelumnya di mana AWS DMS menangani hingga 250 catatan per detik, AWS DMS sekarang efisien memproses lebih dari 5000 catatan per detik. AWS DMS juga memastikan bahwa dokumen di Amazon DocumentDB tetap sinkron dengan sumbernya. Ketika rekaman sumber dibuat atau diperbarui, pertama-tama AWS DMS harus menentukan data Amazon DocumentDB mana yang terpengaruh dengan melakukan hal berikut:

Saat catatan sumber baru dibuat, AWS DMS tulis dokumen yang sesuai ke Amazon DocumentDB. Jika catatan sumber yang ada diperbarui, AWS DMS perbarui bidang terkait dalam dokumen target di Amazon DocumentDB. Setiap field yang ada di dokumen target tetapi tidak ada di catatan sumber tetap tak tersentuh.

Ketika catatan sumber dihapus, AWS DMS menghapus dokumen yang sesuai dari Amazon DocumentDB.

Perubahan struktural (DDL) pada sumbernya

Dengan replikasi berkelanjutan, setiap perubahan pad struktur data sumber (seperti tabel, kolom, dan sebagainya) disebarkan ke rekan-rekan mereka di Amazon DocumentDB. Dalam basis data relasional, perubahan ini dimulai dengan menggunakan pernyataan bahasa definisi data (DDL). Anda dapat melihat bagaimana AWS DMS menyebarkan perubahan ini ke Amazon DocumentDB di tabel berikut.

Keterbatasan penggunaan Amazon DocumentDB sebagai target

Batasan berikut berlaku saat menggunakan Amazon DocumentDB sebagai target untuk: AWS DMS

Menggunakan pengaturan titik akhir dengan Amazon DocumentDB sebagai target

Anda dapat menggunakan pengaturan titik akhir untuk mengonfigurasi basis data target Amazon DocumentDB mirip dengan menggunakan atribut koneksi tambahan. Anda menentukan pengaturan saat Anda membuat titik akhir target menggunakan AWS DMS konsol, atau dengan menggunakan create-endpoint perintah di AWS CLI, dengan sintaks --doc-db-settings '{"EndpointSetting": "value", ...}' JSON.

Tabel berikut menunjukkan pengaturan titik akhir yang dapat Anda gunakan dengan Amazon DocumentDB sebagai target.

Target tipe data untuk Amazon DocumentDB

Dalam tabel berikut, Anda dapat menemukan tipe data target Amazon DocumentDB yang didukung saat AWS menggunakan DMS, dan pemetaan AWS default dari tipe data DMS. Untuk informasi selengkapnya tentang tipe data AWS DMS, lihatTipe data untuk AWS Database Migration Service.