文档中心

文档数据库 MongoDB 版

产品简介

约束与限制

约束与限制

本文汇总了文档数据库 MongoDB 版的账号配额、功能特性以及数量相关的约束和限制说明。

账号配额

火山引擎平台对每个主账号中的每项服务都设置了默认配额。文档数据库 MongoDB 版服务相关配额限制如下表。

配额项	配额说明
实例数	每个火山引擎主账号在每个地域下默认最多可购买 30 个实例。说明若您需要调整配额购买更多实例，请前往配额中心提交配额申请。

功能特性限制

功能或特性	限制说明
已开服地域	MongoDB 当前已开服地域详情，请参见服务地址。
数据库版本	当前支持 MongoDB 4.0，4.2，4.4，5.0，6.0，7.0 版本。关于 MongoDB 版本的更多详情，请参见版本介绍。说明关于 MongoDB 各版本的更多限制说明，请参见： MongoDB 8.3：MongoDB 8.3 limits and thresholds。 MongoDB 8.0：MongoDB 8.0 limits and thresholds。 MongoDB 7.0：MongoDB 7.0 limits and thresholds。 MongoDB 6.0：MongoDB 6.0 limits and thresholds。 MongoDB 5.0：MongoDB 5.0 limits and thresholds。 MongoDB 4.4：MongoDB 4.4 limits and thresholds。 MongoDB 4.2，4.0：从 MongoDB manual 中下载 MongoDB 4.2 或 4.0 版本的手册文档，在下载文件中找到 /reference/limits 文档进行查看。建议使用对应数据库版本的客户端来访问 MongoDB 实例，您可以从 MongoDB Drivers下载各语言的客户端。
账号角色和权限	文档数据库 MongoDB 版提供了管理员操作权限、集群操作权限、普通操作权限、实例操作权限和备份与恢复操作权限。关于各角色权限的更多详情，请参见账号权限。
变更配置	如果需要变更（包括减少和增加）存储空间，为保证变更后的实例能正常运行，变更后的存储空间容量需大于或等于已使用空间的 1.2 倍。针对副本集实例中，变更只读节点数量操作与实例的其他配置变更操作互斥，即变更节点规格或存储空间时，不支持同时变更只读节点数量。仅当实例中不存在只读节点，且所有 Shard 分片的配置（包括节点规格和存储空间）一样时，才支持开启批量修改 Shard 分片配置功能。关于 MongoDB 支持的实例变配方案详情，请参见实例变配方案概览。
多文档事务	文档数据库 MongoDB 版支持的多文档事务功能，与官方 MongoDB 对应数据库版本支持的多文档事务功能一致。更多详情，请参见 Transactions。
磁盘禁写	当实例磁盘使用率超过 95% 之后，实例会禁止写入数据，此时只允许对实例执行数据读取操作，执行写入数据操作时会出现 Out of diskSpace 报错。更多详情，请参见功能特性。该阈值为产品的固定安全策略，不可调整或关闭。建议配置监控告警，并在使用率达到阈值前及时扩容。具体操作，请参见设置告警。
namespace 总长度	namespace 总长度包含了 <database_namespace>.<collection_namespace> 在内的所有字符总长度。 MongoDB 实例版本不同，支持的 namespace 总长度不同： MongoDB 4.2，4.0：namespace 总长度不得超过 120 个字符。 MongoDB 4.4，5.0，6.0，7.0，8.0 和 8.3：namespace 总长度不得超过 255 个字符。
Shard collection namespace 长度	MongoDB 实例版本不同，支持的 shard collection 名称长度不同。其中： MongoDB 4.0：shard collection 名称长度最大支持 89 个字符。 MongoDB 4.2：shard collection 名称长度最大支持 100 个字符。 MongoDB 4.4，5.0，6.0，7.0，8.0 和 8.3：shard collection 名称长度最大支持 235 个字符。
collection 数量上限	MongoDB 实例版本和规格不同，单个实例中允许使用的 collection 数量上限也不同。其中：说明下述所列的不同版本或规格 MongoDB 实例所支持的 collection 数量上限仅为参考值，在实际业务中还需要考虑实例恢复超时时间、可用内存等因素的影响。 MongoDB 5.0： 2 核 4 GiB：min(25000,X)。 4 核 8 GiB：min(50000,X)。 4 核 16 GiB 及以上规格：min(100000,X)。说明针对 MongoDB 5.0 实例，collection 数量上限还会受到 collection 配置和名称长度的影响，因此上述 min 函数中的 X 计算公式为x=1610241024/(Space occupied by collection_option + Collection name length)，其中： Space occupied by collection_option：通常情况下，新建 collection 时默认的 collection_option 所占空间为 155 个字符，但如您在创建 collection 时额外制定了其他 option，那么所占空间会超过 155 个字符。 Collection name length：MongoDB 5.0 版本的 collection 名称长度取值范围为 3~235 个字符。 MongoDB 4.0，4.2，4.4，6.0，7.0，8.0，8.3： 2 核 4 GiB：25000。 4 核 8 GiB：50000。 4 核 16 GiB 及以上规格：100000。
自定义参数模板数	每个火山引擎主账号在每个地域下最多可以创建 100 个自定义参数模板。更多详情，请参见创建参数模板。
参数模板一次可批量应用的实例数	每个参数模板每次最多可批量应用于 10 个实例。

