调整数据库参数

最后更新时间：2025-08-22 18:01:08

调整数据库参数

最后更新时间： 2025-08-22 18:01:08

云数据库 MongoDB 支持对数据库部分参数进行调整，使得数据库特性能更好地适应业务需求。 
背景信息
在日常运维过程中，快速调整数据库的部分参数可以针对性地优化数据库的查询、管理性能，适应时常变化的业务场景。同时，支持随时查看参数的修改历史记录，保证定位异常有据可依。
版本说明
当前 MongoDB 3.2及以上版本均支持对数据库参数进行修改。但每个版本可修改的参数存在差异，以控制台上展示的参数为准。
使用须知
当前参数修改功能仅支持修改后无需重启即可生效的参数，修改后需要重启生效的参数待后期版本更新。您也可通过 MongoDB 终端自行设置，重启会造成连接中断，请提前做好业务安排，谨慎操作。
更新集群架构或配置，例如，调整配置规格、调整节点、调整分片、节点升级、节点迁移等操作，不需要重复进行参数配置，系统将自动同步参数配置的数据。
前提条件
已 申请云数据库 MongoDB 实例。
实例状态运行正常。
调整参数
1. 登录 MongoDB 控制台。
2. 在左侧导航栏，选择副本集实例或者分片实例，二者操作过程类似。
3. 在右侧实例列表中，找到目标实例。
4. 单击目标实例 ID，进入实例详情页面。
5. 切换至参数配置页签，进入可修改参数页面，单击修改运行值。
6. 在当前运行参数值列的输入框，重新设置需修改的参数值。如下图所示。
说明：
您可以同时修改多个参数。
修改参数时，请务必根据参考值设置。
在修改后需重启列，关注是否会重启实例，重启会造成连接中断，请提前做好业务安排，谨慎操作。
﻿
参数生效范围因实例版本与架构有关，当前版本支持修改的参数如下表所示。 
参数名
修改后是否重启
默认值
参考值
支持版本
支持实例类型
适用范围
参数解释
operation.profiling.slowOpThresholdMs
否
100
[0-65536]
4.0、4.2、4.4、5.0、6.0、7.0
副本、分片
mongod、mongos
设置慢查询时间判定时间，单位：毫秒。
operationProfiling.mode
否
off
[off | slowOp | all]
﻿
副本、分片
mongod
该参数用于设置数据库的操作性能分析模式。通过设置不同的模式，可以记录数据库操作的性能数据，以便进行性能优化和故障排查。该参数有以下几种可选值：
off：关闭操作性能分析。
slowOp：记录慢操作，即执行时间超过阈值的操作，默认阈值为100毫秒。
all：记录所有操作的性能数据。
setParameter.cursorTimeoutMillis
否
600000
[1-2147483647]
﻿
副本、分片
mongod、mongos
该参数用于设置游标的最大空闲时间，即游标在一定时间内没有被使用时会被自动关闭，释放相关资源。默认情况下，该参数的值为10分钟。如果需要延长或缩短游标的超时时间，可以通过修改该参数的值来实现。需要注意的是，如果将该参数设置为0，则表示禁用游标超时机制，游标将一直保持打开状态，直到客户端主动关闭为止。
setParameter.intenalQueryExecMaxBlockingSortBytes
否
33554432
[33554432-268435456]
﻿
副本、分片
mongod
该参数控制了 MongoDB 在执行排序操作时所能使用的最大内存量。当 MongoDB 执行一个需要排序的查询时，它可能需要在内存中对结果集进行排序。如果结果集的大小超过了所设置的值，MongoDB 就会使用磁盘来进行排序操作，这可能会导致性能下降。单位：Byte。
setParameter.maxTransactionLockRequestTimeoutMillis
否
5
[0-60]
﻿
副本、分片
mongod
该参数控制了 MongoDB 事务在等待获取锁时的最大超时时间。当一个事务需要获取一个锁时，如果该锁已被其他事务持有，那么该事务就会等待一段时间，尝试获取该锁。如果等待时间超过了该参数设置的值，该事务就会抛出一个超时异常。单位：毫秒。
setParameter.transactionLifetimeLimitSeconds
否
60
[5-300]
﻿
副本、分片
mongod
设置单个事务的最长生命周期，单位：秒。当一个事务开始执行时，MongoDB 会为该事务分配一个唯一的事务 ID，并记录该事务的开始时间。如果该事务在所设置的时间内没有完成，MongoDB 就会自动回滚该事务并释放相关资源。
balance.window
否
NULL
[00:00 | 23:00]
﻿
分片
mongos
MongoDB 集群均衡操作用于将集群中的数据尽可能均匀地分布到各个节点上，以提高集群的性能和可用性。该参数指定 MongoDB 在多长时间内对集群进行一次均衡操作，以确保数据在节点之间的均匀分布。
openBalance.window
否
false
[true | false]
﻿
分片
mongos
启用或禁止 balance 窗口。
setParameter.tcmallocAggressiveMemoryDecommit
否
true
[true | false]
﻿
副本、分片
mongod、mongos
是否开启快速回收内存
cmgo.crossZoneLoadBalancing
否
off
on|off
﻿
分片
mongos
在多个可用区（AZ）之间是否均衡分配读写请求。
cmgo.retainVipWhenSwitchover
否
on
on|off
﻿
副本、分片
mongos
控制主备切换（Switchover/Failover）时是否保持 Virtual IP（VIP）不变。
setParameter.ttlDeleteBatch
否
2147483647
[1-2147483647]
﻿
副本、分片
mongod
控制 TTL (Time-To-Live) 索引在删除过期文档时的批次大小。
setParameter.ttlMonitorSleepSecs
否
60
[60-600]
﻿
副本、分片
mongod
控制 MongoDB TTL 监控线程（TTLMonitor）的运行频率，即该线程每次执行后休眠的秒数。
setParameter.failIndexKeyTooLong
否
true
[true | false]
3.2、3.6、4.0
副本、分片
mongod
设置是否限制索引键的长度。
如果该参数被设置为 true，当 MongoDB 创建一个索引时，如果该索引键的长度超出了 MongoDB 所支持的最大限制，MongoDB 就会抛出一个错误并拒绝创建该索引
storage.wiredTiger.collectionConfig.blockCompressor
是
snappy
[snappy | zlib | zstd]
4.2、4.4、5.0、6.0、7.0
副本、分片
mongod
该参数指定 MongoDB 的 WiredTiger 存储引擎对集合数据使用的块压缩算法（如 snappy、zlib 或 none），用于在磁盘存储时压缩数据块以节省空间。
snappy（默认）：平衡压缩率与 CPU 开销，推荐多数场景。
zlib：更高压缩率，但 CPU 消耗显著增加。
zstd：比 snappy 节省 20%~30% 磁盘空间（视数据类型而定）；解压速度接近 snappy，压缩速度显著快于 zlib。
setParameter.migrateCloneInsertionBatchDelayMS
否
0
[0-5000]
﻿
分片
mongod
该参数控制 MongoDB 分片集群在数据迁移过程中，每次批量插入文档到目标分片后的等待时间（毫秒），用于调节迁移对目标分片的 I/O 压力。
setParameter.rangeDeleterBatchDelayMS
否
20
[0-5000]
﻿
分片
mongod
该参数控制 MongoDB 分片集群在数据迁移完成后，源分片批量删除旧数据块（Chunk）之间的延迟时间（毫秒），用于调节删除操作对源分片的 I/O 压力。
setParameter.rangeDeleterBatchSize
否
128
[0-2147483647]
﻿
分片
mongod
该参数控制 MongoDB 分片集群在数据迁移后，源分片每次批量删除旧数据块（Chunk）的文档数量上限，用于平衡删除效率与集群负载。
setParameter.migrateCloneInsertionBatchSize
否
0
[0-5000]
﻿
分片
mongod
该参数控制 MongoDB 分片集群在数据迁移过程中，目标分片每次批量插入文档的数量上限（单位：文档数），用于平衡迁移速度与目标分片的负载压力。
setParameter.internalQueryMaxBlockingSortMemoryUsageBytes
否
33554432
[33554432-268435456]
﻿
副本、分片
mongod、mongos
该参数控制 MongoDB 在执行阻塞式排序（无法使用索引时）时，单个查询在内存中最多能占用的排序缓冲区大小（单位：字节），超出此限制将触发磁盘临时文件排序。
7. 单击右下角的确定，完成修改。在修改历史页面，可查看看参数修改的历史记录，您可以查看参数修改前后的值、修改状态以及修改时间。
﻿

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

