Mengkloning volume untuk cluster Amazon DocumentDB

Dengan menggunakan kloning Amazon DocumentDB, Anda dapat membuat cluster baru yang menggunakan volume cluster Amazon DocumentDB yang sama dan memiliki data yang sama dengan aslinya. Prosesnya dirancang agar cepat dan hemat biaya. Klaster baru dengan volume data terkaitnya dikenal sebagai Klon. Membuat klon lebih cepat dan lebih hemat ruang daripada menyalin data secara fisik menggunakan teknik lain, seperti memulihkan snapshot.

Amazon DocumentDB mendukung pembuatan klon yang disediakan Amazon DocumentDB dari cluster Amazon DocumentDB yang disediakan. Saat Anda membuat klon menggunakan konfigurasi penerapan yang berbeda dari sumbernya, klon dibuat menggunakan mesin Amazon DocumentDB versi terbaru sumber tersebut.

Saat Anda membuat klon dari cluster Amazon DocumentDB, klon dibuat di akun Anda AWS —akun yang sama yang memiliki cluster Amazon DocumentDB sumber.

Ikhtisar kloning Amazon DocumentDB

Amazon DocumentDB menggunakan protokol copy-on-write untuk membuat klon. Mekanisme ini menggunakan ruang tambahan minimal untuk membuat klon awal. Saat klon pertama kali dibuat, Amazon DocumentDB menyimpan satu salinan data yang digunakan oleh cluster DB sumber dan cluster Amazon DocumentDB baru (kloning). Penyimpanan tambahan dialokasikan hanya ketika perubahan dilakukan pada data (pada volume penyimpanan Amazon DocumentDB) oleh cluster sumber Amazon DocumentDB atau klon cluster Amazon DocumentDB. Untuk mempelajari selengkapnya tentang protokol copy-on-write, lihat Cara kerja kloning Amazon DocumentDB.

Kloning Amazon DocumentDB sangat berguna untuk menyiapkan lingkungan pengujian dengan cepat menggunakan data produksi Anda, tanpa risiko kerusakan data. Anda dapat menggunakan klon untuk berbagai jenis aplikasi, seperti berikut:

• Bereksperimen dengan potensi perubahan (misalnya, perubahan skema dan perubahan grup parameter) untuk menilai semua dampak.

• Menjalankan operasi sarat beban kerja, seperti mengekspor data atau menjalankan kueri analitis.

• Membuat salinan dari klaster DB produksi Anda untuk pengembangan, pengujian, atau tujuan lainnya.

Anda dapat membuat lebih dari satu klon dari cluster Amazon DocumentDB yang sama. Anda juga dapat membuat beberapa klon dari klon lain.

Setelah membuat klon Amazon DocumentDB, Anda dapat mengonfigurasi instans Amazon DocumentDB secara berbeda dari cluster Amazon DocumentDB sumber. Misalnya, Anda mungkin tidak memerlukan klon untuk tujuan pengembangan agar memenuhi persyaratan ketersediaan tinggi yang sama dengan klaster Amazon DocumentDB produksi sumber. Dalam hal ini, Anda dapat mengonfigurasi klon dengan satu instans Amazon DocumentDB daripada beberapa instans DB yang digunakan oleh cluster Amazon DocumentDB.

Setelah selesai menggunakan klon untuk pengujian, pengembangan, atau tujuan lainnya, Anda dapat menghapusnya.

Catatan penggunaan untuk kloning Amazon DocumentDB

Amazon DocumentDB; kloning saat ini memiliki batasan berikut:

• Anda dapat membuat klon sebanyak yang Anda inginkan, hingga jumlah maksimum klaster DB yang diizinkan di Wilayah AWS. Namun, setelah Anda membuat 15 klon, klon berikutnya adalah salinan lengkap. Operasi kloning bertindak seperti pemulihan point-in-time.

• Anda tidak dapat membuat klon di Wilayah yang berbeda AWS dari cluster Amazon DocumentDB sumber.

• Anda tidak dapat membuat klon dari cluster Amazon DocumentDB yang tidak memiliki instans DB. Anda hanya dapat mengkloning cluster Amazon DocumentDB yang memiliki setidaknya satu instans DB.

• Anda dapat membuat klon di cloud pribadi virtual (VPC) yang berbeda dari cluster Amazon DocumentDB. Jika Anda melakukannya, subnet VPC harus dipetakan ke Zona Ketersediaan yang sama.

