注意
发布说明仅提及具有功能更改的版本
MongoDB以持续部署的方式发布SQL接口驱动程序和连接器。这种发布节奏使我们能够不断提高SQL接口的性能和稳定性。这些发布说明仅包含包含直接用户功能更改的版本。如果特定的SQL接口发布仅包含性能和稳定性改进,则不会包含在这些发布说明中。
2026 年 11 月 12 日发布
将 JDBC 驱动程序更新至版本 4.0.2。
- 当驾驶员加载其原生库时,它不再接受已存在于共享临时位置的库文件。以前,同一托管上拥有普通帐户的本地用户可以将文件放在该位置,驾驶员会在不验证其来源的情况下加载该文件。在Java应用程序中加载驾驶员程序类,然后可以在应用程序进程中运行用户选择的代码。这可能会导致该进程所持有的数据遭到泄露或更改,或者使该进程不可用。此问题不太可能被利用,因为驾驶员仅在应用程序加载驾驶员时加载其原生库一次,并且临时位置不固定且难以预测。此修复可解决 CVE-2026-126823。
2026 年 11 月 3 日发布
将 ODBC 驱动程序更新至版本 3.0.1。
在向固定宽度的客户端目标执行写入操作时,驱动程序现在会检查目标大小,以确保该值在其大小范围内。此前,对于某些数据库类型,驱动程序生成的文本形式的值比目标值长,并且在复制时没有将复制限制为目标的实际大小。具有基本写入权限的数据库用户可能会影响目标之外写入的数据,这可能会损坏使用该驱动程序的应用程序中的内存,并导致其意外终止。此修复解决了 CVE-2026-120952。
在返回查询值时,驱动程序现在会在调用应用程序提供的缓冲区范围内进行写入。此前,当应用程序使用特定方式一次请求多个结果行时,驱动程序可能会将这些值写入缓冲区边界之外。能够影响查询返回值的方可能会导致数据被放置在客户端应用程序内存中的意外位置,这可能会修改该内存或终止客户端进程。此修复解决了 CVE-2026-120959。
将 JDBC 驱动程序更新至版本 4.0.1。
- 修复了驱动程序身份验证组件中的 URI 重定向漏洞。在交互式登录流程中,驱动程序现在会在将地址传递给本地默认协议处理程序之前,验证远程终结点提供的每个终结点地址的方案。以前,驱动程序在接受这些地址时不会验证其方案。控制用户所连接终结点的未经身份验证的远程方可能会在用户登录时导致其选择的地址在用户的系统上打开。此修复解决了 CVE-2026-120953。
9 月发布29 、 2026
引入 MongoDB SQL Interface (Atlas Dedicated) 正式版本。现在,您可以直接在运行 MongoDB 6.0 或更高版本的 Atlas 专用集群(
M10及以上版本)上启用 SQL Interface,而无需联合数据库实例。您可以从 Atlas 用户界面中的集群配置表单或使用 Atlas Administration API 为每个集群启用或禁用 SQL 界面。欲了解更多信息,请参阅 SQL 界面服务器设置。
使用 MongoDB SQL Schema Builder CLI 管理专用集群的模式。要了解更多信息,请参阅模式管理。
SQL Interface 支持 Atlas Core 数据库 Edition 和 Atlas Infinite 数据库 Edition 上的专用集群。Atlas Infinite 数据库版本目前处于公开预览阶段。
用于 SQL 接口的 Atlas Administration API 终结点目前处于预览阶段。请求必须发送
Accept: application/vnd.atlas.preview+json标头。将 ODBC 驱动程序更新至版本 3.0.0。
要使用 ODBC 驱动程序连接到 MongoDB SQL 接口(Atlas Dedicated),您必须使用版本 3.0.0。
将驱动程序使用的 MongoSQL 引擎更新为版本 2.0.1。
将 JDBC 驱动程序更新至版本 4.0.0。
要使用 JDBC 驱动程序连接到 MongoDB SQL Interface (Atlas Dedicated),必须使用版本 4.0.0。
将驱动程序使用的 MongoSQL 引擎更新为版本 2.0.1。
9 月发布25 、 2026
将 MongoSQL 引擎更新至版本 2.0.1。
- 修复了
IN操作符即使在比较的字段是 string 时也会对列表中的值应用隐式类型转换的问题。这导致查询(例如WHERE employeeId IN ('0035759', '1033282'))返回不完整的结果。
9 月发布10 、 2026
将 MongoSQL 引擎更新至版本 2.0.0。
更改 MongoSQL 翻译将字段与字面值进行比较的
WHERE子句的方式,例如WHERE x > 20。这些比较现在已转换为 MongoDB 匹配语言,而不是$expr表达式。MongoDB 匹配语言应用类型括号。使用类型括号时,MongoDB 仅比较与您的查询的谓词具有相同类型的值。此项更改促进了索引使用,但如果您的字段是多态的,则可能会影响您的查询结果。通过 Atlas Data Federation 运行的 MongoSQL 查询不受影响。考虑以下集合,其中一个文档将
age存储为数字25,而另一个文档将其存储为 string"25":[ { "_id": 1, "name": "John Doe", "age": 25 }, { "_id": 2, "name": "Jane Doe", "age": "25" }]要返回
age大于20的所有用户,您可以使用$expr写入聚合管道:[ { $match: { $expr: { $gt: [ "$age", 20 ] } } }]即使
$gt子句是与数字进行比较,此管道也会返回这两个文档:[ { _id: 1, name: 'John Doe', age: 25 }, { _id: 2, name: 'Jane Doe', age: '25' }]您也可以使用 match 语言写入相同的查询:
[ { $match: { age: { $gt: 20 } } }]此管道仅返回
age为数字的文档。{ $gt: 20 }条件仅匹配数字。MongoDB 仅返回包含大于20的数字的文档:[ { _id: 1, name: 'John Doe', age: 25 } ]在升级到版本 2.0 时,比较您的查询结果。要了解有关类型括号的更多信息,请参阅 类型括号。
增加了对高阶函数
MAP、FILTER和REDUCE的支持。还添加了以下函数,它们封装了MAP、FILTER或REDUCE功能:ARRAY_CAST、ARRAY_EXTRACT、ARRAY_COMPACT、ARRAY_COUNT_IF、ARRAY_REMOVE、ARRAY_SUM、ARRAY_PRODUCT、ARRAY_AVG、ARRAY_ALL、ARRAY_ANY和ARRAY_JOIN。修复了
LEFT JOIN和RIGHT JOIN操作中满足特定条件的错误。具体而言,查询在ON谓词中使用带有单个字段到字段相等条件的LEFT JOIN或RIGHT JOIN,其中一个字段来自左连接源,另一个字段来自右连接源。如果模式指示两个字段都可以为 null,则结果集会省略一些行。对于LEFT JOIN,来自左侧源的连接键值为 nullish(NULL或MISSING)的行被从结果集中省略,即使它们本应被包含在内。同样,相同的问题也会影响RIGHT JOIN中来自右侧源的行。没有匹配项的非 nullish 行仍包含在结果集中。只有具有 nullish 值的行被省略。
8 月发布26 、 2026
将 MongoSQL 过渡准备工具更新到 1.1.3 版本。
在工具将服务器提供的数据库、集合和字段名称写入生成的 HTML 报告之前,对其进行转义。以前,包含 HTML 标记的名称可能会在打开报告的用户的浏览器中运行脚本。此修复解决了 CVE-2026-76798 和 CVE-2026-76794。
在工具将从 Atlas BI Connector 日志中读取的查询文本和用户名写入生成的 HTML 报告之前,对其进行转义。
中和生成的 CSV 报告单元格值中的公式元素。以前,以
=、+、-或@开头的集合或字段名称在用户在电子表格应用程序中打开报告时可能会作为公式运行。此修复解决了 CVE-2026-76797。
7 月发布30 、 2026
将 JDBC 驱动程序更新至版本 3.0.8,将 ODBC 驱动程序更新至版本 2.0.10。
- 将 SQL 翻译引擎升级到最新版本,增加了查询优化,并修复了在解析横向连接的右侧模式时发生的间歇性错误。
7 月发布23 、 2026
将 ODBC 驱动程序更新至版本 2.0.9。
添加对 Linux arm64 架构的支持。
修复应用程序将空
catalogName参数传递给SQLTablesW时发生的错误。驱动程序现在将空模式参数视为等同于%,按照 ODBC 规范的要求。修复了一个问题,即驱动程序可以为未使用
https的 OIDC 授权终结点启动操作系统协议处理程序。驱动程序现在在打开 URL 之前验证终结点方案。此修复解决了 CVE-2026-19502。删除 OpenSSL 要求。驱动程序现在使用
rustls进行安全连接。
7 月发布9 、 2026
将 MongoDB SQL 模式构建器 CLI 更新到 1.2.1 版本。此版本中的以下修复解决了 CVE-2026-19502:
修复了 CLI 可以从未经检查的路径方案启动任意操作系统协议处理程序的问题。
修复了 CLI 将连接字符串和密码以明文形式记录到终端和日志文件的问题。CLI 现在将这些值进行密文处理。
6 月发布9 、 2026
- 将 MongoDB SQL 模式构建器 CLI 更新到版本 1.2.0。
6 月发布4 、 2026
将 ODBC 驱动程序更新至版本 2.0.8。
修复使用包含保留符号(
:、/、?、#、[、]或@)的密码的 LDAP(已弃用)身份验证机制时发生的连接失败。升级第三方依赖项。
发布日期:2026 年 4 月 20 日
将 JDBC 驱动程序更新至版本 3.0.6。
- 升级第三方依赖项。
发布日期:2026 年 4 月 14 日
将 ODBC 驱动程序更新至版本 2.0.7。
提高了与 SAS 等在连接设置期间查找数据源名称的应用程序的兼容性。
修复了当您的 business intelligence 工具从MongoDB数据源检索数据库列表并在耗尽结果集后尝试检索更多行时可能出现的错误。
升级第三方依赖项。
发布日期:2026 年 4 月 13 日
将 MongoDB SQL 模式构建器 CLI 更新到版本 1.1.3。
当从节点(secondary node from replica set)或分析节点可用时,将模式读取指向这些节点。否则,回退到主节点 (primary node in the replica set)。
修复了一个导致 CLI 在视图引用不存在的集合时崩溃的错误。CLI 现在会报告错误并继续执行。
3 月发布17 、 2026
将 MongoDB SQL 模式构建器 CLI 更新到版本 1.1.2。
- 修复了一个错误,该错误导致 CLI 无法为时间序列集合生成模式。
3 月发布16 、 2026
将 ODBC 驱动程序更新至版本 2.0.6。
通过在初始回退后缓存 DNS 解析程序来提高Windows上的连接性能。驱动程序现在仅执行一次 DNS 回退,并在后续连接中重复使用缓存的解析程序。
为暂时性错误添加自动重试逻辑。该驱动程序现在采用指数退避功能重试失败的操作最多 3 次,从而提高了由于网络不稳定或空闲连接超时而导致连接失败时的可靠性。
2 月发布26 、 2026
将 MongoDB SQL 模式构建器 CLI 更新到版本 1.1.1。
当分析节点可用时,将模式读取指向分析节点;否则,回退到另一个可用节点。
改善针对具有不稳定数据字段的大型数据集的模式生成。
限制 CLI 运行的并发任务数量,这会减少内存使用量和正在执行的查询数量。
2 月发布19 、 2026
将 ODBC 驱动程序更新至版本 2.0.5。
- 确保驱动程序在主节点 (primary node in the replica set)Cloudflare DNS 失败时正确回退到系统 DNS 解析程序,从而修复Windows上 SRV 连接字符串的连接问题。
2 月发布10 、 2026
将 JDBC 驱动程序更新至 3.0.5,将 ODBC 驱动程序更新至版本 2.0.4。
修复在
WHERE子句中包含OR条件的SQL查询错误地筛选出行的问题。当OR条件的一个操作数计算结果为UNKNOWN(由于NULL或可空字段中缺少值)而另一个操作数计算结果为TRUE时,就会发生这种情况。这种行为偏离了标准的三值SQL语义,可能导致结果集不完整。重要
本地部署 (EA) 用户应升级到最新的驱动程序版本(JDBC 驱动程序 3.0.5 或更高版本,以及 ODBC 驱动程序 2.0.4 或更高版本)。
Atlas SQL用户会自动收到此修复。但是,您应该刷新受影响的仪表盘或重新执行查询以更新现有结果。
对于 JDBC 驱动程序,连接验证失败现在包括更具描述性的错误消息,告诉您根本的原因。此改进专门帮助Tableau 云用户诊断无法直接访问驱动程序或系统日志的问题。
修复了上一版本引入的 ODBC 驱动程序与 Power BI 的兼容性问题。
将 ODBC 驱动程序更新至版本 2.0.3。
- 升级第三方依赖项。
1 月发布8 、 2026
将 ODBC 驱动程序更新至版本 2.0.2。
- 在Windows上添加 DNS 解析程序回退逻辑。如果主要的 Cloudflare 解析器出现故障,ODBC 驱动程序现在会恢复为系统默认解析器,从而确保在受限网络环境中实现可靠连接。
2025 年 11 月 24 日发布
重要
如果您使用 Kerberos、OIDC 或 x509 身份验证方法,请升级到 JDBC 3.0.4 或更高版本,并将 Tableau 自定义连接器升级到 1.4.5 或更高版本。
将Tableau自定义Connector(针对MongoDB JDBC驱动程序)更新到版本 1.4.5。
- 在连接对话框中添加针对特定身份验证机制的部分:Username and Password、X509、GSSAPI 和 OIDC。
将 JDBC 驱动程序更新至版本 3.0.4。
引入了对 OIDC 机器流身份验证的支持。这使 Tableau 服务器 用户能够安全地发布和刷新报告,而无需依赖嵌入的用户名和密码。该驱动程序现在通过 连接 URI 参数,原生支持 Kubernetes、Google Cloud Platform 和 Azure
authMechanismProperties环境的机器流身份验证。为Tableau Desktop 引入Kerberos支持。这包括添加以下配置属性:
jaasconfigpathgssnativemodegssapilogincontextnamegssapiserverauth
10 月发布23 、 2025
将 JDBC 驱动程序更新至版本 3.0.3。
在 URI 中添加新选项
tlsCaFile支持,并将其作为tlscafile属性添加。
10 月发布14 、 2025
将 ODBC 驱动程序更新至版本 2.0.1。
通过更正自定义安装路径的权限,修复Windows安装程序中的本地权限漏洞 (CVE-2025-11575)。
9 月发布17 、 2025
正式推出MongoDB SQL接口。这个现代工具集取代了旧版 MongoDB Connector for BI,并为Atlas和本地部署提供了一套统一且一致的SQL驱动程序和连接器。现在,随着针对本地部署模式管理的模式构建器的推出,所有MongoDB Enterprise Advanced客户都可以使用此功能。要学习;了解更多信息,请参阅MongoDB SQL接口概述。
引入MongoDB SQL Schema Builder 1.1.0 用于本地部署的模式管理。
将 ODBC 驱动程序更新至版本 2.0.0。
引入本地部署连接支持。
引入对Kerberos (GSSAPI)身份验证的支持,从而在企业环境中实现安全连接,并为从旧版MongoDB Connector for BI迁移的用户提供一项关键功能。
修复了通过某些工具(例如Microsoft SQL Server 链接服务器)连接时无法列出表的问题。驱动程序现在可以正确处理使用空
TableType参数的SQLTables调用。
将 JDBC 驱动程序更新至版本 3.0.1。
- 引入本地部署连接支持。
8 月发布12 、 2025
将 ODBC 驱动程序更新至版本 1.4.6。
修复了 ODBC 驱动程序版本 1.4.5 中的一个错误,该错误导致驱动程序在具有最小权限集的用户检索可访问表列表时发生崩溃。
7 月发布29 、 2025
将 Tableau 自定义连接器(适用于 MongoDB JDBC 驱动程序)更新至版本 1.4.4。
- 从连接对话框中删除与日志相关的字段以增强安全性。您仍然可以使用属性文件(
mongodb_jdbc.properties) 在Tableau中配置日志记录选项loglevel和logdir,以自定义连接。有关更多详细信息,请参阅 Tableau 文档。
7 月发布15 、 2025
将 ODBC 驱动程序更新至版本 1.4.5。
将 ODBC OIDC 默认范围更新为在
offline_access中发送openid,并且仅在集合不为空时与身份提供程序报告的范围相交。使
SQLEndTran为空操作。将 Rust 驱动程序更新到版本 3.2.4。
6 月发布18 、 2025
将 JDBC 驱动程序更新为 2.3.0。
引入新属性
disableclientcache以禁用 JDBC驱动程序中的客户端缓存。您必须谨慎使用此属性,它适用于 JDBC 驱动程序用于连接到可变数量的客户数据库以以不同频率运行查询的服务器环境。警告
为避免重复出现重新身份验证流程,请勿将此属性与 OIDC身份验证机制一起使用。
6 月发布12 、 2025
将 JDBC 驱动程序更新至版本 2.2.4。
修复了 JDBC 驱动程序的一个问题,使其现在可以拒绝
setFetchSize的无效值并提供清晰的错误消息。添加 OIDC 默认作用域以支持更多 IdP 配置(示例 Azure OIDC)。
发布日期:2025 年 4 月 30 日
- 将 ODBC 驱动程序更新至版本 1.4.4。
发布日期:2025 年 4 月 9 日
将 JDBC 驱动程序更新至版本 2.2.3。
修复了 OIDC身份验证无法在 macOS 上打开浏览器进行登录的问题。
通过 JDBC驱动程序的附加信息增强日志记录功能。
3 月发布28 、 2025
将 ODBC 驱动程序更新至版本 1.4.3。
修复了
SQLDriverConnect中的一个错误:如果StringLength2Ptr为null,则驱动程序会崩溃。
3 月发布5 、 2025
将Tableau自定义Connector(针对MongoDB JDBC驱动程序)更新到版本 1.4.2。
将Connector从MongoDB Atlas重命名为MongoDB SQL接口。
1 月发布6 、 2025
将 ODBC 驱动程序更新至版本 1.4.2。
- 更新内部 ODBC 处理以改进 BI 工具集成。
12 月18 、 2024发布
将 JDBC 驱动程序更新至版本 2.2.1。
实现
getCursorName()以提高与数据库工具的兼容性。改进身份验证失败的错误消息。
发布日期:2024 年 12 月 6 日
将Tableau自定义Connector(针对MongoDB JDBC驱动程序)更新到版本 1.4.0。
将Tableau连接器的日志信息用户界面移至 Advanced标签页。
8 月发布15 、 2024
发布 JDBC 驱动程序2.2.0版本。
引入对用于日志记录的 jBoss 日志管理器 的驱动程序支持。
将 UUID string表示形式更新为扩展JSON uuid 格式
{$uuid : "val"},而不是通用基本 64 二进制数据格式{ "$binary":{"base64": "base64val", "subType": "xx"}。 对于subType 03,您可以使用uuidRepresentation连接选项。
7 月发布8 、 2024
为 ODBC 驱动程序引入了 OIDC 身份验证。
将 ODBC 驱动程序更新至版本 1.4.1。
在 ODBC 驱动程序中添加对
wlongvarchar和wvarcchar的转换支持。解决 ODBC 驱动程序的低和中静态代码分析结果。
6 月发布27 、 2024
将 JDBC 驱动程序更新至版本 2.1.4。
将 ODBC 驱动程序更新至版本 1.3.4。
发布校验和以验证ODBC的签名 msi。
6 月发布24 、 2024
将Tableau自定义Connector(针对MongoDB JDBC驱动程序)更新到版本 1.3.0。
添加在两种身份验证类型之间进行选择的能力:
Certificate / TokenUsername and Password
如果选择
Certificate / Token,则不需要用户名和密码。
6 月发布21 、 2024
将 JDBC 驱动程序更新至版本 2.1.3。
为 JDBC 驱动程序引入 oidc 身份验证。
添加
MongoClient实例的缓存。
2024 年 5 月 22 日发布
将 ODBC 驱动程序更新至版本 1.3.3。
在 ODBC 驱动程序 DSN 配置用户界面上添加一个复选框,用于指示是否将最大 string 长度限制为 4000 个字符。为了与无法处理没有已知最大长度的可变长度string数据的 BI 工具(如 Microsoft SQL 服务器 Linked 服务器)配合使用,必须启用此选项。
发布日期:2024 年 4 月 24 日
- 将 JDBC 驱动程序更新至版本 2.1.2,该版本现在会忽略“true”和“false”
setAutoCommit值,而不是在值为“true”时返回异常。
发布日期:2024 年 4 月 22 日
将 ODBC 驱动程序更新至版本 1.3.0。
添加对结果集数据按列绑定的支持。
添加对 SQLCancel 的支持。
将非标准数据类型(例如
document和oid)默认映射从SQL_UNKNOWN_TYPE更改为SQL_WVARCHAR。 此更改仅影响依赖于 SQL 类型名称的编程集成;它不会影响 Power BI。
3 月发布4 、 2024
将 Power BI Connector 更新到版本1.2.0 。
添加了对 Direct Query 的支持。Direct Query 功能需要 ODBC 驱动程序版本 1.2.0 或更高版本。
3 月发布1 、 2024
将 ODBC 驱动程序更新至版本 1.2.0。
添加对请求驱动程序表现出 ODBC 2.0行为的 ODBC 客户端的支持。
添加了对
SQLFreeStatement的支持。添加了对
SQLFetchScroll的支持。结果集中的列顺序现在遵循 SQL- 92规范。 结果集列按照在
SELECT查询中列出的顺序显示。 对于SELECT *,结果集列顺序保持不变。更新
SQLGetInfo返回的信息以报告所有支持的日期函数、时间函数和连接功能。删除 DSN 和连接级别的日志级别配置。 日志级别现在只能设置为驱动程序属性。
由于
Decimal128和SQL_DECIMAL之间的不兼容,将Decimal128的 BSON 到 SQL 的映射从SQL_DECIMAL更改为SQL_UNKNOWN。
2 月发布23 、 2024
- 将 JDBC 驱动程序更新至版本 2.1.1,该版本删除了 SnakeYaml 依赖项并修复了版本 2.1.0 中引入的问题其中按列名检索的数据指向了错误的索引。驱动程序现在可以在正确的索引下检索数据,或者在存在重复列名时报告错误。
发布日期:2024 年 1 月 22 日
将 JDBC 驱动程序更新为 2.1.0 版本,该版本按 select 列表中提供的顺序返回结果集列,而不是按字母顺序返回。
修复记录器,使其仅将日志记录配置应用于驱动程序处理程序,而不应用于其他应用程序处理程序。
2023 年 10 月 20 日发布
- 将 Power BI Connector 更新到版本 1.1.1、 修复了 JSON 值显示为二进制而不是 JSON 字符串的错误。
2023 年 10 月 17 日发布
将 Power BI Connector 更新到版本 1.1.0, 这增加了在连接时传递本机查询的能力。要了解更多信息,请参阅从 Power BI 连接到 Atlas SQL。
删除日志级别选择器,以符合适用于 Power BI 的 Microsoft 日志记录策略。
2023 年 8 月 17 日发布
- 将 Power BI Connector 更新到版本 1.0.1,添加了日志级别选择器,允许为每个连接设置日志记录级别。
2023 年 6 月 16 日发布
- 将 Power BI Connector 更新到版本 1.0.0。
2022 年 10 月 24 日发布
- 将 Tableau 自定义连接器(针对 MongoDB JDBC 驱动程序)更新到版本 1.2.0。
2022 年 9 月 19 日发布
- 更新 Tableau connector(针对 MongoDB JDBC 驱动程序)到版本 1.1.0。
发布日期:2022 年 6 月 7 日
- 预览可用性。