对于 AI 代理：可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单
Docs 主页
/
工具
/
MongoDB Shell
Docs 主页
/
工具
/
MongoDB Shell
Docs 主页
/
工具
/
MongoDB Shell

版本说明

v 2.12.0

9 月发布18 、 2026

特点：

缺陷修复：

  • MONGOSH-3680 — 将此会话日志文件计入日志保留限制

JIRA 上提供了完整发布说明。

v 2.11.1

9 月发布15 、 2026

缺陷修复：

JIRA 上提供了完整发布说明。

v 2.10.0

8 月发布13 、 2026

此版本发布的新功能：

  • MONGOSH-3438 — 将 mongosh 工件发布到MongoDB 9.0服务器PPA。

  • MONGOSH-1681 — 为ppc64le 和 架构添加共享 OpenSSLs390x 二进制文件。

  • MONGOSH-2501 - 添加sh.shardDrainingStatus() 和sh.getTransitionToDedicatedConfigServerStatus() 。

  • MONGOSH-2500 —sh.listShards() 在 中添加对过滤参数的支持。

  • MONGOSH-3403 - 删除对预览文本、后缀和子字符串 Queryable Encryption API 的支持。

  • MONGOSH-3244 - 增加了对MongoDB 8 的自动完成支持。3arrayIndexAs 选项和 $$IDX 变量。

缺陷修复：

  • MONGOSH-1141 - 修复 enableTelemetry 设置，以在设置 forceDisableTelemetry 时返回 false。

  • MONGOSH-1781 -ISODate 修复了日期在MongoDB Compass上的嵌入式Shell中不显示为 的问题。

JIRA 上提供了完整发布说明。

v 2.9.2

7 月发布1 、 2026

注意

版本 2.9.0 和版本 2.9.1 被跳过，以解决 npm 和 Homebrew 发布的问题。

此版本发布的新功能：

缺陷修复：

  • MONGOSH-3421 - 修复ObjectId 未跨 Node.js初创企业快照生成唯一值的问题。

  • COMPASS-10637 — 修复未显示在MongoDB Compass上的嵌入式Shell中的错误违规。

JIRA 上提供了完整发布说明。

v 2.8.3

2026 年 5 月 1 日发布

缺陷修复：

  • MONGOSH-3332 - 发送 OS 信息在更新通知请求中。

  • COMPASS-6714 — 修复了MongoDB Compass上的嵌入式Shell中对长数字和其他非整数的错误处理。

  • MONGOSH-3298 — 将中断器依赖项更新到版本2 以支持Electron41 。

JIRA 上提供了完整发布说明。

v 2.8.2

3 月发布26 、 2026

此版本发布的新功能：

  • 采用 Node.js 24.14.1安全发布并更新第三方软件包。

缺陷修复：

  • MONGOSH-2485 - 改进 homebrew 安装依赖项的方式。

JIRA 上提供了完整发布说明。

v 2.8.1

3 月发布16 、 2026

此版本发布的新功能：

  • 新增对Debian 13 和 RHEL 10 的支持。

  • 默认启用新自动完成程序的功能标志。要禁用此功能，请将 USE_NEW_AUTOCOMPLETE 环境变量设立为 0。

缺陷修复：

JIRA 上提供了完整发布说明。

v 2.7.0

2 月发布13 、 2026

  • 将嵌入式 Node.js 运行时升级到版本24.13.1 ，并将 Node.js驾驶员升级到版本.. 710mongosh26。此更改向后兼容..0 ，因此现有脚本和自动化将继续像以前一样工作。

  • 在 x86_64 和 arm64 平台上添加对 RHEL 10 和 Debian 13 的官方支持。

此版本发布的新功能：

JIRA 上提供了完整发布说明。

v 2.6.0

1 月发布13 、 2026

重要

此发布修复了安全问题。尽早升级到 mongosh 2.6.0。

此版本发布的新功能：

  • MONGOSH-1285 -mongosh 现在可以全面打印服务器响应，包括从服务器返回的未经任何校订的文档。

  • MONGOSH-2486 — 引入新的助手来创建BSON二进制子类型3 对象，特别是针对已弃用格式的 UUID。添加的助手包括LegacyJavaUUID() 、LegacyCSharpUUID() 和LegacyPythonUUID() 。

  • MONGOSH-2687 - Linux和 macOS 用户现在可以通过mongosh download_latest.sh脚本安装 。

JIRA 上提供了完整发布说明。

v 2.5.10

2025 年 11 月 28 日发布

此版本发布的新功能：

  • STREAMS-1136 - 增加了深入分析流处理器属性的能力。

缺陷修复：

  • 修复了在字符串中间粘贴文本的问题。

  • MONGOSH-2991 — 修复特殊字符的日志记录凭证校订问题。

JIRA 上提供了完整发布说明。

v 2.5.9

10 月发布30 、 2025

此版本发布的新功能：

缺陷修复：

  • 修复了 OIDC 相关问题。

  • 包括对 buildInfo()、日志记录等方面的改进。

JIRA 上提供了完整发布说明。

v 2.5.8

9 月发布9 、 2025

mongosh 现在使用以下驱动程序版本：

