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

SQL接口变更日志

注意

发布说明仅提及具有功能更改的版本

MongoDB以持续部署的方式发布SQL接口驱动程序和连接器。这种发布节奏使我们能够不断提高SQL接口的性能和稳定性。这些发布说明仅包含包含直接用户功能更改的版本。如果特定的SQL接口发布仅包含性能和稳定性改进，则不会包含在这些发布说明中。

9 月发布29 、 2026

  • 正式推出MongoDB SQL接口（Atlas专用）。现在，您可以直接在运行MongoDB 6.0 或更高版本的Atlas专用集群M10 及更高版本上启用SQL接口，无需联合数据库实例。

  • SQL接口的Atlas Administration API端点现已提供预览。请求必须发送 Accept: application/vnd.atlas.preview+json 标头。

9 月发布25 、 2026

  • 将 MongoSQL引擎更新至版本 2.0.1。

    • 修复了以下问题：即使比较字段是字符串，IN操作符也会对列表中的值应用隐式类型转换。这会导致查询（例如 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，另一文档将其存储为字符串 "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: {
            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 操作中的错误。具体来说，查询使用了 LEFT JOIN 或 RIGHT JOIN，在 ON 谓词中具有单个字段到字段相等条件，其中一个字段来自左连接源，另一个字段来自右连接源。如果模式指示两个字段均可为空，则结果设立省略某些行。对于 LEFT JOIN，左侧源中连接键值为空（NULL 或 MISSING）的行被从结果设立省略，即使它们应该包含在内。同样，同样的问题也会影响来自正确数据源的行的 RIGHT JOIN。没有匹配项的非空行仍包含在结果集中。仅省略具有 null 值的行。

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- - 202619502问题。

    • 删除 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 日发布

重要

If you use Kerberos, OIDC, or x509 authentication methods, upgrade to JDBC 3.0.4 or later and the Tableau custom connector to 1.4.5 or later.

  • 将Tableau自定义Connector（针对MongoDB JDBC驱动程序）更新到版本 1.4.5。

    • 在连接对话框中添加针对特定身份验证机制的部分：Username and Password、X509、GSSAPI 和 OIDC。

  • 将 JDBC驾驶员更新至版本 3.0.4。

    • 引入对 OIDC 机器流身份验证的支持。这样， Tableau Server 用户就可以安全地发布和刷新报告，而无需依赖嵌入式用户名和密码。该驾驶员现在通过 authMechanismProperties 连接 URI 参数原生支持Kubernetes、Google Cloud 和Azure环境的机器流身份验证。

    • 为Tableau Desktop 引入Kerberos支持。这包括添加以下配置属性：

      • jaasconfigpath

      • gssnativemode

      • gssapilogincontextname

      • gssapiserverauth

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自定义Connector（适用于MongoDB JDBC驾驶员）更新到版本 1.4.4。

    • 从连接对话框中删除与日志相关的字段以增强安全性。您仍然可以使用属性文件(mongodb_jdbc.properties) 在Tableau中配置日志记录选项 loglevel 和 logdir，以自定义连接。有关更多详细信息，请参阅 Tableau 文档。

7 月发布15 、 2025

  • 将 ODBC驾驶员更新到版本 1.4.5。

  • 更新 ODBC OIDC默认作用域，以发送带有 offline_access 的 openid，并且仅在设立不为空时与 IdP 报告的作用域相交。

  • 使 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 / Token

    • Username and Password

    如果选择Certificate / Token ，则不需要用户名和密码。

6 月发布21 、 2024

  • 将 JDBC驾驶员更新至版本 2.1.3。

  • 为 JDBC 驱动程序引入 oidc 身份验证。

  • 添加MongoClient实例的缓存。

2024 年 5 月 22 日发布

  • 将 ODBC驾驶员更新到版本 1.3.3。

  • 在 ODBC驾驶员DSN 配置用户界面上添加一个复选框，指示是否将最大字符串长度限制为 4000 个字符。要使用BI工具（例如Microsoft SQL Server 链接服务器）（此类工具无法处理最大长度未知的可变长度字符串数据），您必须启用此选项。

发布日期：2024 年 4 月 24 日

  • 将 JDBC驾驶员更新到 2.1.2 版本，该版本现在会忽略“true”和“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 。

  • 添加对直接查询的支持。直接查询功能需要 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，这会按照与选择列表中提供的顺序相同的顺序（而不是按字母顺序）返回结果设立列。

  • 修复记录器，使其仅将日志记录配置应用于驱动程序处理程序，而不应用于其他应用程序处理程序。

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 日

  • 预览可用性。
后退
私有端点
给本页内容打分