：Perubahan kompatibilitas di MongoDB 3.6

Perubahan perilaku $type: "array"

Mulai MongoDB 3.6, ekspresi type: "array" dan $type: 4 cocok dengan bidang array yang berisi elemen tipe apa pun.

Sebelum MongoDB 3.6, $type: "array" hanya cocok dengan bidang array yang berisi array bersarang.

Sebagai contoh, koleksi bernama c berisi dokumen-dokumen berikut:

{ "_id": 1, "a": [ 1, 2, 3 ] },
{ "_id": 2, "a": [ 1, 2, [ 3, 4 ] ] }

Operasi berikut meminta data berdasarkan tipe bidang a:

db.c.find( { "a": { $type : "array" } } )

Mulai MongoDB 3.6, query $type mengembalikan dua dokumen dalam koleksi karena query sekarang mendeteksi bahwa bidang a adalah sebuah array.

{ "_id": 1, "a": [ 1, 2, 3 ] },
{ "_id": 2, "a": [ 1, 2, [ 3, 4 ] ] }

Sebelum MongoDB 3.4, query $type hanya mengembalikan dokumen di mana bidang a berisi elemen-elemen tipe array BSON.

{ "_id": 2, "a": [ 1, 2, [ 3, 4 ] ] }

Jika instance saat ini menjalankan MongoDB 3.4.x dan Anda menggunakan indeks parsial yangpartialFilterExpression berisi $type: "array" atau $type: 4, Anda harus membangun ulang indeks-indeks ini setelah peningkatan ke MongoDB 3.6, sehingga menghindari konflik akibat perubahan semantik dalam $type: 'array'.

Perubahan perilaku pengurutan array

Mulai MongoDB 3.6, ketika mengurutkan pada bidang array, MongoDB menggunakan elemen array bernilai terendah untuk kunci pengurutan naik dan elemen array bernilai tertinggi untuk kunci pengurutan turun. Pengurutan tidak lagi mempertimbangkan predikat query ketika memilih elemen array sebagai kunci pengurutan. Perubahan perilaku ini berlaku untuk perintah find dan operasi pipeline agregasi.

Akibatnya, aplikasi yang mengurutkan pada bidang array mungkin mengembalikan hasil pengurutan yang berbeda.

{ _id: 0, a: [-3, -2, 2, 3] }
{ _id: 1, a: [ 5, -4 ] }

db.coll.find({a: {$gte: 0}}).sort({a: 1});

// Dokumen.
{ "_id" : 1, "timestamps" : [ ISODate("2017-07-15T15:31:01Z"), ISODate("2017-07-21T18:31:01Z") ] }
{ "_id" : 0, "timestamps" : [ ISODate("2017-07-21T15:31:01Z"), ISODate("2017-07-21T13:31:01Z") ] }

// Query.
db.c.aggregate([{$sort: {timestamps: -1}}])

// Dokumen.
{_id: 0, a: [3, 1, 5]}
{_id: 1, a: [3, 4, 0]}

// Query.
db.coll.aggregate([{$sort: {a: 1}}])

Pembaruan bidang baru

Mulai MongoDB 3.6, bidang yang ditambahkan selama operasi pembaruan ditambahkan dalam urutan leksikografis.

Sebagai contoh, koleksi bernama coll berisi dokumen berikut:

{ _id: 0, x: 0 }

Jalankan operasi pembaruan untuk menambahkan bidang-bidang berikut:

db.coll.update({_id: 0}, {$set: {b: 0, a: 0}})

Dalam MongoDB 3.6, bidang baru ditambahkan dalam urutan leksikografis. Akibatnya, dokumen yang diperbarui adalah {_id: 0, x: 0, a: 0, b: 0}.

Sebelum MongoDB 3.6, bidang baru ditambahkan dalam urutan kemunculan mereka dalam dokumen pembaruan. Akibatnya, dokumen yang diperbarui adalah {_id: 0, x: 0, b: 0, a: 0}.

Bidang yang bertentangan dengan sintaks identifier arrayFilters

Mulai MongoDB 3.6, bidang yang namanya bertentangan dengan sintaks identifier arrayFilters (seperti $[]) tidak dapat diperbarui lagi.

Sebagai contoh, koleksi bernama coll berisi dokumen berikut:

{ _id: 0, x: { "$[]": 0 } }

Jalankan operasi pembaruan:

db.coll.update({_id: 0}, {$set: {"x.$[]": 1}})

Mulai MongoDB 3.6, operasi pembaruan berhasil. Di MongoDB 3.6, operasi pembaruan gagal karena nama bidang $[] bertentangan dengan sintaks identifier arrayFilters.

Validasi yang lebih ketat dari operator $pop

Mulai MongoDB 3.6, parameter operator $pop harus disetel ke salah satu nilai berikut:

• -1: menghapus elemen pertama dari array, atau

• 1: menghapus elemen terakhir dari array.

Sebelum MongoDB 3.6:

• Nomor negatif untuk menghapus elemen pertama dari array, atau

• Nomor non-negatif atau nilai non-numerik untuk menghapus elemen terakhir dari array.