此版本发布的新功能：

  • MONGOSH-2514 - 启用公开预览支持 Queryable Encryption 前缀/后缀/子字符串搜索。

缺陷修复：

  • MONGOSH-2635 - 修复了使用Node.js 版本20 ^..19 、^..5 22180或24 3^..0 mongosh，其中 中的标签页自动完成功能可能会执行代码，包括可能具有破坏性的操作。

  • 修复了阻止在日志中捕获来自 OIDC身份验证流的HTTP跟踪和其他调试信息的问题。

JIRA 上提供了完整发布说明。

v 2.5.7

8 月发布29 、 2025

mongosh 现在使用以下版本作为依赖项：

JIRA 上提供了完整发布说明。

v 2.5.6

7 月发布18 、 2025

重要

此发布修复了安全问题。尽早升级到 mongosh 2.5.6。

此版本发布的新功能：

  • MONGOSH-1680 - 添加对9 ppc64le和s390x 发行版的 RHEL 支持。

  • MONGOSH-2370 — 添加disableSchemaSampling=true 以禁用自动完成的模式采样。

  • MONGOSH-2371 — 添加skipStartupWarnings 标志以按需跳过警告。

  • 新的自动完成器（带功能标记）- 通过设置环境变量 USE_NEW_AUTOCOMPLETE=true 来启用它。尝试一下并股票您的反馈！

JIRA 上提供了完整发布说明。

v 2.5.5

7 月发布3 、 2025

缺陷修复：

  • MONGOSH-2233 - 在 homebrew 上的多行输入导致 mongosh 挂起

JIRA 上提供了完整发布说明。

v 2.5.3

6 月发布18 、 2025

此版本发布的新功能：

  • MONGOSH-1493 — 将.finish() 方法添加到ExplainableCursor。

  • MONGOSH-1996 — 添加collection.getShardLocation 辅助方法。

JIRA 上提供了完整发布说明。

v 2.5.2

2025 年 5 月 14 日发布

重要

此发布修复了安全问题。尽早升级到 mongosh 2.5.2。

JIRA 上提供了完整发布说明。

v 2.5.1

2025 年 5 月 7 日发布

mongosh 现在使用以下驱动程序版本：

缺陷修复：

  • MONGOSH-2153 Binary.fromPackedBits— 向 添加了填充信息。

JIRA 上提供了完整发布说明。

v 2.5.0

发布日期：2025 年 4 月 9 日

此版本发布的新功能：

JIRA 上提供了完整发布说明。

v 2.4.2

3 月发布6 、 2025

该版本发布的新功能：

JIRA 上提供了完整发布说明。

v2.4.0

2 月发布24 、 2025

mongosh 现在使用以下驱动程序版本：

此版本发布的新功能：

  • MONGOSH-2013 - 添加了history() 命令，该命令会返回之前运行的所有命令的大量。

  • MONGOSH-1090 — 添加了log.getPath() 命令，该命令可返回当前活动日志文件的路径。

  • MONGOSH-1995 - 添加了日志记录命令的帮助输出。

  • 新增以下日志记录配置选项，您可以直接在配置文件中设立这些选项，也可以调用配置API来设置这些选项。

    • MONGOSH-1988 — 通过设置disableLogging: true 禁用日志记录。

    • MONGOSH-1983 、MONGOSH-2012 — 通过设置logLocation 指定日志文件的自定义路径。

    • MONGOSH-1986 — 通过设置logCompressionEnabled: true 来压缩日志文件。

    • MONGOSH-1984 — 通过设置logRetentionDays （默认30 ）限制日志文件的保留天数。

    • MONGOSH-1985 — 通过设置logRetentionGB 限制日志目录的最大大小（默认无大小）。

    • MONGOSH-1987 — 通过设置logMaxFileCount （默认100 ）来限制日志文件的最大数量。

缺陷修复：

  • MONGOSH-1914 — 修复多个mongosh 进程可能会同时尝试删除过时的日志文件，从而导致一个进程以Error: ENOENT: no such file or directory 终止的问题。

  • MONGOSH-2002 — 改进尝试序列化游标时的错误消息。

JIRA 上提供了完整发布说明。

v 2.3.9

2 月发布5 、 2025

重要

此发布修复了安全问题。尽早升级到 mongosh 2.3.9。

此版本发布的新功能：

  • MONGOSH-1989 - 添加了通过调用 在脚本中日志自定义消息的能力log.[debug|info|warn|error|fatal]()

JIRA 上提供了完整发布说明。

v 2.3.8

1 月发布6 、 2025

包含内部增强和改进。

JIRA 上提供了完整发布说明。

v 2.3.7

发布日期：2024 年 12 月 17 日

缺陷修复：

  • MONGOSH-1943 — 修复罕见的片状“Mongosh 未初始化”问题的原因。错误

JIRA 上提供了完整发布说明。

v 2.3.6

发布日期：2024 年 12 月 13 日

包含内部增强和改进。

JIRA 上提供了完整发布说明。

v 2.3.5

发布日期：2024 年 12 月 12 日

缺陷修复：

  • MONGOSH-1935 — 出现 TLS 错误时在没有系统证书的情况下重试连接

  • MONGOSH-1632 — 为 OpenSSL Windows构建修复添加 Node.js 补丁