Cara kerja kloning Amazon DocumentDB

Kloning Amazon DocumentDB bekerja di lapisan penyimpanan cluster Amazon DocumentDB. Ini menggunakan protokol copy-on-write yang cepat dan hemat ruang dalam hal media tahan lama yang mendasarinya yang mendukung volume penyimpanan Amazon DocumentDB. Anda dapat mempelajari selengkapnya tentang volume cluster Amazon DocumentDB diMengelola cluster Amazon DocumentDB.

Topik

• Memahami protokol copy-on-write

• Menghapus volume klaster sumber

Memahami protokol copy-on-write

Cluster Amazon DocumentDB menyimpan data di halaman dalam volume penyimpanan Amazon DocumentDB yang mendasarinya.

Misalnya, dalam diagram berikut Anda dapat menemukan cluster Amazon DocumentDB (A) yang memiliki empat halaman data, 1, 2, 3, dan 4. Bayangkan bahwa klon, B, dibuat dari cluster Amazon DocumentDB. Saat klon dibuat, tidak ada data yang disalin. Sebaliknya, klon menunjuk ke kumpulan halaman yang sama dengan cluster sumber Amazon DocumentDB.

Saat klon dibuat, tidak ada penyimpanan tambahan yang biasanya diperlukan. Protokol copy-on-write menggunakan segmen yang sama pada media penyimpanan fisik sebagai segmen sumber. Penyimpanan tambahan hanya diperlukan jika kapasitas segmen sumber tidak cukup untuk seluruh segmen klon. Jika demikian, segmen sumber disalin ke perangkat fisik lain.

Dalam diagram berikut, Anda dapat menemukan contoh protokol copy-on-write dalam praktiknya menggunakan klaster A yang sama dan klonnya, B, seperti yang ditunjukkan di atas. Katakanlah Anda membuat perubahan pada cluster Amazon DocumentDB (A) yang menghasilkan perubahan pada data yang disimpan di halaman 1. Alih-alih menulis ke halaman asli 1, Amazon DocumentDB membuat halaman baru 1 [A]. Volume cluster Amazon DocumentDB untuk cluster (A) sekarang menunjuk ke halaman 1 [A], 2, 3, dan 4, sementara klon (B) masih mereferensikan halaman asli.

Pada klon, perubahan dibuat pada halaman 4 di volume penyimpanan. Alih-alih menulis ke halaman asli 4, Amazon DocumentDB membuat halaman baru, 4 [B]. Klon sekarang menunjuk ke halaman 1, 2, 3, dan halaman 4[B], sementara klaster (A) terus menunjuk ke 1[A], 2, 3, dan 4.

Karena lebih banyak perubahan terjadi dari waktu ke waktu di volume cluster sumber Amazon DocumentDB dan klon, lebih banyak penyimpanan diperlukan untuk menangkap dan menyimpan perubahan.

Menghapus volume klaster sumber

Saat Anda menghapus volume klaster sumber yang memiliki satu atau beberapa klon yang berkaitan dengannya, klon ini tidak akan terpengaruh. Klon terus menunjuk ke halaman yang sebelumnya dimiliki oleh volume klaster sumber.

Membuat klon Amazon DocumentDB

Anda dapat membuat klon di AWS akun yang sama dengan cluster sumber Amazon DocumentDB. Untuk melakukannya, Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI dan prosedur berikut.

Dengan menggunakan kloning Amazon DocumentDB, Anda dapat membuat klon cluster Amazon DocumentDB yang disediakan dari cluster Amazon DocumentDB yang disediakan.

Using the Konsol Manajemen AWS

Prosedur berikut menjelaskan cara mengkloning cluster Amazon DocumentDB menggunakan. Konsol Manajemen AWS

Membuat klon menggunakan Konsol Manajemen AWS hasil di cluster Amazon DocumentDB dengan satu instans Amazon DocumentDB.

Instruksi ini berlaku untuk cluster DB yang dimiliki oleh AWS akun yang sama yang membuat klon. Cluster DB harus dimiliki oleh AWS akun yang sama karena kloning lintas akun tidak didukung di Amazon DocumentDB.

Untuk membuat tiruan dari cluster DB yang dimiliki oleh Anda AWS akun menggunakan Konsol Manajemen AWS

1. Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di https://console.aws.amazon.com/docdb.

2. Pada panel navigasi, silakan pilih Klaster.

