SQL接口变更日志

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专用），必须使用版本 3.0.0。

  • 将驾驶员使用的 MongoSQL引擎更新到版本 2.0.1。

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

  • 要使用 JDBC驾驶员连接到MongoDB SQL接口（Atlas专用），您必须使用版本 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 } ]

    Compare the results of your queries as you upgrade to version 2.0. To learn more about type bracketing, see Type Bracketing.

  • 增加了对高阶函数 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 日发布

• 将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

• Introduces general availability of MongoDB SQL Interface. This modern toolset replaces the legacy MongoDB Connector for BI and provides a unified and consistent set of SQL drivers and connectors for both Atlas and on-premises deployments. This feature is now available for all MongoDB Enterprise Advanced customers with the introduction of the schema builder for on-premises schema management. To learn more, see MongoDB SQL Interface Overview.

• 引入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默认作用域，以发送 openid 和 offline_access，并且仅在设立不为空时与 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 日

• 预览可用性。