：Perubahan kompatibilitas di MongoDB 4.0

Untuk dokumentasi resmi tentang perubahan kompatibilitas MongoDB, kunjungi Dokumentasi Lama.

Penghapusan MONGODB-CR

Mulai MongoDB 4.0, MongoDB tidak lagi mendukung mode autentikasi MONGODB-CR yang telah ditinggalkan.

Mulai MongoDB 3.0, Anda tidak dapat lagi membuat pengguna MONGODB-CR, kecuali penyebaran ditingkatkan dari versi 2.6 atau lebih lama dan mode autentikasi untuk pengguna MONGODB-CR asli belum diperbarui.

Jika penyebaran Anda masih menggunakan mode MONGODB-CR untuk menyimpan kredensial pengguna, Anda harus meningkatkannya ke Salted Challenge Response Authentication Mechanism (SCRAM) sebelum menaikkan versi ke MongoDB 4.0.

Penghapusan MMAPv1

Mulai MongoDB 4.0, MongoDB menghentikan dukungan untuk mesin penyimpanan MMAPv1. Anda harus bermigrasi ke mesin penyimpanan WiredTiger.

Batas pada sertifikat autentikasi X.509

Mulai dari MongoDB 4.0, jika Anda menentukan --sslAllowInvalidCertificates atau net.ssl.allowInvalidCertificates: true (diubah namanya menjadi --tlsAllowInvalidateCertificates atau net.tls.allowInvalidCertificates: true di MongoDB 4.2) saat menggunakan autentikasi x.509, sertifikat yang tidak valid hanya cukup untuk membangun koneksi TLS/SSL tetapi tidak cukup untuk autentikasi.

Untuk menyelesaikan masalah ini, perbarui sertifikat yang tidak valid menjadi sertifikat yang valid (seperti yang ditandatangani oleh CA tepercaya) atau gunakan net.ssl.CAFile untuk menentukan CA kustom.

Instansi set replika

cfg = rs.conf();
cfg.protocolVersion=1;
rs.reconfig(cfg);

Instansi kluster sharded

mongos menggunakan tingkat perhatian tulis "majority" dalam operasi-operasi berikut yang memengaruhi metadata kluster sharded.

Kompatibilitas fitur MongoDB 4.0

Beberapa fitur di MongoDB 4.0 memerlukan file biner V4.0 dan featureCompatibilityVersion disetel ke 4.0. Fitur-fitur tersebut meliputi:

• SCRAM-SHA-256

• Operator konversi tipe baru (termasuk $toBool dan $toInt) dan peningkatan

• Transaksi Multi-Dokumen

• Perubahan opsi $dateToString.

• Metode Aliran Perubahan Baru

• Perubahan tipe data token untuk melanjutkan aliran perubahan

Perubahan lainnya

• Instansi kluster sharded mendukung operator kueri geospasial $near dan $nearSphere.

• Untuk perintah create dan metode shell mongo db.createCollection(), saat membuat koleksi di database selain database local, Anda tidak dapat menyetel opsi autoIndexId ke false.

• Jika Anda mengaktifkan autentikasi dan menjalankan perintah listDatabases tanpa izin operasi listDatabases, MongoDB mengembalikan daftar semua database tempat Anda memiliki izin operasi find. Sebelum MongoDB 4.0, jika Anda menjalankan perintah tanpa izin operasi listDatabases, MongoDB mengembalikan Unauthorized.

• Nilai default dari taskExecutorPoolSize diubah dari 0 menjadi 1. Di Linux, untuk mengembalikan perilaku sebelumnya dari penyebaran V4.0, atur taskExecutorPoolSize ke 0 dan AsyncRequestsSenderUseBaton ke false.

• MongoDB 4.0 tidak mengizinkan Anda menyetel transportLayer dan net.transportLayer ke legacy untuk instansi mongod dan mongos. transportLayer disetel ke asio secara default dan tidak dapat diubah.

• Mulai MongoDB 4.0, perintah reIndex dan db.collection.reIndex()-nya mengambil kunci eksklusif global dan memblokir operasi lain hingga selesai.

• Jika nilai bidang selain year, isoYear, dan timezone melebihi rentang valid mereka, $dateFromParts mengurangi selisih dari bagian tanggal lain untuk menghitung tanggal. Sebelum MongoDB 4.0, nilai yang melebihi rentang valid menyebabkan kesalahan.

• Perilaku operasi killCursors diubah. Sebelum MongoDB 4.0, jika mendapatkan ID kursor, Anda dapat membunuh kursor apa pun. Mulai MongoDB 4.0, killCursors hanya mengizinkan Anda membunuh kursor yang ada. Jika Anda tidak memiliki izin untuk membunuh kursor, killCursors mengembalikan kesalahan.

• MongoDB 4.0 menambahkan operasi killAnyCursor yang memberikan izin untuk membunuh kursor apa pun untuk koleksi tertentu.

• Mulai MongoDB 4.0, ketika Anda mencoba menghubungkan instansi mongos ke instansi lain dengan versi kompatibilitas fitur (fCV) yang lebih tinggi, instansi mongos mungkin mogok. Misalnya, instansi mongos MongoDB 4.0 tidak dapat terhubung ke instansi kluster sharded dengan fCV disetel ke 4.2. Namun, jika fCV instansi kluster sharded tetap 4.0, instansi mongos dapat terhubung normal ke instansi lain.

• Mulai MongoDB 4.0, MongoDB menyelesaikan alamat IP localhost berdasarkan pengaturan yang ditentukan, bukan mengasumsikan 127.0.0.1.

TLS 1.0 Dinonaktifkan

File biner MongoDB (mongod, mongos, dan mongo) menonaktifkan enkripsi TLS 1.0 secara default untuk sistem yang mendukung TLS 1.1+.

Untuk memaksa mengaktifkan TLS 1.0:

• Untuk instansi mongod, tentukan net.ssl.disabledProtocols: none di file konfigurasi, atau gunakan parameter baris perintah --sslDisabledProtocols none.

• Untuk instansi mongos, gunakan net.ssl.disabledProtocols: none atau --sslDisabledProtocols none.

• Untuk shell mongo, tambahkan parameter --sslDisabledProtocols none.

  Parameter --sslDisabledProtocols dapat digunakan pada versi shell mongo berikut:

  • MongoDB 4.0+

  • MongoDB 3.6.5+

  • MongoDB 3.4.15+

Di macOS, jika menggunakan shell mongo MongoDB 3.6.4 atau lebih lama untuk terhubung ke instansi kluster sharded MongoDB 4.0+, Anda harus secara eksplisit mengaktifkan TLS 1.0.

Shell Mongo

db.runCommand( { listCollections: 1.0, authorizedCollections: true, nameOnly: true } )

db.runCommand( { listCollections: 1.0, authorizedCollections: true, nameOnly: true } )

Penghapusan file biner dan bidang atau perintah yang ditinggalkan

mongodump --archive --db=test | mongorestore --archive  --nsFrom='test.*' --nsTo='examples.*'