3. Pilih cluster Amazon DocumentDB Anda dari daftar, dan untuk Tindakan , pilih Buat klon.

   

   Halaman Buat klon terbuka, di mana Anda dapat mengonfigurasi pen gidentifikasi Cluster dan kelas Inst ance, dan opsi lain untuk klon cluster Amazon DocumentDB.

4. Di bagian Pengaturan, lakukan hal berikut:

   1. Untuk pengidentifikasi Cluster, masukkan nama yang ingin Anda berikan ke cluster Amazon DocumentDB kloning Anda.

   2. Untuk konfigurasi Instance, pilih kelas Instance yang sesuai untuk cluster Amazon DocumentDB kloning Anda.

      

   3. Untuk Pengaturan jaringan, pilih grup Subnet untuk kasus penggunaan Anda dan grup keamanan VPC terkait.

   4. Untuk Encryption-at-rest, jika cluster sumber (cluster yang sedang dikloning) mengaktifkan enkripsi, cluster kloning juga harus mengaktifkan enkripsi. Jika skenario ini benar, maka opsi Aktifkan enkripsi berwarna abu-abu (dinonaktifkan) tetapi dengan pilihan Aktifkan enkripsi dipilih. Sebaliknya, jika cluster sumber tidak mengaktifkan enkripsi, opsi Aktifkan enkripsi tersedia dan Anda dapat memilih untuk mengaktifkan atau menonaktifkan enkripsi.

      

   5. Selesaikan konfigurasi klon cluster baru dengan memilih jenis log yang akan diekspor (opsional), memasukkan port tertentu yang digunakan untuk terhubung ke cluster, dan mengaktifkan perlindungan dari menghapus cluster secara tidak sengaja (diaktifkan secara default).

      

   6. Selesai memasukkan semua pengaturan untuk klon cluster Amazon DocumentDB Anda. Untuk mempelajari selengkapnya tentang pengaturan cluster dan instans Amazon DocumentDB, lihatMengelola cluster Amazon DocumentDB.

5. Pilih Buat klon untuk meluncurkan klon Amazon DocumentDB dari cluster Amazon DocumentDB pilihan Anda.

Saat klon dibuat, klon akan terdaftar dengan cluster Amazon DocumentDB Anda yang lain di bagian Database konsol dan menampilkan statusnya saat ini. Klon Anda siap digunakan ketika statusnya Tersedia.

Using the AWS CLI

Menggunakan AWS CLI untuk mengkloning cluster Amazon DocumentDB Anda melibatkan beberapa langkah.

Per restore-db-cluster-to-point-in-time AWS CLI intah yang Anda gunakan menghasilkan cluster Amazon DocumentDB kosong dengan 0 instans Amazon DocumentDB. Artinya, perintah mengembalikan hanya cluster Amazon DocumentDB, bukan instance DB untuk cluster tersebut. Anda melakukannya secara terpisah setelah klon tersedia. Dua langkah dalam proses ini adalah sebagai berikut:

1. Buat klon dengan menggunakan perintah CLI restore-db-cluster-to-point-in-time. Parameter yang Anda gunakan dengan perintah ini mengontrol jenis kapasitas dan detail lainnya dari cluster Amazon DocumentDB kosong (klon) yang sedang dibuat.

2. Buat instance Amazon DocumentDB untuk klon dengan menggunakan perintah create-db-instance CLI untuk membuat ulang instans Amazon DocumentDB di cluster Amazon DocumentDB yang dipulihkan.

Perintah berikut mengasumsikan bahwa AWS CLI diatur dengan Wil AWS ayah Anda sebagai default. Dengan pendekatan ini, Anda tidak perlu meneruskan nama --region di setiap perintah. Untuk informasi selengkapnya, lihat Mengonfigurasi AWS CLI. Anda juga dapat menentukan --region di setiap perintah CLI selanjutnya.

Topik

Membuat klon

Parameter tertentu yang Anda teruskan ke perintah CLI restore-db-cluster-to-point-in-time akan bervariasi. Apa yang Anda lewati tergantung pada jenis klon yang ingin Anda buat.

Gunakan prosedur berikut untuk membuat klon Amazon DocumentDB yang disediakan dari cluster Amazon DocumentDB yang disediakan.

Untuk membuat klon dari mode mesin yang sama dengan cluster sumber Amazon DocumentDB

