All Products
Search
Document Center

ApsaraDB for MongoDB:Mengubah konfigurasi instance kluster sharding

Last Updated:Jul 02, 2025

Topik ini menjelaskan cara mengubah konfigurasi ApsaraDB for MongoDB instance kluster sharding yang sudah ada.

Batasan

  • Arsitektur atau mesin penyimpanan dari instance kluster sharding tidak dapat diubah. Sebagai contoh, instance kluster sharding tidak dapat diubah menjadi instance set replika.

  • Operasi pada node dari instance kluster sharding tunduk pada batasan berikut.

    Operasi

    Batasan

    Tambahkan node shard

    Spesifikasi dari komponen shard baru harus lebih tinggi atau sama dengan spesifikasi tertinggi di antara semua komponen shard dari instance kluster sharding.

    Sebagai contoh, jika komponen shard dengan konfigurasi tertinggi dalam instance kluster sharding memiliki kapasitas penyimpanan 10 GB, maka kapasitas penyimpanan dari komponen shard baru harus lebih besar atau sama dengan 10 GB.

    Ubah spesifikasi node shard

    • Kapasitas penyimpanan baru yang Anda tentukan harus lebih besar atau sama dengan kapasitas penyimpanan yang ada pada shard.

    • Jumlah node baca-saja baru yang Anda tentukan harus lebih besar atau sama dengan jumlah maksimum node baca-saja di antara shard.

    • Anda tidak dapat menambah jumlah node baca-saja dalam instance kluster sharding berlangganan yang sedang diturunkan.

    Ubah spesifikasi node ConfigServer

      Kapasitas penyimpanan baru yang Anda tentukan harus lebih besar atau sama dengan kapasitas penyimpanan yang ada pada node ConfigServer yang ingin Anda ubah dalam instance.

    • Konfigurasi node ConfigServer dalam instance kluster sharding yang menggunakan disk lokal tidak dapat diubah.

    Ubah konfigurasi beberapa node mongos, shard, dan ConfigServer secara massal

    Perhatikan batasan pada node mongos, shard, dan ConfigServer tertentu saat Anda mengubah konfigurasi node tersebut.

    Catatan
    • Konfigurasi node ConfigServer dalam instance kluster sharding yang menggunakan disk lokal tidak dapat diubah.

    • Untuk mengubah jumlah node baca-saja dalam node shard, Anda harus mengubah konfigurasi node shard.

    Lepaskan node mongos

    Node mongos dapat dilepaskan dari instance kluster sharding yang memiliki setidaknya tiga node mongos.

    Catatan

    Setidaknya dua node mongos harus dipertahankan untuk instance kluster sharding.

    Lepaskan node shard

    • Node shard dapat dilepaskan dari instance kluster yang memiliki setidaknya tiga node shard.

      Catatan

      Setidaknya dua node shard harus dipertahankan untuk instance kluster sharding.

    • Sebelum melepaskan node shard, pastikan bahwa penyeimbang ApsaraDB for MongoDB diaktifkan. Untuk informasi lebih lanjut, lihat Kelola penyeimbang ApsaraDB for MongoDB.

      Faktor-faktor berikut mempengaruhi waktu aktual yang dibutuhkan untuk melepaskan node: jumlah data pada node shard, jendela penyeimbangan, dan chunk raksasa.

      Catatan

      Untuk informasi lebih lanjut tentang jendela penyeimbangan dan chunk raksasa, lihat Jendela Penyeimbangan dan Chunk Raksasa.

      Pastikan bahwa node shard yang tersisa memiliki ruang penyimpanan yang cukup.

      Saat node shard dilepaskan, data pada node shard tersebut dipindahkan ke node shard yang tersisa. Jika ruang penyimpanan node shard yang tersisa penuh, instance akan otomatis terkunci untuk menghindari kehilangan data.

      Jika kesalahan duplicated key dilaporkan saat data pada node shard dipindahkan ke node shard yang tersisa, periksa apakah ada catatan dengan nilai bidang indeks unik yang sama.

      Sebagai contoh, node shard yang berbeda mungkin menyimpan dua dokumen dengan kunci shard yang berbeda tetapi kunci utama yang sama.

      Catatan

      Kesalahan duplicated key dikembalikan saat dokumen yatim piatu ada di database. Kami menyarankan Anda menghapus dokumen yatim piatu sebelum melepaskan node shard. Untuk informasi lebih lanjut, lihat bagian "Persiapan" dari topik Konfigurasikan sinkronisasi data satu arah antara instance ApsaraDB for MongoDB (arsitektur kluster sharding).