是

否

文档反馈

参数名	修改后是否重启	默认值	参考值	支持版本	支持实例类型	适用范围	参数解释
operation.profiling.slowOpThresholdMs	否	100	[0-65536]	4.0、4.2、4.4、5.0、6.0、7.0	副本、分片	mongod、mongos	设置慢查询时间判定时间，单位：毫秒。
operationProfiling.mode	否	off	[off \| slowOp \| all]			副本、分片	mongod	该参数用于设置数据库的操作性能分析模式。通过设置不同的模式，可以记录数据库操作的性能数据，以便进行性能优化和故障排查。该参数有以下几种可选值： off：关闭操作性能分析。 slowOp：记录慢操作，即执行时间超过阈值的操作，默认阈值为100毫秒。 all：记录所有操作的性能数据。
setParameter.cursorTimeoutMillis	否	600000	[1-2147483647]			副本、分片	mongod、mongos	该参数用于设置游标的最大空闲时间，即游标在一定时间内没有被使用时会被自动关闭，释放相关资源。默认情况下，该参数的值为10分钟。如果需要延长或缩短游标的超时时间，可以通过修改该参数的值来实现。需要注意的是，如果将该参数设置为0，则表示禁用游标超时机制，游标将一直保持打开状态，直到客户端主动关闭为止。
setParameter.intenalQueryExecMaxBlockingSortBytes	否	33554432	[33554432-268435456]			副本、分片	mongod	该参数控制了 MongoDB 在执行排序操作时所能使用的最大内存量。当 MongoDB 执行一个需要排序的查询时，它可能需要在内存中对结果集进行排序。如果结果集的大小超过了所设置的值，MongoDB 就会使用磁盘来进行排序操作，这可能会导致性能下降。单位：Byte。
setParameter.maxTransactionLockRequestTimeoutMillis	否	5	[0-60]			副本、分片	mongod	该参数控制了 MongoDB 事务在等待获取锁时的最大超时时间。当一个事务需要获取一个锁时，如果该锁已被其他事务持有，那么该事务就会等待一段时间，尝试获取该锁。如果等待时间超过了该参数设置的值，该事务就会抛出一个超时异常。单位：毫秒。
setParameter.transactionLifetimeLimitSeconds	否	60	[5-300]			副本、分片	mongod	设置单个事务的最长生命周期，单位：秒。当一个事务开始执行时，MongoDB 会为该事务分配一个唯一的事务 ID，并记录该事务的开始时间。如果该事务在所设置的时间内没有完成，MongoDB 就会自动回滚该事务并释放相关资源。
balance.window	否	NULL	[00:00 \| 23:00]			分片	mongos	MongoDB 集群均衡操作用于将集群中的数据尽可能均匀地分布到各个节点上，以提高集群的性能和可用性。该参数指定 MongoDB 在多长时间内对集群进行一次均衡操作，以确保数据在节点之间的均匀分布。
openBalance.window	否	false	[true \| false]			分片	mongos	启用或禁止 balance 窗口。
setParameter.tcmallocAggressiveMemoryDecommit	否	true	[true \| false]			副本、分片	mongod、mongos	是否开启快速回收内存
cmgo.crossZoneLoadBalancing	否	off	on\|off			分片	mongos	在多个可用区（AZ）之间是否均衡分配读写请求。
cmgo.retainVipWhenSwitchover	否	on	on\|off			副本、分片	mongos	控制主备切换（Switchover/Failover）时是否保持 Virtual IP（VIP）不变。
setParameter.ttlDeleteBatch	否	2147483647	[1-2147483647]			副本、分片	mongod	控制 TTL (Time-To-Live) 索引在删除过期文档时的批次大小。
setParameter.ttlMonitorSleepSecs	否	60	[60-600]			副本、分片	mongod	控制 MongoDB TTL 监控线程（TTLMonitor）的运行频率，即该线程每次执行后休眠的秒数。
setParameter.failIndexKeyTooLong	否	true	[true \| false]	3.2、3.6、4.0	副本、分片	mongod	设置是否限制索引键的长度。如果该参数被设置为 true，当 MongoDB 创建一个索引时，如果该索引键的长度超出了 MongoDB 所支持的最大限制，MongoDB 就会抛出一个错误并拒绝创建该索引
storage.wiredTiger.collectionConfig.blockCompressor	是	snappy	[snappy \| zlib \| zstd]	4.2、4.4、5.0、6.0、7.0	副本、分片	mongod	该参数指定 MongoDB 的 WiredTiger 存储引擎对集合数据使用的块压缩算法（如 snappy、zlib 或 none），用于在磁盘存储时压缩数据块以节省空间。 snappy（默认）：平衡压缩率与 CPU 开销，推荐多数场景。 zlib：更高压缩率，但 CPU 消耗显著增加。 zstd：比 snappy 节省 20%~30% 磁盘空间（视数据类型而定）；解压速度接近 snappy，压缩速度显著快于 zlib。
setParameter.migrateCloneInsertionBatchDelayMS	否	0	[0-5000]			分片	mongod	该参数控制 MongoDB 分片集群在数据迁移过程中，每次批量插入文档到目标分片后的等待时间（毫秒），用于调节迁移对目标分片的 I/O 压力。
setParameter.rangeDeleterBatchDelayMS	否	20	[0-5000]			分片	mongod	该参数控制 MongoDB 分片集群在数据迁移完成后，源分片批量删除旧数据块（Chunk）之间的延迟时间（毫秒），用于调节删除操作对源分片的 I/O 压力。
setParameter.rangeDeleterBatchSize	否	128	[0-2147483647]			分片	mongod	该参数控制 MongoDB 分片集群在数据迁移后，源分片每次批量删除旧数据块（Chunk）的文档数量上限，用于平衡删除效率与集群负载。
setParameter.migrateCloneInsertionBatchSize	否	0	[0-5000]			分片	mongod	该参数控制 MongoDB 分片集群在数据迁移过程中，目标分片每次批量插入文档的数量上限（单位：文档数），用于平衡迁移速度与目标分片的负载压力。
setParameter.internalQueryMaxBlockingSortMemoryUsageBytes	否	33554432	[33554432-268435456]		副本、分片	mongod、mongos	该参数控制 MongoDB 在执行阻塞式排序（无法使用索引时）时，单个查询在内存中最多能占用的排序缓冲区大小（单位：字节），超出此限制将触发磁盘临时文件排序。

tencent cloud

背景信息

版本说明

使用须知

前提条件

调整参数