• Gunakan perintah CLI restore-db-cluster-to-point-in-time dan tentukan nilai untuk parameter berikut:

  • --db-cluster-identifier – Pilih nama yang bermakna untuk klon anda. Anda menamai klon ketika Anda menggunakan perintah CLI restore-db-cluster-to-point-in-time.

  • --restore-type – Gunakan copy-on-write untuk membuat klon dari klaster DB sumber. Tanpa parameter ini, restore-db-cluster-to-point-in-time mengembalikan cluster Amazon DocumentDB daripada membuat klon. Default untuk restore-type adalahfull-copy.

  • --source-db-cluster-identifier— Gunakan nama cluster sumber Amazon DocumentDB yang ingin Anda kloning.

  • --use-latest-restorable-time – Nilai ini menunjuk ke data volume terbaru yang dapat dipulihkan untuk klon. Parameter ini diperlukan untukrestore-type copy-on-write, bagaimanapun, Anda tidak dapat menggunakannya restore-to-time parameter dengan itu.

Contoh berikut membuat klon bernama my-clone dari klaster bernama my-source-cluster.

Untuk Linux, macOS, atau Unix:

aws docdb restore-db-cluster-to-point-in-time \
    --source-db-cluster-identifier my-source-cluster \
    --db-cluster-identifier my-clone \
    --restore-type copy-on-write \
    --use-latest-restorable-time

Untuk Windows:

aws docdb restore-db-cluster-to-point-in-time ^
    --source-db-cluster-identifier my-source-cluster ^
    --db-cluster-identifier my-clone ^
    --restore-type copy-on-write ^
    --use-latest-restorable-time

Perintah tersebut mengembalikan objek JSON yang berisi rincian dari klon. Periksa untuk memastikan bahwa klaster DB yang Anda kloning tersedia sebelum mencoba membuat instans DB untuk klon Anda. Untuk informasi selengkapnya, lihat Memeriksa status dan mendapatkan detail klon di bawah ini:

Memeriksa status dan mendapatkan detail klon

Anda dapat menggunakan perintah berikut untuk memeriksa status klaster DB kosong yang baru dibuat.

$ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text

Atau Anda dapat memperoleh status dan nilai lain yang Anda perlukan untuk membuat instance DB untuk klon Anda dengan menggunakan ku AWS CLI eri berikut:

Untuk Linux, macOS, atau Unix:

aws docdb describe-db-clusters --db-cluster-identifier my-clone \
  --query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}'

Untuk Windows:

aws docdb describe-db-clusters --db-cluster-identifier my-clone ^
  --query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}"

Kueri ini menghasilkan output yang serupa dengan berikut ini:

[
  {
        "Status": "available",
        "Engine": "docdb",
        "EngineVersion": "4.0.0",
    }
]

Membuat instance Amazon DocumentDB untuk klon Anda

Panggil perintah CLI create-db-instance untuk membuat instans DB untuk klon Anda.

--db-instance-classParameter hanya digunakan untuk cluster Amazon DocumentDB yang disediakan.

Untuk Linux, macOS, atau Unix:

aws docdb create-db-instance \
    --db-instance-identifier my-new-db \
    --db-cluster-identifier my-clone \
    --db-instance-class  db.r5.4xlarge \
    --engine docdb

Untuk Windows:

aws docdb create-db-instance ^
    --db-instance-identifier my-new-db ^
    --db-cluster-identifier my-clone ^
    --db-instance-class  db.r5.4xlarge ^
    --engine docdb

Parameter yang digunakan untuk kloning

Tabel berikut merangkum berbagai parameter yang digunakan restore-db-cluster-to-point-in-time untuk mengkloning cluster Amazon DocumentDB.

Parameter	Deskripsi
--source-db-cluster-identifier	Gunakan nama cluster sumber Amazon DocumentDB yang ingin Anda kloning.
--db-cluster-identifier	Gunakan parameter ini untuk memilih nama yang bermakna untuk klon anda. Anda menamai klon Anda dengan perintah restore-db-cluster-to-point-in-time. Kemudian, Anda meneruskan nama ini ke perintah create-db-instance.
--restore-type	Tentukan copy-on-write sebagai --restore-type untuk membuat klon dari cluster DB sumber daripada memulihkan cluster sumber Amazon DocumentDB.
--use-latest-restorable-time	Nilai ini menunjuk ke data volume terbaru yang dapat dipulihkan untuk klon.