JIRA 上提供了完整发布说明。

v 2.3.4

2024 年 11 月 27 日发布

此版本发布的新功能：

  • MONGOSH-1920 — 为流处理器启动、停止和删除命令添加选项对象

  • MONGOSH-1864 - 添加流处理器修改命令

缺陷修复：

  • MONGOSH-1917、MONGOSH-1905 —默认在 OIDC 请求中包含 nonce。如果 IdP 不支持，请使用 --oidcNoNonce 选项禁止此行为。

  • MONGOSH-1895 - 抑制 Node.js 23 的实验性警告

JIRA 上提供了完整发布说明。

v 2.3.3

10 月发布30 、 2024

此版本发布的新功能：

缺陷修复：

JIRA 上提供了完整发布说明。

v 2.3.2

10 月发布8 、 2024

包含内部增强和改进。

  • 修复了v2.3.1中引入的初创企业性能回归。

JIRA 上提供了完整发布说明。

v 2.3.1

9 月发布5 、 2024

此版本包含的错误修复：

  • COMPASS-8252 - 从 TLS CA 列表中删除没有颁发者的证书

  • MONGOSH-1859 -ISODate() 现在可将非字符串参数传递给new Date()

JIRA 上提供了完整发布说明。

v 2.3.0

8 月发布16 、 2024

此版本发布的新功能：

  • MONGOSH-1550 - 添加对Queryable Encryption Range 查询的支持，并删除对 Range Preview 版本的支持。删除已弃用的Linux操作系统上对自动加密即用支持。

  • MONGOSH-1827 — 在环境变量中添加对代理的配置支持

  • MONGOSH-1852 ---tlsUseSystemCA 默认启用

  • MONGOSH-1845 — 添加调试标志，用于将 OIDC 令牌转储到输出

此版本包含的错误修复：

  • MONGOSH-1136 - mongosh应使用 stderr 进行密码提示

  • MONGOSH-1425 — 将 的回退条件扩展为命令形式，以考虑$collStats ADF

  • MONGOSH-1820 -fields 选项未在 findAndModify 中按预期运行

JIRA 上提供了完整发布说明。

v 2.2.15

7 月发布30 、 2024

此版本中的新功能：

  • MONGOSH-1848 - 为shardMoveCollection 和unshardCollection 命令添加了助手。

此版本包含的错误修复：

  • MONGOSH-1327 -sh.status() 现在仅在详细模式下显示标签范围的完整列表。

  • MONGOSH-1837 - 指定的 ReadPreference 选项现在应用于管理命令。

  • MONGOSH-1392 —mongodb-redact 依赖库已更新到版本1.1.2 。此更改应有助于缩短大型基数mongosh 64输入数据的 处理时间。

JIRA 上提供了完整发布说明。

v 2.2.12

7 月发布11 、 2024

包含内部增强和改进。

JIRA 上提供了完整发布说明。

v 2.2.11

7 月发布09 、 2024

包含内部增强和改进。

修复了导致用户无法将选项传递给explain.find()方法的错误：

JIRA 上提供了完整发布说明。

v 2.2.10

6 月发布24 、 2024

包含内部增强和改进。

JIRA 上提供了完整发布说明。

v 2.2.9

6 月发布14 、 2024

v 2.2.6

2024 年 5 月 15 日发布

mongosh 现在使用6.6.2版本的Node.js 驱动程序。

JIRA 上提供了完整发布说明。

v 2.2.5

发布日期：2024 年 4 月 22 日

性能改进：

  • MONGOSH-1759 –mongosh 通过在盒装节点中禁用初创企业快照压缩，将 初创企业时间缩短约40 %。

  • MONGOSH-1765 –mongosh 现在在非交互式模式下初创企业期间跳过等待服务器命令结果的过程。

JIRA 上提供了完整发布说明。

v 2.2.4

发布日期：2024 年 4 月 15 日

升级到 Node.js 版本20.12.2 。节点20.12.2 解决了安全问题。漏洞不太可能影响典型的mongosh 用户。有关更多信息，请参阅 410 月的 ，2024 Node.js 安全发布。

JIRA 上提供了完整发布说明。

v 2.2.3

发布日期：2024 年 4 月 4 日

修复的问题：

  • MONGOSH-1752 - 将 Node.js20 版本更新到..12 12012。节点..1 解决了安全问题。漏洞不太可能影响典型的mongosh 用户。有关更多信息，请参阅 43 月发布的2024 Node.js 安全版本。

  • MONGOSH-1682 - 修复了可能导致包括敏感信息在内的命令无法从历史文件中正确删除的竞争条件。

  • MONGOSH-1688 - 将游标迭代性能提高约60 %。

  • MONGOSH-1751 - 通过解决更新通知管理器中的错误，提高了编程使用的初创企业性能。

JIRA 上提供了完整发布说明。

v 2.2.2

3 月发布26 、 2024

修复了使用 OIDC 劳动力身份验证的连接导致出错的错误：

  • MONGOSH-1743 — 使用 JS 代理转发“延迟加载” webpack 函数会导出。

JIRA 上提供了完整发布说明。

v 2.2.1

