:MongoDB 3.6 の互換性の変更

$type: "array" の動作の変更

MongoDB 3.6 以降、type: "array" 式と $type: 4 式は、任意の要素タイプを含む配列フィールドと一致します。

MongoDB 3.6 より前では、$type: "array" は、ネストされた配列を含む配列フィールドとのみ一致します。

たとえば、c という名前のコレクションに次のドキュメントが含まれているとします。

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

次の操作は、フィールド a のタイプによってデータをクエリします。

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

MongoDB 3.6 以降、$type クエリはコレクション内の 2 つのドキュメントを返します。これは、クエリがフィールド a が配列であることを検出するようになったためです。

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

MongoDB 3.4 より前では、$type クエリは、フィールド a に BSON 配列タイプの要素が含まれるドキュメントのみを返します。

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

現在のインスタンスで MongoDB 3.4.x を実行していて、partialFilterExpression に $type: "array" または $type: 4 が含まれる部分インデックスを使用している場合は、MongoDB 3.6 にアップグレードした後にこれらのインデックスを再構築する必要があります。これにより、$type: 'array' のセマンティックな変更による競合を回避できます。

配列ソート動作の変更

MongoDB 3.6 以降、配列フィールドでソートする場合、MongoDB は昇順ソートキーに最小値の配列要素を、降順ソートキーに最大値の配列要素を使用します。ソートは、ソートキーとして配列要素を選択するときに、クエリ述語を考慮しなくなりました。この動作の変更は、find コマンドと集約パイプライン操作に適用されます。

その結果、配列フィールドでソートするアプリケーションは、異なるソート結果を返す可能性があります。

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

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

// ドキュメント。
{ "_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") ] }

// クエリ。
db.c.aggregate([{$sort: {timestamps: -1}}])

// ドキュメント。
{_id: 0, a: [3, 1, 5]}
{_id: 1, a: [3, 4, 0]}

// クエリ。
db.coll.aggregate([{$sort: {a: 1}}])

新しいフィールドの更新

MongoDB 3.6 以降、更新操作中に追加されたフィールドは、辞書式順序で追加されます。

たとえば、coll という名前のコレクションに次のドキュメントが含まれているとします。

{ _id: 0, x: 0 }

更新操作を実行して、次のフィールドを追加します。

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

MongoDB 3.6 では、新しいフィールドは辞書式順序で追加されます。したがって、更新されたドキュメントは {_id: 0, x: 0, a: 0, b: 0} です。

MongoDB 3.6 より前では、新しいフィールドは更新ドキュメントでの出現順に追加されます。したがって、更新されたドキュメントは {_id: 0, x: 0, b: 0, a: 0} です。

arrayFilters 識別子構文と競合するフィールド

MongoDB 3.6 以降、arrayFilters 識別子構文（$[] など）と競合する名前のフィールドは更新できなくなりました。

たとえば、coll という名前のコレクションに次のドキュメントが含まれているとします。

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

更新操作を実行します。

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

MongoDB 3.6 以降、更新操作は成功します。MongoDB 3.6 では、フィールド名 $[] が arrayFilters 識別子構文と競合するため、更新操作は失敗します。

$pop 演算子のより厳密な検証

MongoDB 3.6 以降、$pop 演算子のパラメーターは、次のいずれかの値に設定する必要があります。

• -1：配列の最初の要素を削除します。

• 1：配列の最後の要素を削除します。

MongoDB 3.6 より前：

• 負の数：配列の最初の要素を削除します。

• 負でない数または数値以外の値：配列の最後の要素を削除します。

$pushAll 演算子の削除

MongoDB 3.6 では、$pushAll 演算子（MongoDB 2.4 以降非推奨）が削除されています。

代わりに、$push 演算子と $each 演算子を使用してください。例：

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

MONGODB-CR 認証メカニズムの非推奨化

MongoDB 3.6 以降のバージョンでは、MONGODB-CR 認証メカニズムは非推奨です。まだ行っていない場合は、MONGODB-CR 認証スキーマを SCRAM にアップグレードしてください。

アービターノードとその優先順位