Aturan penagihan

Untuk informasi lebih lanjut, lihat Biaya Perubahan Konfigurasi.

Catatan penggunaan

  • Selama perubahan konfigurasi, satu atau dua kali pemutusan koneksi mungkin terjadi. Setiap pemutusan berlangsung sekitar 30 detik. Untuk mencegah perubahan konfigurasi mengganggu beban kerja Anda, kami sarankan Anda mengubah konfigurasi pada waktu yang memiliki dampak minimal terhadap bisnis Anda.

    Penting

    Jika Anda hanya mengubah kapasitas penyimpanan instance, sistem akan melakukan operasi yang sesuai berdasarkan apakah host Anda memiliki sumber daya penyimpanan yang cukup.

    • Jika host Anda memiliki sumber daya penyimpanan yang cukup, sistem akan meningkatkan kapasitas penyimpanan pada host Anda tanpa perlu migrasi lintas host atau failover. Pemutusan koneksi tidak terjadi selama proses peningkatan. Tugas peningkatan segera dieksekusi hingga selesai. Anda tidak perlu menunggu jendela pemeliharaan.

    • Jika host Anda tidak memiliki sumber daya penyimpanan yang cukup, migrasi lintas host dan failover diperlukan. Pemutusan koneksi mungkin terjadi selama proses peningkatan. Tugas peningkatan dilakukan selama jendela pemeliharaan yang ditentukan.

  • Jumlah waktu yang diperlukan untuk melakukan perubahan konfigurasi bergantung pada faktor-faktor seperti kondisi jaringan, status antrian tugas, dan ukuran data. Kami sarankan Anda mengubah konfigurasi instance kluster sharding selama jam-jam sepi dan memastikan bahwa aplikasi Anda dapat secara otomatis menyambung kembali ke instance.

  • Jika versi minor dari instance kluster sharding kedaluwarsa atau tidak lagi dipelihara, ApsaraDB for MongoDB secara otomatis memperbarui versi minor instance ke versi terbaru selama perubahan konfigurasi. Ini memastikan bahwa instance kluster sharding dapat memberikan performa dan stabilitas yang lebih tinggi.

Ikhtisar perubahan konfigurasi

Jenis Perubahan

Item Perubahan

Tambahkan Node Mongos

Saat Anda menambahkan node mongos, Anda dapat mengatur Instance Specifications dan Quantity.

Catatan

Maksimal 32 node mongos dapat ditambahkan ke setiap instance kluster sharding. Jika instance kluster sharding sudah memiliki tiga node mongos dan Anda ingin menambahkan lebih banyak node mongos, Anda dapat menambahkan maksimal 29 node mongos ke instance kluster sharding.

Tambahkan Komponen Shard

Saat Anda menambahkan node shard, Anda dapat mengatur Instance Specifications, Quantity, Storage, dan Read-only Nodes.

Catatan
  • Maksimal 32 node shard dapat ditambahkan ke setiap instance kluster sharding. Jika instance kluster sharding sudah memiliki tiga node shard dan Anda ingin menambahkan lebih banyak node shard, Anda dapat menambahkan maksimal 29 node shard ke instance kluster sharding.

  • Nilai Specifications dan Storage dari node shard baru harus lebih besar atau sama dengan nilai terbesar di antara node shard yang ada.

  • Anda tidak dapat mengurangi kapasitas penyimpanan node shard dalam instance yang ada. Untuk mengurangi kapasitas penyimpanan node, Anda dapat membuat instance baru dan kemudian memigrasikan data dari instance yang ada ke instance baru. Untuk informasi lebih lanjut, lihat Skenario dan Metode Lain untuk Perubahan Konfigurasi.

  • Jika node baca-saja ditambahkan saat Anda membuat node shard, nilai ruang penyimpanan yang ditentukan diterapkan pada node shard dan setiap node baca-saja.