3 月发布19 、 2024

修复了 2.2.0 中的错误其中 require('<module>') 在脚本模式下导致错误：

JIRA 上提供了完整发布说明。

v 2.2.0

3 月发布11 、 2024

警告

此版本受到 bug 的影响，已在 2.2.1 中修复，即 require('<module>') 在脚本模式下会导致错误。

性能改进：

  • MONGOSH-1605 –mongosh 再次使用 Node.js初创企业快照来提高初始化性能。

  • MONGOSH-1721 – mongosh 现在在非交互模式下默认为 --quiet。例如，使用 --json 或从命令行加载文件而不指定 --shell。不希望这种行为的用户需要指定 --no-quiet。

  • MONGOSH-1720 — 通过替换底层评估机制，非交互模式下的脚本执行速度明显加快。

Node.js:

  • mongosh 现在使用6.5.0版本的Node.js 驱动程序。

  • NODE-5981 – 改进了 Node.js 驱动程序的合规。mongosh 默认输入 directConnection=true，当命令行中仅给出单个主机/端口时。这将忽略 readPreference 选项，并始终应用 primaryPreferred 读取偏好（read preference），即使在连接字符串或个别命令中指定了读取偏好（read preference）。

OIDC 功能：

  • COMPASS-7437 –mongosh 不会请求身份提供者不支持的默认OIDC 作用域。

  • MONGOSH-1712 –--tlsUseSystemCA 标志现在也适用于向身份提供者发出的HTTP请求，以更好地适应 TLS 终止防火墙后面的客户。

修复的问题：

  • MONGOSH-1667 –passwordPrompt() 按最初预期运行。

  • MONGOSH-1702 — 不会再出现针对 macOS Homebrew 用户的古怪过时警告了。

  • MONGOSH-1617 – 将脚本通过管道传输到mongosh 以及.mongoshrc.js 中的自定义提示现在可以一致运行。

JIRA 上提供了完整发布说明。

v2.1.5

发布日期：2024 年 2 月 19 日

升级到 Node.js 版本20.11.1 。节点20.11.1 解决了安全问题。有关更多信息，请参阅 22024 月的 Node.js 安全发布和 CVE-2024 -24806 。

JIRA 上提供了完整发布说明。

v 2.1.4

发布日期：2024 年 2 月 7 日

  • MONGOSH-1198 — 显示错误代码以及错误响应。

  • MONGOSH-1669 — 允许在没有id_ 令牌的情况下进行 OIDC 设备身份验证流程。

  • MONGOSH-1679 — 改进了从从节点(secondary node from replica set)读取错误消息。

  • MONGOSH-1706 — 说明未分片集合成为分片目录的一部分。这确保了与即将推出的服务器版本的前向兼容性。

JIRA 上提供了完整发布说明。

v 2.1.3

发布日期：2024 年 1 月 29 日

  • MONGOSH-1631 —type 为runCommand 、createSearchIndex 和 命令创建搜索索引时，添加对新createSearchIndexes 字段的支持。

  • MONGOSH-1664 — 删除了对validate 命令背景选项的测试。

JIRA 上提供了完整发布说明。

v 2.1.1

发布日期：2023 年 12 月 5 日

  • MONGOSH-1628 - 静态链接 Kerberos 会导致 RHEL 发行版上的 OpenSSL 版本冲突8

  • MONGOSH-1651 - 发送到遥测的会话示例

JIRA 上提供了完整发布说明。

v 2.1.0

发布日期：2021 年 11 月 21 日

  • MONGOSH-1621 和 NODE-5709 – 自动升级到 Node.js21 的 Homebrew 用户不再看到弃用警告。

  • MONGOSH-1452 和 NODE-5040 –mongosh 现在以与其他mongosh 输出更加一致的格式显示BSON对象。此外，许多BSON对象现在支持语法突出显示。

  • MONGOSH-1527 – 现在可以使用一致语法迭代mongosh游标：for (const doc of db.coll.find()) { } 。以前，mongosh 仅支持使用.forEach 语法进行迭代。

JIRA 上提供了完整发布说明。

v 2.0.2

发布日期：2023 年 10 月 16 日

重要

mongosh 1.x 未解决上一个列表中的安全问题。为了提高安全性，请升级到 mongosh 2.0.2。

JIRA 上提供了完整发布说明。

v 2.0.1

发布日期：2023 年 9 月 14 日

  • MONGOSH-1346 — 按平台对下载中心软件包进行分组。

JIRA 上提供了完整发布说明。

v 2.0.0

2023 年 9 月 6 日发布

兼容性注意事项

  • 不支持 Amazon Linux 1、Debian 9 和 macOS 10.14。

  • Red Hat Enterprise Linux (RHEL) 7、Amazon Linux 2、SUSE Linux Enterprise Server (SLES) 12 和 Ubuntu 18.04 支持已弃用，并且可能会在更高版本的 mongosh 中移除。

JIRA 上提供了完整发布说明。

v 1.10.6

2023 年 8 月 25 日发布

  • MONGOSH-1533 — 当有新的mongosh 发布可用时显示通知横幅。

  • MONGOSH-923 - 连接到旧于 5.1.0 的集群时禁用并隐藏 getLastError。

  • MONGOSH-1539 — 添加对Debian12 的支持。

