:MongoDB 4.0 の互換性の変更

MongoDB の公式の互換性変更ドキュメントを表示するには、[従来のドキュメント]にアクセスしてください。

MONGODB-CR の廃止

MongoDB 4.0 以降、MongoDB は廃止された MONGODB-CR 認証モードをサポートしなくなりました。

MongoDB 3.0 以降、デプロイメントが V2.6 以前からアップグレードされたもので、元の MONGODB-CR ユーザーの認証モードをアップグレードしていない場合を除き、MONGODB-CR ユーザーを作成できなくなりました。

デプロイメントでユーザー資格情報の保存に MONGODB-CR モードを使用している場合は、デプロイメントを MongoDB 4.0 にアップグレードする前に、モードを Salted Challenge Response Authentication Mechanism (SCRAM) にアップグレードする必要があります。

MMAPv1 の廃止

MongoDB 4.0 以降、MongoDB は MMAPv1 ストレージエンジンを廃止します。インスタンスを WiredTiger ストレージエンジンに移行する必要があります。

X.509 認証証明書の制限

MongoDB 4.0 以降、x.509 認証を使用する際に --sslAllowInvalidCertificates または net.ssl.allowInvalidCertificates: true（MongoDB 4.2 では --tlsAllowInvalidateCertificates または net.tls.allowInvalidCertificates: true に名前変更）を指定した場合、無効な証明書は TLS/SSL 接続を確立するには十分ですが、認証には不十分です。

この問題を解決するには、無効な証明書を有効な証明書（信頼できる CA によって署名されたものなど）に更新するか、net.ssl.CAFile を使用してカスタム CA を指定します。

レプリカセットインスタンス

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

シャードクラスターインスタンス

mongos は、シャードクラスターメタデータに影響を与える以下の操作で "majority" 書き込みコンサーンレベルを使用します。

MongoDB 4.0 の機能互換性

MongoDB 4.0 の一部の機能では、V4.0 バイナリファイルと featureCompatibilityVersion を 4.0 に設定する必要があります。以下の機能が含まれます。

• SCRAM-SHA-256

• 新しい型変換演算子（$toBool や $toInt など）と機能強化

• 複数ドキュメントトランザクション

• $dateToString オプションの変更

• 新しい変更ストリームメソッド

• 変更ストリーム再開トークンのデータ型の変更

その他の変更

• シャードクラスターインスタンスは、地理空間クエリ演算子 $near および $nearSphere をサポートしています。

• create コマンドと mongo シェルメソッド db.createCollection() では、local データベース以外のデータベースにコレクションを作成する場合、autoIndexId オプションを false に設定することはできません。

• 認証を有効にして、listDatabases 操作権限なしで listDatabases コマンドを実行すると、MongoDB は find 操作権限を持つすべてのデータベースのリストを返します。MongoDB 4.0 より前は、listDatabases 操作権限なしでコマンドを実行すると、MongoDB は Unauthorized を返していました。

• taskExecutorPoolSize のデフォルト値が 0 から 1 に変更されました。Linux では、V4.0 デプロイメントの以前の動作に戻すには、taskExecutorPoolSize を 0 に、AsyncRequestsSenderUseBaton を false に設定します。

• MongoDB 4.0 では、mongod インスタンスと mongos インスタンスに対して transportLayer と net.transportLayer を legacy に設定することはできません。transportLayer はデフォルトで asio に設定されており、変更できません。

• MongoDB 4.0 以降、reIndex コマンドとその db.collection.reIndex() はグローバル排他ロックを取得し、完了するまで他の操作をブロックします。

• year、isoYear、timezone 以外のフィールドの値が有効な範囲を超えている場合、$dateFromParts は他の日付部分との差を減算して日付を計算します。MongoDB 4.0 より前は、有効な範囲を超える値はエラーを引き起こしていました。

• killCursors 操作の動作が変更されました。MongoDB 4.0 より前は、カーソル ID を取得すると、任意のカーソルを強制終了できました。MongoDB 4.0 以降、killCursors を使用すると、既存のカーソルを強制終了できます。カーソルを強制終了する権限がない場合、killCursors はエラーを返します。

• MongoDB 4.0 は、指定されたコレクションの任意のカーソルを強制終了する権限を付与する killAnyCursor 操作を追加しました。

• MongoDB 4.0 以降、mongos インスタンスをより高い機能互換性バージョン (fCV) を持つ別のインスタンスに接続しようとすると、mongos インスタンスがクラッシュする可能性があります。たとえば、MongoDB 4.0 の mongos インスタンスは、fCV が 4.2 に設定されているシャードクラスターインスタンスに接続できません。ただし、シャードクラスターインスタンスの fCV が 4.0 のままの場合は、mongos インスタンスは通常どおり別のインスタンスに接続できます。

• MongoDB 4.0 以降、MongoDB は 127.0.0.1 と想定するのではなく、指定された設定に基づいて localhost IP アドレスを解決します。

無効化された TLS 1.0

MongoDB バイナリファイル (mongod、mongos、mongo) は、TLS 1.1+ をサポートするシステムでは、デフォルトで TLS 1.0 暗号化を無効にします。

TLS 1.0 を強制的に有効にするには、次の手順を実行します。

• mongod インスタンスの場合は、構成ファイルで net.ssl.disabledProtocols: none を指定するか、コマンドラインパラメーター --sslDisabledProtocols none を使用します。

• mongos インスタンスの場合は、net.ssl.disabledProtocols: none または --sslDisabledProtocols none を使用します。

• mongo シェルの場合は、--sslDisabledProtocols none パラメーターを追加します。

  --sslDisabledProtocols パラメーターは、次の mongo シェルバージョンで使用できます。

  • MongoDB 4.0+

  • MongoDB 3.6.5+

  • MongoDB 3.4.15+

macOS で、MongoDB 3.6.4 以前の mongo シェルを使用して MongoDB 4.0+ のシャードクラスターインスタンスに接続する場合は、TLS 1.0 を明示的に有効にする必要があります。

Mongo シェル

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

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

バイナリファイルと廃止されたフィールドまたはコマンドの削除

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