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 集合以及存储对象，包括 Amazon Web Services S3 存储桶、Azure Blob Storage 容器、GCP 存储桶、HTTP URL 以及 Atlas 在线存档。 | 一个自管理 Enterprise Advanced (EA) 部署。 |
部署要求 | 专用集群， | 联合数据库实例。无集群层要求。 | 一个 MongoDB Enterprise 集群。不支持 Community 集群。 |
MongoDB 版本 | 6.0和更高版本。 | 5.0和更高版本。 | 6.0和更高版本。 |
数据库版本 | Atlas Core 数据库 Edition 和 Atlas Infinite 数据库 Edition。 | Atlas Core 数据库 Edition 和 Atlas Infinite 数据库 Edition。 | 不适用。 |
模式管理 | MongoDB SQL 模式构建者 CLI。 | 内置于 Atlas 用户界面中的 Atlas Data Federation SQL 模式管理。 | MongoDB SQL 模式构建者 CLI。 |
架构 | 直接连接到集群。 | 共享和多租户。Atlas Data Federation 查询引擎从所有根本的数据源检索数据并进行聚合。 | 在您自己的环境中运行。 |
连接和查询限制 | 关注集群本身。 | 联合数据库实例实施其自身的并行连接和查询限制。 | 跟踪部署本身。 |
这三个选项都提供实时、只读访问，并使用 MongoSQL 方言，该方言与 SQL-92 兼容。您不能使用 SQL Interface 在任何部署上插入、更新或删除文档，并且 SQL Interface 不支持其他 SQL 方言。
SQL接口组件
SQL接口部署由四个组件组成：
将您的 BI 工具连接到 MongoDB 数据库的 JDBC 或 ODBC 驱动程序。您选择的驱动程序取决于您的BI工具。
需要 JSON schema 才能在您的 BI 工具与 MongoDB 数据库之间转换 SQL 查询。对于联合数据库实例，模式管理已集成到 Atlas 用户界面中。对于专用集群和自管理的 Enterprise Advanced (EA) 部署，您可以下载 MongoDB SQL 模式构建者作为 CLI 工具。要了解更多信息，请参阅模式管理。
数据所在的MongoDB 数据库，可以是Atlas 集群，也可以是自管理的 EA数据库。
MongoDB SQL接口的主要优点
- 模式改进
- 体验显著改进的模式集成。模式计算适应您的数据，并以本机方式表示您的集合。模式不会被缓存，并且您可以随时刷新它们，而不会影响连接性。
- 简单又安全
- 享受简化的设置，无需复杂的代理配置，允许您直接连接到MongoDB 集群。它提供强大的身份验证，支持X509 和 OIDC 协议。
- 一流的SQL体验
- 利用具有原生驱动程序支持的丰富对象和数组，增强数据交互。服务器无缝重启，确保不间断运行和高可用性。该接口使用 MongoSQL，这是一种与MongoDB原生SQL-92 兼容的方言，支持复杂的转换，例如展平嵌套对象和直接在SQL查询中展开数组。
- 统一访问
- 为联合数据库实例、专用集群和自管理 EA 数据库提供相同的驱动程序、连接器和模式映射。
- BI工具集成
- BI Connector 已获得 Microsoft 认证，Tableau Connector 是与 Tableau 合作开发的。它支持通过 DirectQuery 连接 Power BI，以及 Tableau Desktop、Tableau 服务器、Tableau Prep 和 Tableau 云。Tableau 云 仅支持 SCRAM 身份验证。
MongoDB SQL接口兼容性注意事项
使用SQL接口时，请考虑以下几点，确保您的设置兼容且是最新的：
SQL接口组件（包括驱动程序、连接器和MongoDB SQL模式构建者）没有正式的 EOL。相反，它们的生命周期与它们设计使用的MongoDB服务器版本和语言运行时的兼容性有关。
在该服务器版本生命周期结束后， SQL接口组件在MongoDB服务器版本长达 3 年内仍与该版本兼容。要学习；了解更多信息，请参阅MongoDB软件生命周期安排。
我们建议将SQL接口组件升级到最新版本，尤其是在升级MongoDB服务器时。这样可以确保访问新功能、性能增强和长期兼容性。要查看最新版本，请访问MongoDB下载中心。
SQL Interface 组件的后续版本可能会取消对早期 MongoDB 服务器版本的支持。我们建议查看 SQL Interface 变更日志，以随时了解兼容性更改和升级要求。
传统选项
MongoDB Connector for BI 是用于将 BI 分析工具连接到 MongoDB 数据库或集群的旧版工具。BI Connector 将于 2026 年 9 月停止支持 (EOL)。