Ubah Konfigurasi Satu atau Lebih Node Mongos

Nilai Instance Specifications dari satu atau lebih node mongos dapat diubah.

Ubah Konfigurasi Satu atau Lebih Shard

Nilai Instance Specifications, Storage Capacity, dan Read-only Nodes dari node shard dapat diubah.

Catatan
  • Saat Anda mengubah nilai parameter Storage Capacity, pastikan bahwa nilai baru lebih besar atau sama dengan kapasitas penyimpanan terbesar di antara semua node shard dari instance kluster sharding.

  • Jika Anda hanya meningkatkan kapasitas penyimpanan dan host yang menampung node instance memiliki sumber daya yang cukup, peningkatan lokal dilakukan dan tidak diperlukan migrasi data atau switchover antar instance. Oleh karena itu, konfigurasi baru mulai berlaku segera setelah peningkatan selesai, bukan dalam jendela pemeliharaan yang ditentukan.

  • Anda tidak dapat mengurangi kapasitas penyimpanan node shard dalam instance yang ada. Untuk mengurangi kapasitas penyimpanan node, Anda dapat membuat instance baru dan kemudian memigrasikan data dari instance yang ada ke instance baru. Untuk informasi lebih lanjut, lihat Skenario dan Metode Lain untuk Perubahan Konfigurasi.

  • Setelah nilai Storage Capacity dari node shard diubah, kapasitas penyimpanan baru diterapkan pada node shard dan setiap node baca-saja.

Ubah Konfigurasi Node ConfigServer dalam Instance Kluster Sharding

Anda dapat mengubah spesifikasi dan kapasitas penyimpanan node ConfigServer.

Catatan
  • Kapasitas penyimpanan baru harus lebih besar atau sama dengan kapasitas penyimpanan yang ada pada node ConfigServer.

  • Konfigurasi node ConfigServer dalam instance kluster sharding yang menggunakan disk lokal tidak dapat diubah.

Ubah Konfigurasi Beberapa Node Mongos, Shard, dan ConfigServer Secara Massal

Anda dapat memulai tugas perubahan konfigurasi untuk beberapa node mongos, shard, dan ConfigServer dalam instance kluster sharding sekaligus. Tugas tersebut melibatkan operasi berikut:

  • Ubah spesifikasi dan kapasitas penyimpanan satu atau lebih node shard.

  • Ubah spesifikasi satu atau lebih node mongos.

  • Ubah spesifikasi dan kapasitas penyimpanan node ConfigServer.

Catatan
  • Konfigurasi node ConfigServer dalam instance kluster sharding yang menggunakan disk lokal tidak dapat diubah.

  • Perhatikan batasan pada node mongos, shard, dan ConfigServer tertentu saat Anda mengubah konfigurasi node tersebut.

  • Untuk mengubah jumlah node baca-saja dalam node shard, Anda harus mengubah konfigurasi node shard.

Lepaskan Node Mongos atau Shard

Anda dapat melepaskan node mongos atau shard secara manual.

Penting

Sebelum melepaskan node shard dari instance kluster sharding, pastikan bahwa data dari node shard dapat dialihkan ke node shard yang tersisa dalam instance. Jika tidak, instance akan tetap berada dalam keadaan Deleting Node. Dalam hal ini, Anda tidak dapat melakukan operasi terkait database, akun, dan jaringan instance. Untuk informasi lebih lanjut tentang cara melihat penggunaan disk node shard, lihat Pemantauan Node (Sebelumnya Pemantauan Dasar).