JIRA 上提供了完整发布说明。

v 1.10.5

发布日期：2023 年 8 月 11 日

提供了可通过程序访问的 mongosh 下载列表，该列表可通过应用程序访问。

v 1.10.4

发布日期：2023 年 8 月 10 日

  • MONGOSH-1140 -mongosh 现已在所有架构上正式支持Amazon Linux2023 。

  • MONGOSH-1142 -mongosh 现已在所有架构上正式支持 RHEL9 。

  • MONGOSH-1146 -mongosh 现已在所有架构上正式支持Ubuntu.22 04和Debian12 。

  • MONGOSH-1546 -mongosh 现在生成Linux发布工件，支持在3 arm 架构上使用 OpenSSL64 。

JIRA 上提供了完整发布说明。

v 1.10.3

发布日期：2023 年 7 月 31 日

更新与遥测相关的环境变量。

JIRA 上提供了完整发布说明。

v 1.10.2

发布日期：2023 年 7 月 28 日

  • 反转并修复了无密码身份验证机制校验

  • MONGOSH-1495 删除 db.killOp() 的参数验证

  • MONGOSH-1499 重命名 configureQueryAnalyzer 选项以匹配服务器

  • MONGOSH-1449 日志文件数量上限为100

  • MONGOSH-1496 不要在 buildInfo 中包含 crypt 共享库版本

JIRA 上提供了完整发布说明。

v 1.10.1

2023 年 6 月 21 日发布

  • 升级到 Node.js 版本 16.20.1。节点 16.20.1 解决了安全问题。有关详细信息，请参阅 Node.js 安全发布。

  • MONGOSH-1286 mongosh --build-info 现在列出驱动程序依赖版本。

    • 通过运行新的 buildInfo() 函数，您可以在 Shell 中访问驱动程序依赖版本。

JIRA 上提供了完整发布说明。

v 1.10.0

发布日期：2023 年 6 月 14 日

JIRA 上提供了完整发布说明。

v 1.9.1

发布日期：2023 年 5 月 25 日

  • 报告和监控的内部改进。

JIRA 上提供了完整发布说明。

v 1.9.0

发布日期：2023 年 5 月 17 日

  • mongosh 支持新的 Queryable Encryption 协议。从 v1.9.0 开始，使用 Queryable Encryption 时，mongosh 与低于 7.0 版本的 MongoDB 服务器版本不兼容。

    • 在 7.0 之前的服务器上使用 Queryable Encryption 时，可以解密加密的数据，但不能插入或查询数据。

JIRA 上提供了完整发布说明。

v 1.8.1

2023 年 4 月 24 日发布

mongosh 现在使用5.3.0版本的Node.js 驱动程序。

  • MONGOSH-1304 rs.reconfig() 将不再自动重试操作

  • MONGOSH-1413 这是发布版重命名后第一个为Amazon 上传到 PPA 的版本2023

JIRA 上提供了完整发布说明。

v 1.8.0

发布日期：2023 年 2 月 28 日

在数据库级别的聚合阶段，自动填充功能可以建议填充。

兼容性更改

  • EJSON.stringify 不再接受 {{strict}} 选项。

  • 现已删除以下方法：

    • ObjectId.prototype.generate

    • ObjectId.prototype.getInc

    • ObjectId.prototype.get_inc

    • ObjectId.getInc

  • 代码对象会在其 .code 属性中存储一个字符串。代码对象不会在其 .code 属性中存储 JavaScript 函数。

  • 如果对象将键传递给数据库函数，mongosh 仅向服务器发送对象自身的键。mongosh 不会向服务器发送继承的可枚举键。

1.8.0 中的更新

JIRA 上提供了完整发布说明。

v 1.7.1

2023 年 2 月 16 日发布

  • MONGOSH-1378 mongosh修复了使用 Homebrew 安装 时的连接问题。

JIRA 上提供了完整发布说明。

v 1.7.0

2023 年 2 月 10 日发布

  • MONGOSH-57 连接到模仿MongoDB 的数据库时显示警告。

  • MONGOSH-545 要获取当前连接字符串，请使用 db.getMongo().getURI()。

JIRA 上提供了完整发布说明。

v 1.6.2

发布日期：2023 年 1 月 9 日

JIRA 上提供了完整发布说明。

v 1.6.1

发布日期：2022 年 12 月 1 日

  • MONGOSH-1320 ：修复了与Docker和类似环境相关的初创企业错误。

  • MONGOSH-1050：添加了对 convertShardKeyToHashed() 辅助工具/辅助程序方法的支持。

JIRA 上提供了完整发布说明。

v 1.6.0

发布日期：2022 年 9 月 20 日

JIRA 上提供了完整发布说明。

v 1.5.4

发布日期：2022 年 7 月 31 日

KeyVault.rewrapManyDataKey()修复了轮换由Azure或GCP密钥服务支持的加密数据加密密钥时， 中潜在的数据损坏错误。

在 mongosh 的早期版本中，当重新包装的支持 Azure 或支持 GCP 的数据加密密钥需要获取访问令牌，以解密数据加密密钥时，会出现此错误。

