本文对云数据库 MySQL 版的参数修改规则进行集中说明。

以下参数仅支持在最新版本的实例中修改

如进行批量修改时遇到此类参数，则仅在新版本实例中生效，旧版本实例会忽略此修改。

参数名	实例版本	参数默认值	是否需要重启
loose_innodb_data_file_logic_drop	MySQL 8.0，MySQL 8.4	OFF	否
loose_innodb_data_file_logic_drop_max_size	MySQL 8.0，MySQL 8.4	1024	否
loose_thread_pool_enabled	MySQL 5.7，MySQL 8.0，MySQL 8.4	ON	MySQL 5.7： MySQL 5.7.44_20260415 及以上版本的实例：当 loose_thread_handling_switch_mode 参数的取值为 handling_switch_new 或 handling_switch_all 时，修改该参数无需重启实例；反之则需要重启实例。 MySQL 5.7.44_20260415 以下版本的实例：修改该参数需要重启实例。 MySQL 8.0： MySQL 8.0.32_20260415 及以上版本的实例：当 loose_thread_handling_switch_mode 参数的取值为 handling_switch_new 或 handling_switch_all 时，修改该参数无需重启实例；反之则需要重启实例。 MySQL 8.0.32_20260415 以下版本的实例：修改该参数需要重启实例。 MySQL 8.4：修改该参数需要重启实例。
loose_thread_pool_oversubscribe	MySQL 5.7，MySQL 8.0，MySQL 8.4	16	否
loose_thread_pool_size	MySQL 5.7，MySQL 8.0，MySQL 8.4	-	否
loose_kill_idle_transaction	MySQL 8.0，MySQL 8.4	0	否
loose_rds_performance_schema	MySQL 5.7，MySQL 8.0，MySQL 8.4	ON	是

以下参数需在实例各节点设置一致的值

默认的生效范围为所有节点，不支持仅在只读节点修改。

参数名	实例版本	参数默认值	是否需要重启
auto_increment_increment	MySQL 5.7，MySQL 8.0，MySQL 8.4	1	否
auto_increment_offset	MySQL 5.7，MySQL 8.0，MySQL 8.4	1	否
collation_server	MySQL 5.7，MySQL 8.0，MySQL 8.4	utf8_general_ci	是
lower_case_table_names	MySQL 5.7	1	是
max_execution_time	MySQL 5.7，MySQL 8.0，MySQL 8.4	0	否
replica_net_timeout	MySQL 8.0，MySQL 8.4	60	否
replica_type_conversions	MySQL 8.0，MySQL 8.4	-	否
relay_log_recovery	MySQL 5.7，MySQL 8.0，MySQL 8.4	ON	是
source_verify_checksum	MySQL 8.0，MySQL 8.4	OFF	否
sql_safe_updates	MySQL 5.7，MySQL 8.0，MySQL 8.4	OFF	否
sync_source_info	MySQL 8.0，MySQL 8.4	10000	否
tls_version	MySQL 5.7	TLSv1,TLSv1.1,TLSv1.2	是
innodb_large_prefix	MySQL 5.7	ON	否
default_time_zone	MySQL 5.7，MySQL 8.0，MySQL 8.4	+08:00	是
sql_mode	MySQL 5.7，MySQL 8.0，MySQL 8.4	ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION	否

以下参数的值必须设定为 block_size 的倍数

某些系统变量在设定的值不是指定块（block_size）大小整数倍的值时，在由服务器存储之前会向下舍入到块大小的下一个较小倍数，即 FLOOR(value)* block_size。例如，假设给定变量的块大小为 4096，并将该变量的值设置为 100000（我们假设该变量的最大值大于该数字）。由于 100000 / 4096 = 24.4140625，服务器会在存储之前自动将该值降低到 98304 (24 * 4096)。

在某些情况下，变量的规定最大值是 MySQL 解析器允许的最大值，但不是块大小的精确倍数。在这种情况下，有效最大值是块大小的下一个较小倍数。例如，系统变量的最大值显示为 4294967295 (232-1)，其块大小为 1024。4294967295 / 1024 = 4194303.9990234375，因此，如果将此变量设置为其规定的最大值，则实际存储的值为 4194303 * 1024 = 4294966272。

关于 block_size 的更多详细信息，请参见 MySQL server system variables。

block_size 为 1024

