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

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 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 Amazon DocumentDB sumber atau klon klon 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:

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.

Keterbatasan kloning Amazon DocumentDB

Amazon DocumentDB; kloning saat ini memiliki batasan sebagai berikut:

Cara kerja kloning Amazon DocumentDB

Kloning Amazon DocumentDB bekerja pada 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 lebih lanjut tentang volume klaster Amazon DocumentDB di. Mengelola cluster Amazon DocumentDB

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

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 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 Konsol Manajemen AWS 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 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 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 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 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. Sebab Encryption-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 CLI restore-db-cluster-to-point-in-time. 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 CLI create-db-instance untuk membuat ulang instans Amazon DocumentDB di klaster 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 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 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

Panggil perintah CLI create-db-instance untuk membuat instans 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.