すべてのアービターノードの優先順位は 0 に固定されています。

マスタースレーブレプリケーションアーキテクチャの非推奨化

MongoDB 3.6 は、マスタースレーブレプリケーションアーキテクチャを正式に非推奨とします。

WiredTiger ストレージエンジンでの --nojournal オプションの非推奨化

MongoDB 3.6 は、WiredTiger ストレージエンジンを使用するレプリカセットメンバーの --nojournal オプションを非推奨とします。これにより、データリスクを回避できます。

aggregate コマンドとその出力の調整

MongoDB 3.6 以降、aggregate コマンドは単一のドキュメントとして結果を返さなくなりました。

aggregate コマンドを実行するときは、次のいずれかのオプションを指定する必要があります。

• cursor：結果をカーソルとして返します（大規模なデータセットに適しています）。

• explain：集約パイプラインの実行計画の分析を返します。

mongo シェルで db.collection.aggregate() を使用するか、ドライバーで同等のメソッドを使用することをお勧めします。explain オプションが使用されていない限り、これらのメソッドはデフォルトでカーソルを返します。

集約式の日付フィールドから文字列への変換の変更

MongoDB 3.6 以降、MongoDB は、集約式で日付をミリ秒精度を含み、文字 'Z'（UTC タイムゾーンを示す）で終わる文字列に強制的に変換します。

例：

// ドキュメント。
{_id: 0, d: ISODate("2017-10-18T20:04:27.978Z")}
{_id: 1, d: ISODate("2017-10-18T20:04:28.192Z")}

// クエリ。
db.coll.aggregate({$project: {d: {$toLower: "$d"}}})

MongoDB 3.6 より前では、2 つのドキュメントのデータフィールドは、"2017-10-18t20:04:27" および "2017-10-18t20:04:28" 形式の文字列として返されます。

MongoDB 3.6 以降、2 つのドキュメントのデータフィールドは、"2017-10-18t20:04:27.978z" および "2017-10-18t20:04:28.192z" 形式（ミリ秒と小文字の 'z' を含む）の文字列として返されます。

この変更は、次の集約演算子に適用されます。

• $concat

• $substr

• $substrBytes

• $substrCP

• $strcasecmp

• $toLower

• $toUpper

ログ診断コマンドとオプションの削除

MongoDB 3.6 は、非推奨の diagLogging と mongod --diaglog オプションを削除します。

代わりに、mongoreplay ツールを使用して、MongoDB デプロイメントに送信されたコマンドをキャプチャ、再生、および分析します。

validate 操作の変更

MongoDB 3.6 以降、validate 操作は、ディスクデータの検証を実行する前にのみ、チェックポイントを強制的にトリガーし、すべてのインメモリデータをディスクにフラッシュします。

MongoDB 3.6 より前では、使用される検証モードに関係なく、チェックポイントが強制的にトリガーされます。

validate コマンドまたは db.collection.validate() メソッドを使用する場合は、完全な検証を実行するために {full: true} を明示的に指定します。

インデックス名の制限

MongoDB 3.6 以降：

• インデックスの作成中に、インデックス名として * を指定することはできません。

• * という名前のインデックスを削除するためにインデックスキーを使用することはできません。代わりに、インデックス名 * を使用してインデックスを削除します。

MongoDB 3.6 にアップグレードする前に、次のことを行う必要があります。

• インデックスの削除：* という名前の既存のインデックスをすべて手動で削除します。

• インデックスの名前変更：インデックスを保持するには、インデックスを削除し、新しい名前で再構築します。

非推奨のオプション

MongoDB 3.6.1 の変更点：

• snapshot クエリオプションが非推奨になりました。

  • MMAPv1 ストレージエンジン：代わりに hint({ _id: 1 }) を使用して、中間書き込みによってドキュメントが移動された場合でも、クエリ中にドキュメントが複数回返されないようにします。

  • その他のストレージエンジン（WiredTiger など）：代わりに hint({ $natural: 1 }) を使用します。

• $isolated 演算子が非推奨になりました。

  • 代替：トランザクションを使用するか、読み取りコンサーンレベルを調整して分離を実現します。