参数名	实例版本	参数默认值	是否需要重启
TRANSACTION_ALLOC_BLOCK_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	8192	否
THREAD_STACK	MySQL 5.7，MySQL 8.0，MySQL 8.4	1048576	是
INNODB_BUFFER_POOL_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	-	否
TRANSACTION_PREALLOC_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	4096	否
MAX_ALLOWED_PACKET	MySQL 5.7，MySQL 8.0，MySQL 8.4	1073741824	否
QUERY_ALLOC_BLOCK_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	8192	否
MAX_HEAP_TABLE_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	67108864	否
NET_BUFFER_LENGTH	MySQL 5.7，MySQL 8.0，MySQL 8.4	16384	否
QUERY_PREALLOC_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	8192	否
RANGE_ALLOC_BLOCK_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	4096	否
QUERY_CACHE_SIZE	MySQL 5.7	0	否

block_size 为 128

参数名
实例版本
参数默认值
是否需要重启
JOIN_BUFFER_SIZE
MySQL 5.7，MySQL 8.0，MySQL 8.4
-
否

block_size 为 100

参数名
实例版本
参数默认值
是否需要重启
KEY_CACHE_AGE_THRESHOLD
MySQL 5.7，MySQL 8.0，MySQL 8.4
300
否

block_size 为 512

参数名
实例版本
参数默认值
是否需要重启
KEY_CACHE_BLOCK_SIZE
MySQL 5.7，MySQL 8.0，MySQL 8.4
1024
否

block_size 为 4096

参数名	实例版本	参数默认值	是否需要重启
READ_BUFFER_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	-	否
BINLOG_CACHE_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	2097152	否
BINLOG_STMT_CACHE_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	32768	否
MAX_BINLOG_CACHE_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	18446744073709547520	否
MAX_BINLOG_STMT_CACHE_SIZE	MySQL 5.7，MySQL 8.0，MySQL 8.4	18400000000000000000	否

innodb_temp_data_file_path 参数的设定限制

参数名	实例版本	参数默认值	是否需要重启
innodb_temp_data_file_path	MySQL 5.7，MySQL 8.0，MySQL 8.4	ibtmp1:50M:autoextend:max:30G	是

支持将 innodb_temp_data_file_path 的值设置为 ibtmp1:LM:autoextend 或者 ibtmp1:LM:autoextend:max:NG。L 和 N 为正整数，L 不小于 12，N 不小于 1。

以下参数不允许设置为空

参数名	实例版本	参数默认值	是否需要重启
slave_type_conversions	MySQL 5.7	-	否
init_connect	MySQL 5.7，MySQL 8.0，MySQL 8.4	-	否
sql_mode	MySQL 5.7，MySQL 8.0，MySQL 8.4	ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION	否

存在依赖关系的参数

以下参数存在依赖关系，在修改时需要兼顾两者的取值，满足依赖规则。

参数	规则
innodb_buffer_pool_instances 和 innodb_page_cleaners	innodb_page_cleaners 不能大于 innodb_buffer_pool_instances。
innodb_io_capacity 和 innodb_io_capacity_max	innodb_io_capacity 不能大于 innodb_io_capacity_max。
innodb_max_dirty_pages_pct_lwm 和 innodb_max_dirty_pages_pct	innodb_max_dirty_pages_pct_lwm 不能大于 innodb_max_dirty_pages_pct。
innodb_temp_data_file_path	该参数的值需按照公式 ibtmp1:50M:autoextend:max:30G 进行配置，限制公式中的 L 和 N 的大小，L 应不小于 12，N 应不小于 1。
performance_schema_max_thread_instances	该参数必须与 loose_rds_performance_schema 配合使用，且只有当 loose_rds_performance_schema 设置为 ON 时才会生效。

其他规则

参数	实例版本	校验规则	是否需要重启
character_set_server collation_server	MySQL 5.7，MySQL 8.0，MySQL 8.4	是否有效的实例创建字符集和字符序，有效则返回转换后值。	是
innodb_io_capacity innodb_io_capacity_max	MySQL 5.7，MySQL 8.0，MySQL 8.4	innodb_io_capacity 不能大于 innodb_io_capacity_max。	否
innodb_page_cleaners innodb_buffer_pool_instances	MySQL 5.7，MySQL 8.0，MySQL 8.4	innodb_page_cleaners 不能大于 innodb_buffer_pool_instances。	是
innodb_max_dirty_pages_pct_lwm innodb_max_dirty_pages_pct	MySQL 5.7，MySQL 8.0，MySQL 8.4	innodb_max_dirty_pages_pct_lwm 不能大于 innodb_max_dirty_pages_pct。	否
innodb_buffer_pool_size	MySQL 5.7，MySQL 8.0，MySQL 8.4	当 innodb_buffer_pool_size 小于 1 GiB 时，innodb_buffer_pool_instances 无论配置任何取值，系统都将强制覆盖为 1。当 innodb_buffer_pool_size 大于等于 1 GiB 时，可以自定义配置 innodb_buffer_pool_instances，该参数取值上限为 64。	否
innodb_buffer_pool_instances	MySQL 5.7，MySQL 8.0，MySQL 8.4			是