Penghapusan operator $pushAll

MongoDB 3.6 menghapus operator $pushAll (usang sejak MongoDB 2.4).

Gunakan operator $push dan $each sebagai gantinya. Contoh:

db.students.update(
   { name: "joe" },
   { $push: { scores: { $each: [ 90, 92, 85 ] } } }
)

Penghapusan mekanisme otentikasi MongoDB-CR

Mulai MongoDB 3.6, MongoDB menghapus mekanisme otentikasi MONGODB-CR. Jika belum, tingkatkan skema otentikasi MONGODB-CR Anda ke SCRAM.

Node arbiter dan prioritasnya

Semua node arbiter memiliki prioritas tetap 0.

Penghapusan arsitektur replikasi master-slave

MongoDB 3.6 secara resmi menghapus arsitektur replikasi master-slave.

Penghapusan opsi --nojournal untuk mesin penyimpanan WiredTiger

MongoDB 3.6 menghapus opsi --nojournal untuk anggota Replica Set yang menggunakan mesin penyimpanan WiredTiger, sehingga mengurangi risiko kehilangan data.

Penyesuaian terhadap perintah aggregate dan keluarannya

Mulai MongoDB 3.6, perintah aggregate tidak lagi mengembalikan hasil sebagai dokumen tunggal.

Saat menjalankan perintah aggregate, Anda harus menentukan salah satu opsi berikut:

• cursor: mengembalikan hasil sebagai kursor (cocok untuk dataset besar).

• explain: mengembalikan analisis rencana eksekusi untuk pipeline agregasi.

Kami merekomendasikan Anda menggunakan db.collection.aggregate() dalam mongo shell atau metode setara dalam driver Anda. Metode-metode ini mengembalikan kursor secara default kecuali opsi explain digunakan.

Perubahan konversi dari bidang tanggal ke string dalam ekspresi agregasi

Mulai MongoDB 3.6, MongoDB secara paksa mengonversi tanggal menjadi string yang berisi presisi milidetik dan diakhiri dengan huruf 'Z' (menunjukkan zona waktu UTC) dalam ekspresi agregasi.

Contoh:

// Dokumen.
{_id: 0, d: ISODate("2017-10-18T20:04:27.978Z")}
{_id: 1, d: ISODate("2017-10-18T20:04:28.192Z")}

// Query.
db.coll.aggregate({$project: {d: {$toLower: "$d"}}})

Sebelum MongoDB 3.6, bidang data dalam dua dokumen dikembalikan sebagai string dalam format "2017-10-18t20:04:27" dan "2017-10-18t20:04:28".

Mulai MongoDB 3.6, bidang data dalam dua dokumen dikembalikan sebagai string dalam format "2017-10-18t20:04:27.978z" dan "2017-10-18t20:04:28.192z" (termasuk milidetik dan huruf 'z' kecil).

Perubahan ini berlaku untuk operator agregasi berikut:

• $concat

• $substr

• $substrBytes

• $substrCP

• $strcasecmp

• $toLower

• $toUpper

Penghapusan perintah dan opsi diagnostik log

MongoDB 3.6 menghapus perintah diagLogging yang sudah usang dan opsi mongod --diaglog.

Sebagai gantinya, gunakan alat mongoreplay untuk menangkap, memutar ulang, dan menganalisis perintah yang dikirim ke penerapan MongoDB Anda.

Perubahan operasi validate

Mulai MongoDB 3.6, operasi validate secara paksa memicu checkpoint dan menyiram semua data dalam memori ke disk hanya sebelum menjalankan validasi untuk data disk.

Sebelum MongoDB 3.6, checkpoint dipicu secara paksa tanpa mempertimbangkan mode validasi yang digunakan.

Saat menggunakan perintah validate atau metode db.collection.validate(), tentukan secara eksplisit {full: true} untuk melakukan validasi penuh.

Batas nama indeks

Mulai MongoDB 3.6:

• Anda tidak dapat menentukan * sebagai nama indeks selama pembuatan indeks.

• Anda tidak dapat menggunakan kunci indeks untuk menghapus indeks bernama *. Gunakan nama indeks * untuk menghapus indeks tersebut sebagai gantinya.

Sebelum meningkatkan ke MongoDB 3.6, Anda harus:

• Menghapus indeks: Hapus secara manual semua indeks yang ada bernama *.

• Mengganti nama indeks: Untuk tetap menyimpan indeks, hapus mereka dan bangun ulang dengan nama baru.

Opsi yang sudah usang

Perubahan pada MongoDB 3.6.1:

• Menghapus opsi query snapshot.

  • Mesin penyimpanan MMAPv1: Gunakan hint({ _id: 1 }) sebagai gantinya untuk memastikan bahwa dokumen tidak dikembalikan beberapa kali selama query meskipun penulisan perantara menyebabkan dokumen dipindahkan.

  • Mesin penyimpanan lainnya (seperti WiredTiger): Gunakan hint({ $natural: 1 }) sebagai gantinya.

• Menghapus operator $isolated.

  • Alternatif: Gunakan transaksi atau sesuaikan tingkat read concern untuk mencapai isolasi.