与旧版 mongo Shell 的兼容性更改

已弃用的方法

mongosh 中已弃用以下 Shell 方法。请改用 Alternative Resources 列中列出的方法。

读取偏好行为

写入偏好行为

mongoshmongo默认下，在 中启用可重试写入。在旧版 Shell中，可重试写入默认处于禁用默认。要禁用可重试写入，请使用--retryWrites=false 。

对象标识符（ObjectId）方法和属性

这些 ObjectId() 方法在mongosh 中的工作方式与在旧版mongo Shell中的工作方式不同。

Numeric Values

默认情况下，传统 mongo Shell 将数值存储为 doubles。在 mongosh 中，数字存储为 32 位整数 Int32，或者如果该值无法存储为 Int32，则存储为 Double。

MongoDB Shell 继续支持 mongo Shell 所支持的数字类型。但偏好类型已更新，以便更好地与 MongoDB 驱动程序保持一致。有关更多信息，请参阅 Mongosh 数据类型。

MongoDB Shell 中数字变量的首选类型与旧版 mongo shell 中建议的类型不同。mongosh 中的类型更好地契合 MongoDB 驱动程序使用的类型。

未定义的值

未定义的BSON类型已弃用。如果您尝试插入在 中具有未定义 JSmongosh 类型的文档，您的部署会将文档中的未定义值替换为BSON null 值。不支持使用mongosh 将未定义的值插入数据库。

示例，考虑运行以下代码以在 mongosh 中插入文档：

db.people.insertOne( { name : "Sally", age : undefined } )

当您在 mongosh 中运行此代码时， Shell会插入以下文档：

{ name : "Sally", age : null }

mongosh 表示使用其他工具（例如Go驱动程序或传统 mongoShell）存储为 null 的任何BSON未定义值。

对象引用行为

mongosh 在输出中不给对象键加引号，而是给值加单引号。要重现传统 mongo Shell 的输出（此 Shell 将键和字符串值都用双引号括起来），请使用带有 EJSON.stringify() 的 mongosh --eval。

例如，以下命令会返回test数据库的sales集合中的项目，并带有双引号和缩进：

mongosh --eval "EJSON.stringify(db.sales.findOne().toArray(), null, 2)"

输出如下所示：

{
     "_id": {
          "$oid": "64da90c1175f5091debcab26"
     },
     "custId": 345,
     "purchaseDate": {
          "$date": "2023-07-04T00:00:00Z"
     },
     "quantity": 4,
     "cost": {
          "$numberDecimal": "100.60"
     }
}

数据库调用限制

数据库查询的结果不能在以下上下文中传递：

• 类构造函数

• 非异步生成器函数

• 回调数组上的 .sort()

• 类中的 JavaScript setter

要访问权限数据库调用的结果，请使用异步函数、异步生成器函数或.map() 。

构造函数

以下构造函数不起作用：

// This code will fail
class FindResults {
   constructor() {
      this.value = db.students.find();
   }
}
// This code will fail
function listEntries() { return db.students.find(); }
class FindResults {
   constructor() {
      this.value = listEntries();
   }
}

改用 async 函数：

class FindResults {
   constructor() {
      this.value = ( async() => {
         return db.students.find();
      } )();
   }
}

class FindResults {
   constructor() { }
   init() { this.value = db.students.find(); }
 }

生成器函数

以下生成器函数不起作用：

// This code will fail
function* FindResults() {
   yield db.students.findOne();
}
// This code will fail
function listEntries() { return db.students.findOne(); }
function* findResults() {
   yield listEntries();
}

改用 async generator function：

function listEntries() { return db.students.findOne(); }
async function* findResults() {
   yield listEntries();
}

数组排序

以下数组排序不起作用：

// This code will fail
db.getCollectionNames().sort( ( collectionOne, collectionTwo ) => {
  return db[ collectionOne ].estimatedDocumentCount() - db[ collectionOne ].estimatedDocumentCount() )
} );

改用 .map()。

db.getCollectionNames().map( collectionName => {
   return { collectionName, size: db[ collectionName ].estimatedDocumentCount() };
} ).sort( ( collectionOne, collectionTwo ) => {
   return collectionOne.size - collectionTwo.size;
} ).map( collection => collection.collectionName);

这种数组排序方法通常比不支持的等效代码性能更高。

JavaScript Setter

以下 JavaScript setter 不起作用：

// This code will fail
class TestClass {
  value = 1;
  get property() {
    return this.value;
  }
  // does not work:
  set property(value) {
    this.value = db.test.findOne({ value });
  }
}

命令异常

对于输出包含 { ok: 0 } 的命令，mongosh 会返回一致异常并忽略服务器原始输出。旧版 mongo shell 会根据每条命令返回不同的输出。

有关详细信息，请参阅运行命令。

shell配置

旧版 mongo shell使用名为 .mongorc.js 的配置文件。

如果mongosh在初创企业时找到.mongorc.js ，但没有找到.mongoshrc.js ，则mongosh不会加载旧版.mongorc.js文件，并指示您应将.mongorc.js重命名为.mongoshrc.js 。

有关详细信息，请参阅.mongoshrc配置文件。

数据类型

MongoDB使用BSON存储数据，这支持JSON中不提供的其他数据类型。与传统的 mongoshmongoShell相比， Shell为驱动程序提供了更好的数据类型支持。

有关详细信息，请参阅数据类型。

方法

旧版 mongo shell无法访问权限load() 方法中脚本的文件名或目录。

有关详细信息，请参阅load()。

可重试写入 (Retryable Writes)

默认情况下，可重试写入为：

• 已启用 mongosh

• 在旧版 mongo shell 中禁用

要禁用可重试写入，请使用--retryWrites=false 。

有关详细信息，请参阅--retryWrites。

传统输出

mongosh shell返回的输出与旧版 mongo shell不同。 如果您的脚本要求输出格式与传统 mongo shell类似，请尝试使用EJSON.stringify() 重新格式化 mongosh 输出。

有关详细信息，请参阅 jsononeline() 的传统。

代码片段

对于旧版 mongo shell ，代码片段的使用方式有所不同。

有关详细信息，请参阅获取代码段的帮助。