Atlas和Enterprise Advanced (EA) 的SQL接口允许非开发者从他们已使用的SQL工具中查询MongoDB数据。它通过标准 ODBC 和 JDBC 连接提供实时只读访问权限，无需学习 MQL 或将数据移出 MongoDB 进行分析。这简化了运营报告，加快了见解速度，并确保数据保持准确和一致。
您可以通过三种方式部署SQL接口：直接在Atlas专用集群上，通过Atlas联合数据库实例，或在自管理的Enterprise Advanced (EA)部署。如需对单个Atlas 集群进行直接SQL访问权限，请使用专用集群。这是大多数Atlas连接的推荐路径，并且不需要联合数据库实例。当单个SQL查询必须跨越多个数据源（例如多个集群或 S3 存储桶）时，请使用联合数据库实例。
比较部署选项
专用集群（推荐用于Atlas） | 联合数据库实例 | 本地 (EA) | |
|---|---|---|---|
最适合 | 对一个Atlas 集群中数据的SQL访问权限。 | 跨越多个数据源的单个SQL查询。 | 对您自行运行的自管理部署的SQL访问权限。 |
数据源 | 一个专用集群。 | 多个Atlas集群、 Atlas Data Federation集合和存储对象，包括 AWS S3 存储桶、 Azure Blob 存储容器、Google Cloud存储桶、 HTTP URL 和Atlas Online Archive。 | |
部署要求 | 专用集群（ | 联合数据库实例。无集群层要求。 | |
MongoDB 版本 | 6.0 及更高版本。 | 5.0 及更高版本。 | 6.0 及更高版本。 |
数据库版本 | Atlas Core Database Edition 和Atlas Infinite Database Edition。 | Atlas Core Database Edition 和Atlas Infinite Database Edition。 | 不适用。 |
模式管理 | MongoDB SQL模式生成器CLI。 | Atlas Data Federation SQL模式管理，内置于Atlas用户界面中。 | MongoDB SQL模式生成器CLI。 |
架构 | 直接连接到集群。 | 共享和多租户。 Atlas Data Federation查询引擎从所有根本的数据源检索数据并进行聚合。 | 在您自己的环境中运行。 |
连接和查询限制 | 关注集群本身。 | 联合数据库实例实施自己的并发连接和查询限制。 | 遵循部署本身。 |
所有三个选项都提供实时只读访问权限，并使用与SQL-92 兼容的 MongoSQL 方言。您不能使用SQL接口在任何部署上插入、更新或删除文档，并且SQL接口不支持其他SQL方言。
SQL接口组件
SQL接口部署由四个组件组成：
将您的 BI 工具连接到 MongoDB 数据库的 JDBC 或 ODBC 驱动程序。您选择的驱动程序取决于您的BI工具。
在BI工具和MongoDB 数据库之间转换SQL查询需要JSON schema 。对于联合数据库实例，模式管理内置于Atlas用户界面中。对于专用集群和自管理的Enterprise Advanced (EA) 部署，您可以将MongoDB SQL Schema Builder下载为CLI工具。要学习；了解更多信息，请参阅模式管理。
数据所在的MongoDB 数据库，可以是Atlas 集群，也可以是自管理的 EA数据库。
MongoDB SQL接口的主要优点
- 模式改进
- 体验显着改进的模式集成。模式计算会适应您的数据并原生表示您的集合。不会缓存模式，您可以随时刷新模式，而不会影响连接。
- 简单又安全
- 享受简化的设置，无需复杂的代理配置，允许您直接连接到MongoDB 集群。它提供强大的身份验证，支持X509 和 OIDC 协议。
- 一流的SQL体验
- 利用具有原生驱动程序支持的丰富对象和数组，增强数据交互。服务器无缝重启，确保不间断运行和高可用性。该接口使用 MongoSQL，这是一种与MongoDB原生SQL-92 兼容的方言，支持复杂的转换，例如展平嵌套对象和直接在SQL查询中展开数组。
- 统一访问
- 为联合数据库实例、专用集群和自管理 EA 数据库提供相同的驱动程序、连接器和模式映射。
- BI工具集成
- Power BI Connector已通过Microsoft认证， Tableau Connector 是与Tableau合作开发的。它支持带有 DirectQuery 的 Power BI以及Tableau Desktop、 Tableau Server、 Tableau Prep 和Tableau Cloud。 Tableau Cloud 仅支持SCRAM身份验证。
MongoDB SQL接口兼容性注意事项
使用SQL接口时，请考虑以下几点，确保您的设置兼容且是最新的：
SQL接口组件（包括驱动程序、连接器和MongoDB SQL模式构建者）没有正式的 EOL。相反，它们的生命周期与它们设计使用的MongoDB服务器版本和语言运行时的兼容性有关。
SQL Interface components remain compatible with a MongoDB server version for up to 3 years after that server version's EOL. To learn more, see MongoDB Software Lifecycle Schedules.
我们建议将SQL接口组件升级到最新版本，尤其是在升级MongoDB服务器时。这样可以确保访问新功能、性能增强和长期兼容性。要查看最新版本，请访问MongoDB下载中心。
传统选项
MongoDB Connector for BI是用于将BI分析工具连接到MongoDB 数据库或集群的传统工具。 BI Connector将于 9 月 2026达到生命周期结束 (EOL)。