文档中心

文档数据库 MongoDB 版

常见问题

实例管理

本文汇总了文档数据库 MongoDB 版实例管理的常见问题。

文档数据库 MongoDB 版和开源 MongoDB 有何差异？

文档数据库 MongoDB 版是一款完全兼容 MongoDB 协议，且具备高可用、高性能的在线云数据库服务。它支持绝大部分的开源 MongoDB 命令操作，可以与任何兼容 MongoDB 的客户端建立连接进行数据存储或执行相应数据库操作。更多关于文档数据库 MongoDB 版的信息，请参见什么是文档数据库 MongoDB 版。

文档数据库 MongoDB 版提供何种实例规格？

文档数据库 MongoDB 版提供了副本集和分片集群两种架构，每种架构的实例都支持多种规格配置，可灵活选择，满足您对不同性能、容量需求和应用场景的要求。更多详情，请参见产品规格。

在同一账号的同一地域下，是否支持设置同名的实例？

支持。文档数据库 MongoDB 版使用实例 ID 作为实例的唯一标识符，每个实例在创建时都会随机生成一个唯一的实例 ID。实例名称支持选填，若不填，默认以实例 ID 作为当前实例的名称，您也可以根据需要自定义实例名称。更多详情，请参见创建实例。

最多支持创建多少个文档数据库 MongoDB 版实例？

文档数据库 MongoDB 版支持批量创建实例，每次最多支持同时创建 10 个实例。具体操作步骤，请参见创建实例。

说明

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

文档数据库 MongoDB 版支持哪些数据库版本？

文档数据库 MongoDB 版当前支持 MongoDB 4.0，4.2，4.4，5.0，6.0，7.0，8.0 和 8.3 版本。建议使用对应数据库版本的客户端来访问，您可以从 MongoDB Drivers 下载各语言的客户端。

如何查看 MongoDB 实例使用的数据库版本？

您可以通过如下步骤查看 MongoDB 实例使用的数据库版本。

通过 Mongo shell 连接 MongoDB 实例。具体操作步骤，请参见通过 Mongo shell 工具连接实例。

执行以下命令查看数据库版本。

db.version()

如何升级 MongoDB 实例的数据库版本，例如从 MongoDB 5.0 版本升级到 MongoDB 6.0 版本？

暂不支持直接 MongoDB 数据库版本（如从 MongoDB 5.0 版本升级至 MongoDB 6.0 版本）。但您可以创建一个新的高版本实例，用新高版本实例替换原低版本实例的方式实现。具体操作步骤如下：

创建一个新的高版本（如 MongoDB 6.0 版本）实例。实例创建方法，请参见创建实例。

通过数据库传输工具 DTS 将原低版本（如 MongoDB 5.0 版本）实例迁移至新的高版本（如 MongoDB 6.0 版本）实例。具体操作步骤，请参见火山引擎版 MongoDB 迁移至火山引擎版 MongoDB。

说明

关于 MongoDB 版本的更多详情，请参见版本介绍。

如何将实例从副本集升级为分片集群？

暂不支持将实例从副本集直接升级为分片集群架构。但您可以创建一个新实例，用新实例替换旧实例的方式实现。具体操作步骤如下：

创建一个新的分片集群实例。实例创建方法，请参见创建实例。

通过数据库传输工具 DTS 将副本集实例数据迁移至新的分片集群实例。具体操作步骤，请参见火山引擎版 MongoDB 迁移至火山引擎版 MongoDB。

说明

关于 MongoDB 实例架构的更多详情，请参见产品架构。

为什么在 MongoDB 控制台上看不见我刚创建成功的实例？

因为您新建实例所属的项目与您在控制台上选择进入的项目不是同一个。

在 MongoDB 控制台上查看实例时，需要先指定目标实例所属项目和所在地域。您可以在控制台右上角的项目和地域下拉列表中，分别选择实例所属的项目和地域。

说明

您可以在创建实例时就指定实例所属的项目，具体操作步骤，请参见创建实例。

您也可以在实例创建成功后，改变实例的所属项目。具体操作步骤，请参见项目资源管理。

为什么备份文件列表中展示的数据备份文件，比实际下载下来的备份文件更大？

