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 klaster Amazon DocumentDB yang disediakan. Saat Anda membuat klon menggunakan konfigurasi penyebaran yang berbeda dari sumbernya, klon dibuat menggunakan versi terbaru dari mesin Amazon DocumentDB sumber.

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

Ikhtisar kloning Amazon DocumentDB

Amazon DocumentDB menggunakan protokol untuk copy-on-write 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 Amazon DocumentDB sumber atau klon klon Amazon DocumentDB. Untuk mempelajari lebih lanjut tentang copy-on-write protokol, lihatCara 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 instance 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.

Keterbatasan kloning Amazon DocumentDB

Amazon DocumentDB; kloning saat ini memiliki batasan sebagai 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 point-in-time pemulihan.

• Anda tidak dapat membuat klon di AWS Wilayah yang berbeda 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 klaster Amazon DocumentDB. Jika Anda melakukannya, subnet VPC harus dipetakan ke Zona Ketersediaan yang sama.

Cara kerja kloning Amazon DocumentDB

Kloning Amazon DocumentDB bekerja pada lapisan penyimpanan cluster Amazon DocumentDB. Ini menggunakan copy-on-writeprotokol yang cepat dan hemat ruang dalam hal media tahan lama yang mendasarinya yang mendukung volume penyimpanan Amazon DocumentDB. Anda dapat mempelajari lebih lanjut tentang volume klaster Amazon DocumentDB di. Mengelola cluster Amazon DocumentDB

Topik

• Memahami copy-on-write protokol
• Menghapus volume klaster sumber

Memahami copy-on-write protokol

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 Amazon DocumentDB sumber.

Saat klon dibuat, tidak ada penyimpanan tambahan yang biasanya diperlukan. copy-on-write Protokol 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 copy-on-write protokol dalam tindakan menggunakan cluster A yang sama dan klonnya, B, seperti yang ditunjukkan sebelumnya. Katakanlah Anda membuat perubahan pada klaster 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, sedangkan 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 semakin banyak perubahan terjadi dari waktu ke waktu di volume cluster Amazon DocumentDB sumber 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 Amazon DocumentDB sumber. Untuk melakukannya, Anda dapat menggunakan AWS Management Console atau AWS CLI dan prosedur berikut.

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

Using the AWS Management Console

Prosedur berikut menjelaskan cara mengkloning cluster Amazon DocumentDB menggunakan. AWS Management Console

Membuat klon menggunakan AWS Management Console hasil di cluster Amazon DocumentDB dengan satu instance 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 AWS akun Anda menggunakan AWS Management Console

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

2. Pada panel navigasi, silakan pilih Klaster.

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

   

   Halaman Create clone terbuka, di mana Anda dapat mengonfigurasi pengenal Cluster dan kelas Instance, dan opsi lain untuk klon klon Amazon DocumentDB.

4. Di bagian Pengaturan, lakukan hal berikut:

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

   2. Untuk konfigurasi Instance, pilih class Instance yang sesuai untuk klaster Amazon DocumentDB kloning Anda.

      

   3. Untuk pengaturan Jaringan, pilih grup Subnet untuk kasus penggunaan Anda dan grup keamanan VPC terkait.

   4. Untuk E ncryption-at-rest, jika cluster sumber (cluster yang sedang dikloning) mengaktifkan enkripsi, klaster kloning juga harus mengaktifkan enkripsi. Jika skenario ini benar, maka opsi Enable encryption berwarna abu-abu (dinonaktifkan) tetapi dengan pilihan Enable encryption yang dipilih. Sebaliknya, jika cluster sumber tidak mengaktifkan enkripsi, opsi Enable encryption 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 penghapusan cluster secara tidak sengaja (diaktifkan secara default).

      

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

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

Saat klon dibuat, klon tersebut terdaftar dengan kluster 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.

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

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

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

Perintah berikut mengasumsikan bahwa AWS CLI diatur dengan AWS Wilayah 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 klaster Amazon DocumentDB yang disediakan.

Untuk membuat tiruan dari mode mesin yang sama dengan sumber cluster 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 memberi nama klon saat Anda menggunakan perintah restore-db-cluster-to- point-in-time CLI.

  • --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 Amazon DocumentDB sumber 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 menggunakan 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-nilai lain yang Anda butuhkan untuk membuat instance DB untuk klon Anda dengan menggunakan AWS CLI kueri 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

Gunakan perintah create-db-instanceCLI untuk membuat instance DB untuk klon Anda.

--db-instance-classParameter ini digunakan hanya untuk klaster 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 Amazon DocumentDB sumber 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 sumber Amazon DocumentDB cluster.
--use-latest-restorable-time	Nilai ini menunjuk ke data volume terbaru yang dapat dipulihkan untuk klon.