由于此错误，所有重新包装的数据加密密钥都会被新的随机生成的材料替换，从而破坏了原始密钥材料。

为了缓解潜在的数据损坏，请先将mongosh 升级到 v1.5.4 或更高版本，然后再使用 轮换 AzureKeyVault.rewrapManyDataKey() 支持或GCP支持的数据加密密钥。在密钥轮换之前，应始终创建密钥保管集合的备份。

v 1.5.3

发布日期：2022 年 7 月 29 日

更新遥测内部函数。

JIRA 上提供了完整发布说明。

v 1.5.2

2022 年 7 月 27 日发布

mongosh 现在使用 Node.js驾驶员..4 81。

JIRA 上提供了完整发布说明。

v 1.5.1

发布日期：2022 年 7 月 14 日

JIRA 上提供了完整发布说明。

v 1.5.0

发布日期：2022 年 6 月 2 日

  • MONGOSH-1138 –mongosh 现在支持Queryable Encryption。

  • MONGOSH-1169 –mongosh 现在支持 FIPS 兼容模式。

  • mongosh 现在使用 Node.js 版本 16.x。

  • mongosh 不再提供各发行版的 mongosh linux 包。您仍然可以通过包管理器获得 .rpm、.deb和 .tgz包，但命名规则可能会略有不同。

JIRA 上提供了完整发布说明。

v 1.4.2

2022年5月17日发布

  • MONGOSH-1139 — 添加了对 的Debian11 mongosh支持。

  • MONGOSH-1183 -cursor.allowDiskUse() 现在接受true 或false 。

  • MONGOSH-1204 — 在 中为Queryable Encryption集合添加可视标识符。show collections

  • MONGOSH-1207 — 添加Queryable Encryption助手。

JIRA 上提供了完整发布说明。

v 1.4.1

发布日期：2022 年 5 月 12 日

JIRA 上提供了完整发布说明。

v 1.3.1

发布日期：2022 年 3 月 21 日

v 1.3.0

发布日期：2022 年 3 月 17 日

  • MONGOSH-856 — Kerberos功能与传统Shell现已完成对等，最后一个命令行选项现在也像在传统Shell中一样工作。

  • MONGOSH-1013 - 对 CSFLE 的 KMIP支持。更具体地说，您现在可以在创建启用 CSFLE 的连接时提供每个KMS提供程序的 TLS 选项。

  • MONGOSH-1151 - mongosh 中现在也支持快照读取。

JIRA 上提供了完整发布说明。

v 1.2.3

发布日期：2023 年 3 月 10 日

JIRA 上提供了完整发布说明。

v 1.2.2

发布日期：2022 年 2 月 25 日

  • MONGOSH-1134 — 需要修复内部错误才能重新启用 Homebrew 安装。

JIRA 上提供了完整发布说明。

v 1.2.1

发布日期：2022 年 2 月 24 日

JIRA 上提供了完整发布说明。

v 1.1.9

发布日期：2022 年 1 月 18 日

此版本中的新功能：

  • MONGOSH-1015 –mongosh appName如果连接字符串中存在 ，则其不再覆盖 。

  • MONGOSH-1073 – 您现在可以将BSON数字对象传递给旧版BSON数字构造函数。示例，NumberInt(NumberInt(n)) 现在的工作方式与在旧版Shell中一样。

JIRA 上提供了完整发布说明。

v 1.1.8

发布日期：2022 年 1 月 11 日

此版本中的新功能：

JIRA 上提供了完整发布说明。

v 1.1.7

发布日期：2021 年 12 月 14 日

JIRA 上提供了完整发布说明。

v 1.1.6

发布日期：2021 年 12 月 2 日

此版本中的新功能：

此版本包含的错误修复：

  • 修复了在 try 区块中没有抛出任何异常的情况下，try、catch、finally 的工作方式。

JIRA 上提供了完整发布说明。

v 1.1.5

发布日期：2021 年 12 月 1 日

小错误修复。

JIRA 上提供了完整发布说明。

v 1.1.4

发布日期：2021 年 11 月 24 日

小错误修复。

JIRA 上提供了完整发布说明。

v 1.1.2

2021 年 11 月 5 日发布

此版本中的新功能：

JIRA 上提供了完整发布说明。

v 1.1.1

发布日期：2021 年 10 月 28 日

  • 提供适用于其他聚合阶段的自动完成功能。

  • 小错误修复。

JIRA 上提供了完整发布说明。

v 1.1.0

发布日期：2021 年 10 月 7 日

此版本中的新功能：

  • 新增对 edit 命令和 $EDITOR 变量的支持。

  • 数据库和集合的自动完成现在不区分大小写。

JIRA 上提供了完整发布说明。

v 1.0.7

发布日期：2023 年 9 月 22 日

此版本中的新功能：

mongosh 现在使用以下驱动程序版本：

JIRA 上提供了完整发布说明。

v 1.0.6

发布日期：2021 年 9 月 14 日

此版本中的新功能：

此版本包含的错误修复：

  • mongosh 现在会立即运行具有$out 或$merge 的聚合，并且在访问聚合结果后不会延迟运行。

  • 使用传统 NumberLong() 方法不再截断 32 位范围之外的数字。

