：MongoDB 4.0相容性更新說明

如需查看MongoDB官網相容性更新說明文檔，請前往MongoDB官網下載。

移除對MONGODB-CR的支援

從4.0版本開始，MongoDB將不再支援已棄用的MongoDB身分識別驗證機制（MONGODB-CR）。

自3.0版本起，MongoDB不支援建立MONGODB-CR使用者，除非部署是從2.6或更早版本升級而來，且原有MONGODB-CR使用者未升級認證模式。

若您的部署仍使用MONGODB-CR模式儲存使用者憑證，在升級到4.0前必須升級至SCRAM（Salted Challenge Response Authentication Mechanism）。

棄用MMAPv1

自4.0版本起，MongoDB棄用MMAPv1儲存引擎。若需遷移至WiredTiger儲存引擎。

x.509 認證認證限制

從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"Write Concern。

4.0功能相容性

4.0版本中的一些功能不僅需要4.0的二進位檔案，還需要將featureCompatibilityVersion設定為4.0。這些功能包括：

• SCRAM-SHA-256

• 新的類型轉換運算子（如$toBool、$toInt等）和增強功能

• 多文檔事務

• $dateToString選項更改

• 新的變更流方法

• 更改流恢複令牌資料類型更改

其他變更

• 分區叢集現支援地理空間查詢運算子$near和 $nearSphere。

• 對於create命令以及mongo shell的db.createCollection()方法，在local資料庫以外的資料庫中建立集合時，不能將選項autoIndexId設定為false。

• 啟用身分識別驗證後，在沒有listDatabases操作許可權的情況下運行listDatabases命令，系統將返回運行該命令的使用者具有find操作許可權的所有資料庫的列表。在之前的版本中，在沒有listDatabases操作許可權的情況下運行命令會返回Unauthorized。

• 將taskExecutorPoolSize的預設值從0更改為1。在Linux上，若要還原4.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將從其他日期部分中減去差值以計算日期。在以前的版本中，超出範圍的值會導致錯誤。

• 修改了killCursors許可權操作的行為。在MongoDB 4.0之前，如果使用者知道進程的ID，他們可以殺死任何進程。從MongoDB 4.0起，killCursors允許使用者殺死與當前身分識別驗證的使用者關聯的任何進程。如果使用者沒有終止進程的許可權，killCursors將返回錯誤。

• MongoDB 4.0添加了一個killAnyCursor許可權操作，該操作授予使用者終止指定集合的任何遊標的許可權。

• 從MongoDB 4.0版本開始，當mongos可執行檔嘗試串連到功能相容性版本（fCV）高於自身版本的mongod執行個體時，該mongos進程將會崩潰。例如，MongoDB 4.0版本的mongos無法串連到將fCV設定為4.2的4.2分區叢集。不過，若該4.2分區叢集的fCV仍保持在4.0，則MongoDB 4.0版本的mongos可以正常串連。

• 從4.0版本開始，MongoDB按配置解析localhostIP地址，而不是假設為127.0.0.1。

禁用TLS 1.0

MongoDB 二進位檔案（mongod、mongos 和 mongo）在支援TLS 1.1+ 的系統上會預設禁用TLS 1.0加密支援。

若需強制啟用TLS 1.0支援：

• mongod 執行個體：在設定檔中設定 net.ssl.disabledProtocols: none，或通過命令列參數 --sslDisabledProtocols none 實現。

• mongos 執行個體：配置方式與 mongod 相同，使用 net.ssl.disabledProtocols: none 或 --sslDisabledProtocols none。

• mongo Shell：需添加 --sslDisabledProtocols none 參數。

  --sslDisabledProtocols 參數可以在以下mongo Shell版本中使用：

  • MongoDB 4.0+

  • MongoDB 3.6.5+

  • MongoDB 3.4.15+

macOS 系統中，若使用 3.6.4 或更早版本的 mongo Shell 串連 MongoDB 4.0+ 叢集，必須顯式啟用 TLS 1.0。

mongo Shell

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.*'