数量限制

配置项	数量限制
推荐连接数	MongoDB 实例节点规格不同，推荐连接数也不同。关于各规格节点的推荐连接数详情，请参见产品规格。连接数使用达到上限后，系统会拒绝新建的连接。若您需要使用更多的连接数，您可以通过 net.maxIncomingConnections 参数修改实例的单节点最大并发连接数，关于该参数的更多信息，请参见参数支持。您也可以通过升级节点规格获得更大的连接数。
连接地址数	MongoDB 实例类型或连接地址类型不同，支持的连接地址数量也不同。其中：副本集实例默认提供 1 个私网地址，同时支持申请 1 个公网地址。分片集群实例 Mongos：默认为所有 Mongos 节点提供 1 个私网地址，也支持为每个 Mongos 节点申请单独的公网地址。 Shard：支持为每个 Shard 分片申请 1 个私网地址和 1 个公网地址。 ConfigServer：仅支持为 ConfigServer 节点申请 1 个私网地址和 1 个公网地址。关于连接地址的更多详情，请参见连接地址介绍。
只读节点数	每个副本集实实例或分片集群中每个 Shard 分片最多支持使用 5 个只读节点。更多关于只读节点的使用限制详情，请参见 MongoDB 只读节点。
IP 白名单	每个火山引擎主账号在每个地域下最多可以创建 500 个 IP 白名单。每个火山引擎账号在每个地域最多可设置一个默认白名单。新设置的默认白名单会自动顶替原有默认白名单，即原有默认白名单会自动变为非默认白名单。每个白名单中最多添加 1000 个 IP 地址（或 CIDR 格式的 IP 地址段）。每个白名单最多支持绑定 500 个实例。每个白名单每次可最多批量绑定 200 个实例。每个实例最多支持绑定 100 个白名单，但每个实例绑定的所有白名单中，IP 地址或 CIDR 格式的 IP 地址段的总和不可超过 1000 个。每个实例每次可最多批量绑定 100 个白名单。如果一个实例没有绑定任何白名单，表示禁止所有地址访问。
标签数	标签总数量无限制，但每个 MongoDB 实例最多可绑定 50 个标签。
可批量回档的库表或实例数	一次最多选择 50 个实例进行批量回档。单个实例一次最多选择 1000 张表进行回档。

最近更新时间：2026.09.08 15:18:41

这个页面对您有帮助吗？

有用

有用

无用

无用