JIRA 上提供了完整发布说明。

v 1.0.5

2021 年 8 月 12 日发布

此版本中的新功能：

  • 可以使用 config.set('maxTimeMS', <number>) 来设置操作的默认 maxTimeMS 值。maxTimeMS 规定了以毫秒为单位的时间限制，操作必须在该时间限制内完成。

    注意

    config 设置在不同会话之间保持不变。

  • 在 Windows 上，您可以通过双击 .exe 文件来启动 mongosh。执行此操作后，mongosh 会提示您输入连接字符串以连接到部署。

  • 由 mongosh 创建的日志文件遵循 mongod、mongos 或 mongocryptd 的格式。这意味着，日志文件是通过换行符分隔的 JSON，使用的字段集与服务器相同。

v 1.0.4

发布日期：2021 年 8 月 4 日

此版本中的新功能：

  • mongosh 现在可以使用 4.1.0 版本的 Node.js 驱动程序，并完全支持与负载均衡器和 MongoDB Atlas 无服务器实例的连接。

此版本包含的错误修复：

  • 与之前的 mongosh 版本相比，Timestamp() 参数顺序现已颠倒。

v 1.0.3

发布日期：2021 年 7 月 29 日

此版本包含的错误修复：

  • 将退出代码传递给 quit() 的工作方式与在旧版 Shell 中相同。

  • 在循环中使用 console.log() 等方法时，将不再输出 MaxListenersExceededWarning 的实例。

  • 当 mongosh 中发生内部错误时，错误消息会指向当前 mongosh 会话的日志文件。

  • 打印集合的名称时（例如在响应 db.coll 时），数据库名称会包含在输出中。

v 1.0.1

发布日期：2021 年 7 月 21 日

此版本中的新功能：

  • 新增对 --host 标志的完全支持。

  • 新增 --build-info 标志，可提供有关 mongosh 版本的详细信息。

  • 使用 Kerberos 时，如果令牌仍然有效，则 mongosh 将使用令牌。使用有效令牌时，您不再需要指定密码。

此版本包含的错误修复：

  • 修复了在 Kerberos 上偶尔导致 AcquireCredentialsHandle 错误的问题。

  • 其他各种改进。

v1.0

发布日期：2021 年 7 月 9 日

此版本中的新功能：

  • Node.js 驱动程序 BSON 类的所有静态方法现在都可用。具体来说，您可以使用 ObjectId.createFromTime(unixTimestampSeconds) 代替旧版 Shell 的 ObjectId.fromDate(dateObj)。

  • 连接到 Atlas 部署时，默认的 mongosh 提示显示 Atlas 而不是 Enterprise。

  • itdb当重新分配 或调用db.auth() /db.logout() 时，使用 引用的游标将被清除。

  • 细微错误修复和改进。

v 0.15.4

发布日期：2021 年 7 月 1 日

此版本中的新功能：

  • mongosh 现在颜色坐标匹配括号。

v 0.15.3

发布日期：2021 年 6 月 25 日

此版本中的新功能：

  • mongosh 现在，默认情况下，提示符中会显示当前数据库名称。

v 0.15.1

发布日期：2023 年 6 月 22 日

此版本中的新功能：

  • .tar 和 .zipmongosh 下载存档现在包含父目录。

  • 现在，自动完成功能可以识别 --apiStrict 标志。如果 --apiStrict 为 true，则自动完成功能仅完成适用于您定义的 API 版本的方法。有关更多信息，请参阅 Stable API。

  • 代码段。一项实验性功能，允许用户创建自定义 Shell 扩展。

此版本包含的错误修复：

  • mongosh 现在可以连接到包含运行状况不佳的节点的副本集。

v 0.14.0

2021 年 5 月 28 日发布

此版本中的新功能：

  • 运行 show collections 时，集合类型将显示在输出中。

  • 添加 sh.reshardCollection() 以支持重新分片。

  • 将 inspectCompact 选项添加到配置 API 中，以便在其自己的行上打印每个文档字段。

v 0.13.1

发布日期：2021 年 5 月 18 日

此版本中的新功能：

  • 使用 Ctrl+C 中断操作时，您中断的是服务器上运行的操作，而不仅仅是本地 JavaScript 执行。

  • .editor 会话在 shell 历史中汇总为一个项目。

  • 为当前 MongoDB 5.0 服务器支持矩阵中的所有平台构建和发布软件包。

  • 将 Windows MSI 发布到下载中心。

  • 新增使用 prompt（或您的 .mongoshrc.js 文件）并可自定义的 REPL 提示符。

  • 针对 MongoDB 5.0 部署运行时，会显示文档验证失败的原因。

  • 新增对 --apiStrict 标志的基本支持。

  • 新增以下连接方法：

v 0.12.1

发布日期：2021 年 4 月 30 日

此版本中的新功能：

  • 添加对db.hello() Shell方法和hello 数据库命令的支持。使用这些命令代替isMaster 。

  • 扩展了 Shell 自定义 API，以允许控制日志的详细程度。

  • 为 show 和 use 命令添加了自动填充功能。例如 show collections 或 use test。