MongoDB 的数据备份是以分片形式存储在对象存储 TOS 中的，在 MongoDB 控制台的备份文件列表中所展示的是未压缩的数据备份文件大小；而在您单击获取备份文件后，系统会将 TOS 中的备份文件先进行压缩再提供下载，下载后的文件大小是压缩后的文件大小。

因此，针对数据备份文件，您会看到控制台上展示的备份文件大小（未压缩）比您下载下来的数据备份文大小（已压缩）更大。示例如下：

未压缩数据备份文件大小

已压缩数据备份文件大小

关于如何获取和下载备份文件的操作步骤，请参见管理备份文件。

修改了私有网络所属项目后，为何创建 MongoDB 实例时找不到该私有网络下的子网了？

创建私有网络时可指定项目，但创建子网时不支持指定项目，子网默认与与所属 VPC 在同一项目下。VPC 和子网的项目变更具有独立性，即修改 VPC 所属项目并不会同时修改当前 VPC 下子网的所属项目。更多详情，请参见私有网络项目管理。

因此，若修改了 VPC 所属项目，您还需要将 VPC 下的子网项目也进行相应变更，保证两者所属项目的一致性，否则非全局权限子用户创建云资源（如文档数据库 MongoDB 版）时将无法选择子网或出现异常报错。修改所属项目的具体操作步骤，请参见项目资源管理。

收到实例 oplog 保留窗过小的事件监控告警后该如何处理？

文档数据库 MongoDB 版的 oplog（operations log）存储了数据库中所有对文档的改动操作，用于节点间的主从复制。文档数据库 MongoDB 版默认的 oplog 大小（即 replication.oplogSizeMB 参数值）为实例最大可用存储空间的 10 %（例如，实例的最大可用存储空间为 20 GiB，那么相应的 oplog 大小即为 2 GiB），且 oplog 大小会随着磁盘扩容而自动调整。

oplog 保留窗（也称为 oplog 可用时间）即 oplog 记录表中最老的一条 oplog 和最新的一条 oplog 间的时间差。主从复制需要依赖这个 oplog 窗口，只有在同步源的 oplog 窗口找到期望的 oplog 记录时，从节点才能正常进行同步。如果 oplog 可用时间过短，那么能保留的 oplog 记录则有限，在主从复制时延增大、从库重建等场景下，因缺失所需 oplog 导致主从复制失败的风险则会增加，进而影响实例可用性和数据可靠性。

因此，当实例的 oplog 可用时间不足时，您就会收到 oplog 保留窗过小的事件监控告警消息。收到该事件监控告警后，您需要对实例的 replication.oplogSizeMB 参数值作适当调整，您可以参考如下计算公式估算出replication.oplogSizeMB 参数的建议值。

计算公式

计算示例

说明

为保证实例性能，建议 oplog 大小不要超过实例最大可用存储空间的 30%，若需要的 oplog 大小超过该值，建议扩容实例存储空间。实例变配的具体操作步骤，请参见副本集实例变配和变更分片集群实例配置。

参数 replication.oplogSizeMB 的设置方法，请参见修改实例参数。更多关于 oplog 相关参数的设置建议，请参见 oplog 相关参数设置指南。

replication.oplogSizeMB 建议值 = replication.oplogSizeMB 当前值 × 推荐调整系数

您可以根据如下信息估算出推荐调整系数：

= 推荐的 oplog 可用时间 ➗ 实际的 oplog 可用时间

=（实例当前数据量 ➗ 主从复制常见的同步速率）➗ 实际的 oplog 可用时间。

上述计算公式中各计算项的说明如下表所示。

计算项	说明
实例当前数据量	您可以通过副本集实例上主节点的数据磁盘使用量，或分片集群实例中各 Shard 主节点的数据磁盘使用量之和估算实例当前的数据量。您可以在 MongoDB 控制台上查看实例的数据磁盘使用量监控指标。查看方法，请参见查看监控数据。
主从复制常见的同步速率	主从复制的同步速率表示的是主从节点每小时可以同步的数据量。通常情况下，主从复制时的数据同步速率约为 50 GiB/小时。
oplog 可用时间	您可以在 MongoDB 控制台上查看实例的 Oplog 可用时间监控指标。查看方法，请参见查看监控数据。

最近更新时间：2026.07.22 20:22:56

这个页面对您有帮助吗？

有用

无用