全部产品
Search
文档中心

云原生数据库 PolarDB:什么是文档数据库(兼容MongoDB协议)

更新时间:Aug 06, 2026

PolarDB MySQL版提供了对MongoDB的高度兼容能力,使您的应用程序无需修改业务代码,即可通过标准的文档数据库驱动(如Python的pymongo、Node.js的mongoose以及Go的MongoDB驱动等)无缝接入。该功能在实现API兼容的同时,完整集成了PolarDB云原生数据库在秒级弹性扩缩容、海量数据存储和金融级高可用方面的核心企业级能力,为您提供一个兼具成本效益与强大性能的NoSQL解决方案。

功能简介

PolarDB MySQL版通过数据库代理层与计算节点协同工作,实现对MongoDB API的兼容。理解其工作原理,有助于您更好地利用该功能。

image
  • 数据库代理层 (Proxy)

    该代理层是协议转换的核心。它负责接收来自客户端的BSON请求,完成身份认证、协议解析和请求路由。随后,代理层会将文档数据库操作转换为MySQL可识别的SQL语句,并智能地分发至后端最合适的计算节点。这种设计将协议兼容逻辑与数据库内核解耦,使您能复用PolarDB成熟的连接池、负载均衡和读写分离能力。

  • 数据库计算节点

    计算节点采用一主多从(企业版最多15个只读节点、标准版最多7个只读节点)的高可用架构。主节点处理所有写操作,只读节点分担读请求。计算层基于标准MySQL内核,适配了BSON类型在排序规则、操作符和索引等方面的细微差异。这种最小化改造的设计,确保了功能的可维护性,并能快速跟进MySQL社区的主版本演进。对您而言,无需建库建表,无需定义表结构,提供了与文档数据库一致的Collection管理体验。

优势

  • 平滑迁移,生态兼容:高度兼容 MongoDB API 与生态,您现有的应用和业务系统无需重构代码即可直接接入,并能延续使用 NoSQL 的开发习惯;同时支持 DTS 迁移。

  • 统一数据平台:同一份数据,既支持 NoSQL 方式的灵活读写,也支持标准 SQL 的复杂查询与分析,实现业务数据与分析数据的互通。

  • 秒级弹性与成本效益:采用计算与存储分离架构。

    • 存储空间按实际用量付费,最高可达 1 PB;多个计算节点共享同一份存储,可在分钟级增加只读节点(不受存储量大小影响),扩展性强

    • 计算节点可按需在数分钟内完成规格变更,并支持在固定规格集群上开启Serverless功能,以 PCU(PolarDB Capacity Unit)为单位进行秒级弹性伸缩,有效降低资源成本。

  • 高性能低延迟:读写(RW)与只读(RO)节点共享同一份存储,复制层面无需通过oplog同步数据,节省一份日志的存储与计算开销,性能更高、只读节点数据延迟更低。

  • 智能代理层,透明扩展:代理层自动读写分离,提供透明的扩展能力,业务侧无需区分读写;内置连接池有效解决高频短连接、海量长连接问题;连接保持能力支持无感变配、在线切换。

  • 企业级可靠性:底层基于高性能分布式共享存储与PolarDB成熟的高可用架构,支持秒级数据备份(快照),保障数据安全与业务连续性。

适用范围

在使用文档数据库(兼容MongoDB协议)前,请确保您的集群版本满足以下要求:

  • 内核版本:MySQL 8.0.2,且内核小版本需为8.0.2.2.36及以上。

  • 数据库代理版本:需为2.9.22及以上。

  • 其他限制:Serverless集群暂不支持文档数据库兼容功能。

说明

您可前往PolarDB控制台,在集群的配置与管理 > 版本管理页面中查看对应的版本。若版本不满足要求,请升级对应的小版本。

计费说明

文档数据库(兼容MongoDB协议)本身不产生额外费用。您仅需支付PolarDB MySQL版集群本身的相关计费。

后续操作

了解功能概况后,您可以按照使用说明中的指引,完成集群创建、账号配置和首次连接验证。