此版本包含的错误修复：

  • collStats 现在可以在分片集合上正常运行。

v 0.12.0

2021 年 4 月 23 日发布

  • 新增异步重写器，允许在 Shell 中使用更广泛的 JavaScript 功能。

  • 现在，如果认为连接不太可能成功，则连接失败响应会更加迅速。

  • 新增用于 Shell 自定义的 API。

v 0.11.0

发布日期：2021 年 4 月 8 日

内部改进和各种错误修复。

v 0.10.1

发布日期：2021 年 4 月 1 日

内部改进。

v 0.10.0

发布日期：2021 年 3 月 31 日

此版本中的新功能：

  • 支持在启动时加载 .mongoshrc.js 文件。可以使用此文件引导具有自定义设置和扩展功能的 Shell。

  • 能够从命令行加载脚本。

  • 支持 --eval 选项。

  • 支持 Windows 和 macOS 上的 --tlsCertificateSelector。

此版本包含的错误修复：

v 0.9.0

发布日期：2021 年 3 月 10 日

此版本中的新功能：

  • 支持 load() 方法。

  • 支持 AWS IAM 身份验证。

此版本包含的错误修复：

  • 连接到从节点时，自动完成功能可以正常工作。

  • db.createUser()$external数据库上的 现在可以正确处理密码。

  • 其他各种改进。

v 0.8.2

发布日期：2021 年 2 月 24 日

小幅内部改进和错误修复

v 0.8.1

发布日期：2021 年 2 月 22 日

小幅内部改进和错误修复

v 0.8.0

发布日期：2021 年 2 月 17 日

此版本中的新功能：

此版本包含的错误修复：

  • setReadConcern运行db.auth() 不再反转 身份验证操作。

  • 现在，如果在密码提示符中按下退格键，不会再添加星号，而是按预期运行。

  • 现在，在没有值的情况下运行 UUID() 会生成一个随机 UUID。

v 0.7.7

发布日期：2021 年 2 月 3 日

此版本中的新功能：

此版本包含的错误修复：

  • mongosh 连接到处于 STARTUP2 状态的节点时不再失败。

  • mongosh 现在可以正确显示启动警告。

  • explain() 在聚合上，现在可返回准确和完整的结果。

v 0.6.1

2020 年 11 月 30 日发布

此版本中的新功能：

此版本包含缺陷修复和其他更新：

  • 删除对已弃用的 3.6 CRUD 方法（insert()、remove()、save() 和 update()）的支持。

  • 修复将 JavaScript 文件加载到 mongosh 时出现的问题。

  • 修复了以下问题：通过 for 循环插入多个文档时，循环会在插入所有文档之前中止。

  • 修复打印游标结果时的输出问题。

  • 更新了 Node REPL 以使用 Node 版本 14。

v 0.5.2

2020 年 11 月 11 日发布

  • 现在，当连接到 MongoDB 4.4.1 部署时，自动完成功能可以正常工作。

  • sh.status()方法现在可以在浏览器Shell中正确输出。

v 0.5.0

2020 年 10 月 12 日发布

  • 添加对副本集管理方法的支持。

  • 新增对多种分片集群管理方法的支持。

v 0.4.2

发布日期：2020 年 10 月 1 日

  • 添加对带点的集合名称的支持。例如，要查询名为 my.collection 的集合，您可以运行：

    db.my.collection.findOne()

v 0.4.0

发布日期：2020 年 9 月 15 日

v 0.3.1

发布日期：2020 年 9 月 14 日

改进

此版本新增对以下功能的支持：

  • 新的 cursor 方法

  • 查询 planCache 方法

  • 错误辅助方法

  • 以下辅助命令：

    • show users

    • show profile

    • show logs

    • show log[<name>]

此版本包含一个 .rpm 工件，可以从 MongoDB 下载中心进行下载。

行为更新

每当命令的输出包含 { ok: 0 } 时，mongosh 都会引发异常，并且不会从服务器返回原始输出。

旧版 mongo Shell 错误处理在不同命令之间不一致。mongosh 将面向用户的行为标准化，从而提高了用户体验的一致性。

缺陷修复

  • MONGOSH-323 ：getUser() userId字段以二进制形式输出。

  • MONGOSH-337 ： Linux tarball 未进行 gzip 压缩。

  • MONGOSH-341 ：数字 > NumberLong 的值错误Number.MAX_SAFE_INTEGER。作为此修复的结果，传递给NumberLong 和NumberDecimal 的值必须是字符串。

    重要

    与旧版 mongo shell 的行为相比，MONGOSH-341 的修复是一项破坏性变更 (breaking change)。

  • MONGOSH-346 ：Ctrl+C 不会终止Shell中当前正在运行的命令。

    注意

    Ctrl+C 终止 Shell 中的进程，但不终止 MongoDB 服务器上的进程。

v 0.2.2

发布日期：2020 年 8 月 31 日

API 新增功能

此版本新增对以下 API 的支持：

缺陷修复

  • 凭据现在可在日志和历史记录中正确编辑。

过去的版本

有关以往版本的信息，请参阅 GitHub 上的 mongosh 版本。

后退
禁用日志记录
来年
帮助
给本页内容打分

在此页面上