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

文档数据库 MongoDB 版和 MongoDB 有什么关系？

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

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

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

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

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

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

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

文档数据库 MongoDB 版是否支持添加或减少节点或分片？

文档数据库 MongoDB 版支持两种实例类型，不同类型的 MongoDB 实例支持的变配方案不同。更多关于 MongoDB 实例支持的变配方案详情，请参见变更实例配置。

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

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

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

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

1. 通过 Mongo Shell 连接 MongoDB 实例。详情请参见通过 Mongo Shell 工具连接实例。

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

   db.version()
   

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

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

1. 创建一个新的 MongoDB 5.0 实例。实例创建方法，请参见创建实例。
2. 通过数据库传输工具 DTS 将源 MongoDB 4.0 实例迁移至新的 MongoDB 5.0 实例。具体操作步骤，请参见火山引擎版 MongoDB 迁移至火山引擎版 MongoDB。

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

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

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

2. 通过数据库传输工具 DTS 将低版本（如 MongoDB 4.0版本）实例迁移至新的高版本（如 MongoDB 5.0版本）。具体操作步骤，请参见火山引擎版 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 %（例如，实例的最大可用存储空间为 20GiB，那么相应的 oplog 大小即为 2GiB），且 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 控制台上查看实例的数据磁盘使用量监控指标。查看方法，请参见查看监控数据。
  主从复制常见的同步速率	主从复制的同步速率表示的是主从节点每小时可以同步的数据量。通常情况下，主从复制时的数据同步速率约为 50GiB/小时。
  oplog 可用时间	您可以在 MongoDB 控制台上查看实例的 Oplog 可用时间监控指标。查看方法，请参见查看监控数据。

• 计算示例
  假设存在一个 MongoDB 副本集实例，实例相关信息如下：

  • 实例当前数据量： 500GiB。
  • 实际的 oplog 可用时间：4 小时。
  • replication.oplogSizeMB 参数当前值：采用动态取值方式，且实例的最大可用存储空间为 1000GiB，replication.oplogSizeMB 参数的当前值即为 1000GiB × 10% = 100GiB。

  那么，当该实例收到 oplog 保留窗过小的事件监控告警后，可大致估算出推荐的调整系数为：500GiB ➗ 50GiB/小时 ➗ 4 小时 = 2.5。
  因此，replication.oplogSizeMB 建议值为：2.5 × 100GiB = 250GiB，即建议您将 replication.oplogSizeMB 参数值调整为 250GiB。