Aurora MySQL 配置参数 - Amazon Aurora
集群级别的参数实例级参数不适用于 Aurora MySQL 的 MySQL 参数
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

Aurora MySQL 配置参数

您可以使用数据库参数组中的参数按照与管理其他 Amazon RDS MySQL 数据库实例相同的方法管理 Amazon Aurora 数据库集群。Amazon Aurora 不同于其他数据库引擎，因为您具有一个包含多个数据库实例的数据库集群。因此，您用于管理 Aurora MySQL 数据库集群的有些参数将应用于整个集群。其他参数则仅应用于数据库集群中的特定数据库实例。

要管理集群级参数，请使用数据库集群参数组。要管理实例级参数，请使用数据库参数组。Aurora MySQL 数据库集群中的每个数据库实例均与 MySQL 数据库引擎兼容。不过，您在集群级别应用某些 MySQL 数据库引擎参数，并使用数据库集群参数组管理这些参数。您无法在 Aurora 数据库集群中实例的数据库参数组中查找集群级参数。本主题后面提供了集群级参数的列表。

您可以使用Amazon Web Services Management Console、Amazon CLI 或 Amazon RDS API 管理集群级参数和实例级参数。您可以使用单独的命令管理集群级参数和实例级参数。例如，您可以使用 modify-db-cluster-parameter-group CLI 命令来管理数据库集群参数组中的集群级参数。您可以使用 modify-db-parameter-group CLI 命令来为数据库集群中的数据库实例管理数据库参数组中的实例级参数。

您可以在控制台中或者使用 CLI 或 RDS API 查看集群级别和实例级别的参数。例如，您可以使用 describe-db-cluster-parameters Amazon CLI 命令来查看数据库集群参数组中的集群级参数。您可以使用 describe-db-parameters CLI 命令来查看数据库集群中数据库实例的数据库参数组中的实例级参数。

注意

每个默认参数组包含参数组中所有参数的默认值。如果该参数具有此值的“引擎默认值”，请参阅特定版本的 MySQL 或 PostgreSQL 文档获取实际默认值。

除非另有说明，否则下表中列出的参数对于 Aurora MySQL 版本 2 和 3 有效。

有关数据库参数组的更多信息，请参阅 Amazon Aurora 的参数组。有关 Aurora Serverless v1 集群的规则和限制，请参阅Aurora Serverless v1 的参数组。

集群级别的参数

下表显示了适用于整个 Aurora MySQL 数据库集群的所有参数。

参数名称 可修改 备注

aurora_binlog_read_buffer_size

是

仅影响使用二进制日志 (binlog) 复制的集群。有关二进制日志复制的信息，请参阅 Aurora 与 MySQL 之间或 Aurora 与其他 Aurora 数据库集群之间的复制（二进制日志复制）。已从 Aurora MySQL 版本 3 中删除。

aurora_binlog_replication_max_yield_seconds

是

仅影响使用二进制日志 (binlog) 复制的集群。有关二进制日志复制的信息，请参阅 Aurora 与 MySQL 之间或 Aurora 与其他 Aurora 数据库集群之间的复制（二进制日志复制）。

aurora_binlog_replication_sec_index_parallel_workers

是

设置在为具有多个二级索引的大型表复制事务时可用于应用二级索引更改的并行线程总数。默认情况下，此参数设置为 0（禁用）。

此参数可用于 Aurora MySQL 版本 3.06 及更高版本。有关更多信息，请参阅 优化 Aurora MySQL 的二进制日志复制。

aurora_binlog_use_large_read_buffer

是

仅影响使用二进制日志 (binlog) 复制的集群。有关二进制日志复制的信息，请参阅 Aurora 与 MySQL 之间或 Aurora 与其他 Aurora 数据库集群之间的复制（二进制日志复制）。已从 Aurora MySQL 版本 3 中删除。

aurora_disable_hash_join

是

将此参数设置为 ON 可在 Aurora MySQL 版本 2.09 或更高版本中关闭哈希联接优化。版本 3 不支持此参数。有关更多信息，请参阅 Amazon Aurora MySQL 的并行查询。

aurora_enable_replica_log_compression

是

有关更多信息，请参阅 Amazon Aurora MySQL 复制的性能注意事项。不适用于作为 Aurora 全局数据库的一部分的集群。已从 Aurora MySQL 版本 3 中删除。

aurora_enable_repl_bin_log_filtering

是

有关更多信息，请参阅 Amazon Aurora MySQL 复制的性能注意事项。不适用于作为 Aurora 全局数据库的一部分的集群。已从 Aurora MySQL 版本 3 中删除。

aurora_enable_staggered_replica_restart

是

此设置在 Aurora MySQL 版本 3 中可用，但并未使用。

aurora_enable_zdr

是

该设置在 Aurora MySQL 2.10 及更高版本中默认开启。有关更多信息，请参阅“Amazon Aurora MySQL 的零停机重启 (ZDR)”。

aurora_enhanced_binlog

是

将此参数的值设置为 1，以在 Aurora MySQL 版本 3.03.1 及更高版本中开启增强型二进制日志。有关更多信息，请参阅为 Aurora MySQL 设置增强型二进制日志。

aurora_jemalloc_background_thread

是

使用此参数以使后台线程能够执行内存维护操作。允许的值为 0（禁用）和 1（启用）。默认值为 0。

此参数适用于 Aurora MySQL 版本 3.05 及更高版本。

aurora_jemalloc_dirty_decay_ms

是

使用此参数以将释放的内存保留一段时间（以毫秒为单位）。保留内存可以更快地重用。允许的值为 0–18446744073709551615。默认值为 10000 (10 秒)。

您可以使用更短的延迟来帮助避免内存不足问题，但代价是性能会降低。

此参数适用于 Aurora MySQL 版本 3.05 及更高版本。

aurora_jemalloc_tcache_enabled

是

使用此参数，通过绕过内存领域，在线程本地缓存中处理小内存请求（最多 32KiB）。允许的值为 0（禁用）和 1（启用）。默认值为 1。

此参数适用于 Aurora MySQL 版本 3.05 及更高版本。

aurora_load_from_s3_role

是

有关更多信息，请参阅 将数据从 Amazon S3 存储桶中的文本文件加载到 Amazon Aurora MySQL 数据库集群。目前在 Aurora MySQL 版本 3 中不可用。使用 aws_default_s3_role。

aurora_mask_password_hashes_type

是

默认情况下，该设置在 Aurora MySQL 2.11 及更高版本中开启。

使用此设置可在慢速查询和审核日志中屏蔽 Aurora MySQL 密码哈希。允许的值为 0 和 1（默认值）。设置为 1 时，密码将记录为 <secret>。设置为 0 时，密码将记录为哈希（#）值。

aurora_select_into_s3_role

是

有关更多信息，请参阅 将数据从 Amazon Aurora MySQL 数据库集群保存到 Amazon S3 存储桶中的文本文件。目前在 Aurora MySQL 版本 3 中不可用。使用 aws_default_s3_role。

authentication_kerberos_caseins_cmp

是

控制 authentication_kerberos 插件不区分大小写的用户名比较。将它设置为 true 以进行不区分大小写的比较。默认情况下，使用区分大小写的比较（false）。有关更多信息，请参阅 对 Aurora MySQL 使用 Kerberos 身份验证。

此参数适用于 Aurora MySQL 版本 3.03 及更高版本。

auto_increment_increment

支持

auto_increment_offset

是

aws_default_lambda_role

是

有关更多信息，请参阅“从 Amazon Aurora MySQL 数据库集群中调用 Lambda 函数”。

aws_default_s3_role

 是

从数据库集群调用 LOAD DATA FROM S3、LOAD XML FROM S3 或 SELECT INTO OUTFILE S3 语句时使用。

在 Aurora MySQL 版本 2 中，如果没有为相应语句的 aurora_load_from_s3_role 或 aurora_select_into_s3_role 指定 IAM 角色，则使用在该参数中指定的 IAM 角色。

在 Aurora MySQL 版本 3 中，始终使用为该参数指定的 IAM 角色。

有关更多信息，请参阅 将 IAM 角色与 Amazon Aurora MySQL 数据库集群关联。

binlog_backup

是

将此参数的值设置为 0，以在 Aurora MySQL 版本 3.03.1 及更高版本中开启增强型二进制日志。您只能在使用增强型二进制日志时关闭此参数。有关更多信息，请参阅 为 Aurora MySQL 设置增强型二进制日志。

binlog_checksum

是

如果未设置此参数，Amazon CLI 和 RDS API 将报告 None 的值。在这种情况下，Aurora MySQL 会使用引擎默认值，即 CRC32。这与关闭校验和的显式设置 NONE 不同。

binlog-do-db

是

此参数适用于 Aurora MySQL 版本 3。

binlog_format

是

有关更多信息，请参阅Aurora 与 MySQL 之间或 Aurora 与其他 Aurora 数据库集群之间的复制（二进制日志复制）。

binlog_group_commit_sync_delay

是

此参数适用于 Aurora MySQL 版本 3。

binlog_group_commit_sync_no_delay_count

是

此参数适用于 Aurora MySQL 版本 3。

binlog-ignore-db

是

此参数适用于 Aurora MySQL 版本 3。

binlog_replication_globaldb

是

将此参数的值设置为 0，以在 Aurora MySQL 版本 3.03.1 及更高版本中开启增强型二进制日志。您只能在使用增强型二进制日志时关闭此参数。有关更多信息，请参阅为 Aurora MySQL 设置增强型二进制日志。

binlog_row_image

否

binlog_row_metadata

是

此参数适用于 Aurora MySQL 版本 3。

binlog_row_value_options

是

此参数适用于 Aurora MySQL 版本 3。

binlog_rows_query_log_events

支持

binlog_transaction_compression

是

此参数适用于 Aurora MySQL 版本 3。

binlog_transaction_compression_level_zstd

是

此参数适用于 Aurora MySQL 版本 3。

binlog_transaction_dependency_history_size

是

此参数设置了保留在内存中的行哈希数的上限，这些哈希值用于查找上次修改给定行的事务。达到这个哈希数后，历史记录将被清除。

此参数适用于 Aurora MySQL 版本 2.12 及更高版本以及版本 3。

binlog_transaction_dependency_tracking

是

此参数适用于 Aurora MySQL 版本 3。

character-set-client-handshake

支持

character_set_client

是

character_set_connection

是

character_set_database

是

默认数据库使用的字符集。默认值为 utf8mb4。

character_set_filesystem

支持

character_set_results

是

character_set_server

是

collation_connection

是

collation_server

是

completion_type

是

default_storage_engine

否

Aurora MySQL 集群对所有数据使用 InnoDB 存储引擎。

enforce_gtid_consistency

有时

在 Aurora MySQL 版本 2 及更高版本中可修改。

event_scheduler

是

指示事件计划程序的状态。

在 Aurora MySQL 版本 3 中，只能在集群级别修改。

gtid-mode

有时

在 Aurora MySQL 版本 2 及更高版本中可修改。

information_schema_stats_expiry

是

MySQL 数据库服务器从存储引擎获取数据并替换缓存中的数据前的秒数。允许的值为 0–31536000。

此参数适用于 Aurora MySQL 版本 3。

init_connect

是

服务器要对连接的每个客户端运行的命令。在设置中使用双引号（"）以避免连接失败，例如：

SET optimizer_switch="hash_join=off"

在 Aurora MySQL 版本 3 中，此参数不适用于具有 CONNECTION_ADMIN 权限的用户。这包括 Aurora 主用户。有关更多信息，请参阅 基于角色的权限模型。

innodb_adaptive_hash_index

是

在 Aurora MySQL 版本 2 和 3 中，您可以在数据库集群级别修改此参数。

读取器数据库实例不支持自适应哈希索引。

innodb_aurora_instant_alter_column_allowed

 是

控制 INSTANT 算法是否可用于全局级别的 ALTER COLUMN 操作。允许的值如下所示：

  • 0 – 不允许使用 INSTANT 算法执行 ALTER COLUMN 操作（OFF）。恢复到其它算法。

  • 1 – 允许使用 INSTANT 算法执行 ALTER COLUMN 操作（ON）。这是默认值。

有关更多信息，请参阅 MySQL 文档中的列操作。

此参数适用于 Aurora MySQL 版本 3.05 及更高版本。

innodb_autoinc_lock_mode

是

innodb_checksums

否

已从 Aurora MySQL 版本 3 中删除。

innodb_cmp_per_index_enabled

是

innodb_commit_concurrency

是

innodb_data_home_dir

否

Aurora MySQL 使用不在其中直接访问文件系统的托管式实例。

innodb_deadlock_detect

是

此选项用于在 Aurora MySQL 版本 2.11 及更高版本以及版本 3 中禁用死锁检测。

在高并发系统中，当许多线程等待同一个锁时，死锁检测可能会导致速度下降。有关此参数的更多信息，请参阅 MySQL 文档。

innodb_default_row_format

 是

此参数定义 InnoDB 表（包括用户创建的 InnoDB 临时表）的默认行格式。它适用于 Aurora MySQL 版本 2 和 3。

其值可以是 DYNAMIC、COMPACT 或 REDUNDANT.。

innodb_file_per_table

是

此参数影响表存储的组织方式。有关更多信息，请参阅 存储扩展。

innodb_flush_log_at_trx_commit

是

我们强烈建议您使用默认值 1。

在 Aurora MySQL 版本 3 中，在将此参数设置为 1 以外的值之前，必须先将 innodb_trx_commit_allow_data_loss 的值设置为 1。

有关更多信息，请参阅 配置刷新日志缓冲区的频率。

innodb_ft_max_token_size

是

innodb_ft_min_token_size

是

innodb_ft_num_word_optimize

是

innodb_ft_sort_pll_degree

是

innodb_online_alter_log_max_size

是

innodb_optimize_fulltext_only

是

innodb_page_size

否

innodb_print_all_deadlocks

是

开启后，在 Aurora MySQL 错误日志中记录有关所有 InnoDB 死锁的信息。有关更多信息，请参阅 最大限度地减少 Aurora MySQL 死锁以及排查相关问题。

innodb_purge_batch_size

是

innodb_purge_threads

是

innodb_rollback_on_timeout

是

innodb_rollback_segments

是

innodb_spin_wait_delay

是

innodb_strict_mode

是

innodb_support_xa

是

已从 Aurora MySQL 版本 3 中删除。

innodb_sync_array_size

是

innodb_sync_spin_loops

是

innodb_stats_include_delete_marked

是

启用此参数后，InnoDB 在计算持久优化器统计数据时会包括带有删除标记的记录。

此参数适用于 Aurora MySQL 版本 2.12 及更高版本以及版本 3。

innodb_table_locks

支持

innodb_trx_commit_allow_data_loss

是

在 Aurora MySQL 版本 3 中，将此参数的值设置为 1，这样您就可以更改 innodb_flush_log_at_trx_commit 的值。

innodb_trx_commit_allow_data_loss 的默认值为 0。

有关更多信息，请参阅 配置刷新日志缓冲区的频率。

innodb_undo_directory

否

Aurora MySQL 使用不在其中直接访问文件系统的托管式实例。

internal_tmp_disk_storage_engine

 是

控制哪个内存存储引擎用于内部临时表。支持的值包括 INNODB 和 MYISAM。

此参数适用于 Aurora MySQL 版本 2。

internal_tmp_mem_storage_engine

是

控制哪个内存存储引擎用于内部临时表。支持的值包括 MEMORY 和 TempTable。

此参数适用于 Aurora MySQL 版本 3。

key_buffer_size

是

MyISAM 表的密钥缓存。有关更多信息，请参阅密钥缓存 -> cache_lock 互斥锁。

lc_time_names

是

log_error_suppression_list

是

指定未在 MySQL 错误日志中记录的错误代码列表。这允许您忽略某些非关键错误条件，以帮助保持错误日志干净整洁。有关更多信息，请参阅 MySQL 文档中的 log_error_suppression_list。

此参数适用于 Aurora MySQL 3.03 及更高版本。

low_priority_updates

是

INSERT、UPDATE、DELETE 和 LOCK TABLE WRITE 操作会等待，直至没有待处理的 SELECT 操作。此参数仅影响仅使用表级锁定的存储引擎（MyISAM、MEMORY、MERGE）。

此参数适用于 Aurora MySQL 版本 3。

lower_case_table_names

是（Aurora MySQL 版本 2）

仅在集群创建时（Aurora MySQL 版本 3）

在 Aurora MySQL 版本 2.10 及更高的 2.x 版本中，请确保在更改此设置并重启写入器实例后重启所有读取器实例。有关详细信息，请参阅在具有读取可用性的情况下重启 Aurora 集群。

在 Aurora MySQL 版本 3 中，此参数的值在创建集群时永久设置。如果对此选项使用非默认值，请在升级之前设置 Aurora MySQL 版本 3 自定义参数组，然后在创建版本 3 集群的快照还原操作期间指定参数组。

使用基于 Aurora MySQL 的 Aurora 全局数据库时，如果开启了 lower_case_table_names 参数，则无法执行从 Aurora MySQL 版本 2 到版本 3 的就地升级。有关可以使用的方法的更多信息，请参阅主要版本升级。

master-info-repository

是

已从 Aurora MySQL 版本 3 中删除。

master_verify_checksum

是

Aurora MySQL 版本 2。在 Aurora MySQL 版本 3 中使用 source_verify_checksum。

max_delayed_threads

 是

设置处理 INSERT DELAYED 语句的最大线程数。

此参数适用于 Aurora MySQL 版本 3。

max_error_count

 是

存储以供显示的错误、警告和备注消息的最大数量。

此参数适用于 Aurora MySQL 版本 3。

max_execution_time

 是

运行 SELECT 语句的超时时间，以毫秒为单位。值可以为 0 – 18446744073709551615。设置为 0 时，没有超时。

有关更多信息，请参阅 MySQL 文档中的 max_execution_time。

min_examined_row_limit

 是

使用此参数可防止记录所检查的行数少于指定行数的查询。

partial_revokes

否

此参数适用于 Aurora MySQL 版本 3。

preload_buffer_size

 是

预加载索引时分配的缓冲区的大小。

此参数适用于 Aurora MySQL 版本 3。

query_cache_type

是

已从 Aurora MySQL 版本 3 中删除。

read_only

是

启用此参数时，除副本线程执行的更新外，服务器不允许任何更新。

对于 Aurora MySQL 版本 2，有效值如下所示：

  • 0 – OFF

  • 1 – ON

  • {TrueIfReplica} – ON 适用于只读副本。这是默认值。

  • {TrueIfClusterReplica} – ON 适用于副本集群，例如跨区域只读副本、Aurora Global Database 中的辅助集群以及蓝绿部署。

对于 Aurora MySQL 版本 3，有效值如下所示：

  • 0 – OFF。这是默认值。

  • 1 – ON

  • {TrueIfClusterReplica} – ON 适用于副本集群，例如跨区域只读副本、Aurora Global Database 中的辅助集群，以及蓝绿部署。

在 Aurora MySQL 版本 3 中，此参数不适用于具有 CONNECTION_ADMIN 权限的用户。这包括 Aurora 主用户。有关更多信息，请参阅 基于角色的权限模型。

relay-log-space-limit

是

此参数适用于 Aurora MySQL 版本 3。

replica_parallel_type

 是

此参数对已处于准备阶段的所有未提交线程的副本启用并行执行，而不会违反一致性。它适用于 Aurora MySQL 版本 3。

在 Aurora MySQL 版本 3.03.* 及更低版本中，默认值为 DATABASE。在 Aurora MySQL 版本 3.04 及更高版本中，默认值为 LOGICAL_CLOCK。

replica_preserve_commit_order

是

此参数适用于 Aurora MySQL 版本 3。

replica_transaction_retries

是

此参数适用于 Aurora MySQL 版本 3。

replica_type_conversions

是

此参数决定了副本上使用的类型转换。允许的值为：ALL_LOSSY、ALL_NON_LOSSY、ALL_SIGNED 和 ALL_UNSIGNED。有关更多信息，请参阅 MySQL 文档中的在源和副本上使用不同的表定义进行复制。

此参数适用于 Aurora MySQL 版本 3。

replicate-do-db

是

此参数适用于 Aurora MySQL 版本 3。

replicate-do-table

是

此参数适用于 Aurora MySQL 版本 3。

replicate-ignore-db

是

此参数适用于 Aurora MySQL 版本 3。

replicate-ignore-table

是

此参数适用于 Aurora MySQL 版本 3。

replicate-wild-do-table

是

此参数适用于 Aurora MySQL 版本 3。

replicate-wild-ignore-table

是

此参数适用于 Aurora MySQL 版本 3。

require_secure_transport

是

此参数适用于 Aurora MySQL 版本 2 和 3。有关更多信息，请参阅 与 Aurora MySQL 数据库集群的 TLS 连接。

rpl_read_size

是

此参数适用于 Aurora MySQL 版本 3。

server_audit_cw_upload

否

该参数在 Aurora MySQL 中已弃用。使用 server_audit_logs_upload。

有关更多信息，请参阅 将 Amazon Aurora MySQL 日志发布到 Amazon CloudWatch Logs。

server_audit_events

是

有关更多信息，请参阅 在 Amazon Aurora MySQL 数据库集群中使用高级审计。

server_audit_excl_users

是

有关更多信息，请参阅 在 Amazon Aurora MySQL 数据库集群中使用高级审计。

server_audit_incl_users

是

有关更多信息，请参阅 在 Amazon Aurora MySQL 数据库集群中使用高级审计。

server_audit_logging

是

有关将日志上传到 Amazon CloudWatch Logs 的说明，请参阅将 Amazon Aurora MySQL 日志发布到 Amazon CloudWatch Logs。

server_audit_logs_upload

是

您可以通过启用高级审核并将此参数设置为 1，将审核日志发布到 CloudWatch Logs。server_audit_logs_upload 参数的默认值为 0。

有关更多信息，请参阅 将 Amazon Aurora MySQL 日志发布到 Amazon CloudWatch Logs。

server_id

否

skip-character-set-client-handshake

是

skip_name_resolve

否

slave-skip-errors

是

仅适用于 Aurora MySQL 版本 2 的集群，具备 MySQL 5.7 兼容性。

source_verify_checksum

是

此参数适用于 Aurora MySQL 版本 3。

sync_frm

是

已从 Aurora MySQL 版本 3 中删除。

thread_cache_size

 是 要缓存的线程数。此参数适用于 Aurora MySQL 版本 2 和 3。

time_zone

是

默认情况下，Aurora 数据库集群的时区是协调世界时（UTC）。您可以改为将数据库集群中实例的时区设置为您的应用程序的本地时区。有关更多信息，请参阅 Amazon Aurora 数据库集群的本地时区。

tls_version

是

有关更多信息，请参阅“Aurora MySQL 的 TLS 版本”。

实例级参数

下表显示了适用于 Aurora MySQL 数据库集群中特定数据库实例的所有参数。

参数名称 可修改 备注

activate_all_roles_on_login

是

此参数适用于 Aurora MySQL 版本 3。

allow-suspicious-udfs

否

aurora_disable_hash_join

是

将此参数设置为 ON 可在 Aurora MySQL 版本 2.09 或更高版本中关闭哈希联接优化。版本 3 不支持此参数。有关更多信息，请参阅 Amazon Aurora MySQL 的并行查询。

aurora_lab_mode

是

有关更多信息，请参阅 Amazon Aurora MySQL 实验室模式。已从 Aurora MySQL 版本 3 中删除。

aurora_oom_response

是

Aurora MySQL 版本 2 和 3 支持此参数。有关更多信息，请参阅排查 Aurora MySQL 数据库内存不足问题。

aurora_parallel_query

是

设置为 ON 可在 Aurora MySQL 版本 2.09 或更高版本中开启并行查询。旧的 aurora_pq 参数未在这些版本中使用。有关更多信息，请参阅“Amazon Aurora MySQL 的并行查询”。

aurora_pq

是

设置为 OFF 可在 2.09 之前的 Aurora MySQL 版本中为特定数据库实例关闭并行查询。在 2.09 或更高版本中，改为使用 aurora_parallel_query 打开和关闭并行查询。有关更多信息，请参阅 Amazon Aurora MySQL 的并行查询。

aurora_read_replica_read_committed

是

为 Aurora 副本启用 READ COMMITTED 隔离级别，并更改隔离行为，以在执行长时间运行的查询期间减少清除滞后。仅当您了解行为更改及其对查询结果的影响时，才启用该设置。例如，该设置使用了没有 MySQL 默认设置那么严格的隔离。启用该设置后，长时间运行的查询可能会看到同一行的多个副本，因为 Aurora 会在查询运行期间重组表数据。有关更多信息，请参阅 Aurora MySQL 隔离级别。

aurora_tmptable_enable_per_table_limit

是

确定 tmp_table_size 参数是否控制 Aurora MySQL 版本 3.04 及更高版本中由 TempTable 存储引擎创建的内存中临时表的最大大小。

有关更多信息，请参阅限制内部内存中临时表的大小。

aurora_use_vector_instructions

是

启用此参数后，Aurora MySQL 将使用现代 CPU 提供的优化型矢量处理指令来提高 I/O 密集型工作负载的性能。

默认情况下，会在 Aurora MySQL 版本 3.05 及更高版本中启用该设置。

autocommit

支持

automatic_sp_privileges

是

back_log

是

basedir

否

Aurora MySQL 使用不在其中直接访问文件系统的托管式实例。

binlog_cache_size

是

binlog_max_flush_queue_time

是

binlog_order_commits

是

binlog_stmt_cache_size

是

binlog_transaction_compression

是

此参数适用于 Aurora MySQL 版本 3。

binlog_transaction_compression_level_zstd

是

此参数适用于 Aurora MySQL 版本 3。

bulk_insert_buffer_size

支持

concurrent_insert

是

connect_timeout

是

core-file

否

Aurora MySQL 使用不在其中直接访问文件系统的托管式实例。

datadir

否

Aurora MySQL 使用不在其中直接访问文件系统的托管式实例。

default_authentication_plugin

否

此参数适用于 Aurora MySQL 版本 3。

default_time_zone

否

default_tmp_storage_engine

是

临时表的默认存储引擎。

default_week_format

支持

delay_key_write

是

delayed_insert_limit

是

delayed_insert_timeout

是

delayed_queue_size

是

div_precision_increment

是

end_markers_in_json

是

eq_range_index_dive_limit

是

event_scheduler

有时

指示事件计划程序的状态。

在 Aurora MySQL 版本 3 中，只能在集群级别修改。

explicit_defaults_for_timestamp

是

flush

否

flush_time

是

ft_boolean_syntax

否

ft_max_word_len

是

ft_min_word_len

是

ft_query_expansion_limit

是

ft_stopword_file

是

general_log

是

有关将日志上传到 CloudWatch Logs 的说明，请参阅 将 Amazon Aurora MySQL 日志发布到 Amazon CloudWatch Logs。

general_log_file

否

Aurora MySQL 使用不在其中直接访问文件系统的托管式实例。

group_concat_max_len

是

host_cache_size

是

init_connect

是

服务器要对连接的每个客户端运行的命令。在设置中使用双引号（"）以避免连接失败，例如：

SET optimizer_switch="hash_join=off"

在 Aurora MySQL 版本 3 中，此参数不适用于具有 CONNECTION_ADMIN 权限的用户，包括 Aurora 主用户。有关更多信息，请参阅 基于角色的权限模型。

innodb_adaptive_hash_index

是

在 Aurora MySQL 版本 2 中，您可以在数据库实例级别修改此参数。在 Aurora MySQL 版本 3 中，只能在数据库集群级别修改此参数。

读取器数据库实例不支持自适应哈希索引。

innodb_adaptive_max_sleep_delay

是

修改此参数不起作用，因为 Aurora 的 innodb_thread_concurrency 始终为 0。

innodb_aurora_max_partitions_for_range

 是

在某些无法获得持久统计数据的情况下，您可以使用此参数来提高分区表的行计数估计性能。

您可以将其设置为 0–8192 之间的值，该值决定了在行计数估计期间要检查的分区数。默认值为 0，这将使用所有分区进行估计，与默认 MySQL 行为一致。

此参数适用于 Aurora MySQL 版本 3.03.1 及更高版本。

innodb_autoextend_increment

是

innodb_buffer_pool_dump_at_shutdown

否

innodb_buffer_pool_dump_now

否

innodb_buffer_pool_filename

否

innodb_buffer_pool_load_abort

否

innodb_buffer_pool_load_at_startup

否

innodb_buffer_pool_load_now

否

innodb_buffer_pool_size

是

默认值由公式表示。有关公式中 DBInstanceClassMemory 值的计算方式详细信息，请参阅 数据库参数公式变量。

innodb_change_buffer_max_size

否

Aurora MySQL 完全不使用 InnoDB 更改缓冲区。

innodb_compression_failure_threshold_pct

是

innodb_compression_level

是

innodb_compression_pad_pct_max

是

innodb_concurrency_tickets

是

修改此参数不起作用，因为 Aurora 的 innodb_thread_concurrency 始终为 0。

innodb_deadlock_detect

是

此选项用于在 Aurora MySQL 版本 2.11 及更高版本以及版本 3 中禁用死锁检测。

在高并发系统中，当许多线程等待同一个锁时，死锁检测可能会导致速度下降。有关此参数的更多信息，请参阅 MySQL 文档。

innodb_file_format

是

已从 Aurora MySQL 版本 3 中删除。

innodb_flushing_avg_loops

否

innodb_force_load_corrupted

否

innodb_ft_aux_table

是

innodb_ft_cache_size

是

innodb_ft_enable_stopword

是

innodb_ft_server_stopword_table

是

innodb_ft_user_stopword_table

是

innodb_large_prefix

是

已从 Aurora MySQL 版本 3 中删除。

innodb_lock_wait_timeout

是

innodb_log_compressed_pages

否

innodb_lru_scan_depth

是

innodb_max_purge_lag

是

innodb_max_purge_lag_delay

是

innodb_monitor_disable

是

innodb_monitor_enable

是

innodb_monitor_reset

是

innodb_monitor_reset_all

是

innodb_old_blocks_pct

是

innodb_old_blocks_time

是

innodb_open_files

是

innodb_print_all_deadlocks

是

开启后，在 Aurora MySQL 错误日志中记录有关所有 InnoDB 死锁的信息。有关更多信息，请参阅 最大限度地减少 Aurora MySQL 死锁以及排查相关问题。

innodb_random_read_ahead

是

innodb_read_ahead_threshold

是

innodb_read_io_threads

否

innodb_read_only

否

Aurora MySQL 根据集群类型管理数据库实例的只读和读/写状态。例如，预置的集群具有一个读/写数据库实例（主实例），并且集群中的所有其他实例都是只读的（Aurora 副本）。

innodb_replication_delay

是

innodb_sort_buffer_size

是

innodb_stats_auto_recalc

是

innodb_stats_method

是

innodb_stats_on_metadata

是

innodb_stats_persistent

是

innodb_stats_persistent_sample_pages

是

innodb_stats_transient_sample_pages

是

innodb_thread_concurrency

否

innodb_thread_sleep_delay

是

修改此参数不起作用，因为 Aurora 的 innodb_thread_concurrency 始终为 0。

interactive_timeout

是

Aurora 会估计 interactive_timeout 和 wait_timeout 的最小值，然后使用这个最小值作为超时来结束所有空闲会话，包括交互式会话和非交互式会话。

internal_tmp_disk_storage_engine

 是

控制哪个内存存储引擎用于内部临时表。支持的值包括 INNODB 和 MYISAM。

此参数适用于 Aurora MySQL 版本 2。

internal_tmp_mem_storage_engine

有时

控制哪个内存存储引擎用于内部临时表。写入器数据库实例支持的值为 MEMORY 和 TempTable。

对于读取器数据库实例，此参数设置为 TempTable 且无法修改。

此参数适用于 Aurora MySQL 版本 3。

join_buffer_size

支持

keep_files_on_create

是

key_buffer_size

是

MyISAM 表的密钥缓存。有关更多信息，请参阅密钥缓存 -> cache_lock 互斥锁。

key_cache_age_threshold

是

key_cache_block_size

是

key_cache_division_limit

是

local_infile

是

lock_wait_timeout

是

log-bin

否

将 binlog_format 设置为 STATEMENT、MIXED 或 ROW 会自动将 log-bin 设置为 ON。将 binlog_format 设置为 OFF 会自动将 log-bin 设置为 OFF。有关更多信息，请参阅“Aurora 与 MySQL 之间或 Aurora 与其他 Aurora 数据库集群之间的复制（二进制日志复制）”。

log_bin_trust_function_creators

是

log_bin_use_v1_row_events

是

已从 Aurora MySQL 版本 3 中删除。

log_error

否

log_error_suppression_list

是

指定未在 MySQL 错误日志中记录的错误代码列表。这允许您忽略某些非关键错误条件，以帮助保持错误日志干净整洁。有关更多信息，请参阅 MySQL 文档中的 log_error_suppression_list。

此参数适用于 Aurora MySQL 3.03 及更高版本。

log_output

支持

log_queries_not_using_indexes

是

log_slave_updates

否

Aurora MySQL 版本 2。在 Aurora MySQL 版本 3 中使用 log_replica_updates。

log_replica_updates

否

Aurora MySQL 版本 3

log_throttle_queries_not_using_indexes

支持

log_warnings

是

已从 Aurora MySQL 版本 3 中删除。

long_query_time

是

low_priority_updates

是

INSERT、UPDATE、DELETE 和 LOCK TABLE WRITE 操作会等待，直至没有待处理的 SELECT 操作。此参数仅影响仅使用表级锁定的存储引擎（MyISAM、MEMORY、MERGE）。

此参数适用于 Aurora MySQL 版本 3。

max_allowed_packet

支持

max_binlog_cache_size

是

max_binlog_size

否

max_binlog_stmt_cache_size

是

max_connect_errors

是

max_connections

是

默认值由公式表示。有关公式中 DBInstanceClassMemory 值的计算方式详细信息，请参阅 数据库参数公式变量。如需了解受实例类限制的默认值，请参阅 至 Aurora MySQL 数据库实例的最大连接数。

max_delayed_threads

是

设置处理 INSERT DELAYED 语句的最大线程数。

此参数适用于 Aurora MySQL 版本 3。

max_error_count

是

存储以供显示的错误、警告和备注消息的最大数量。

此参数适用于 Aurora MySQL 版本 3。

max_execution_time

 是

运行 SELECT 语句的超时时间，以毫秒为单位。值可以为 0 – 18446744073709551615。设置为 0 时，没有超时。

有关更多信息，请参阅 MySQL 文档中的 max_execution_time。

max_heap_table_size

支持

max_insert_delayed_threads

是

max_join_size

是

max_length_for_sort_data

是

已从 Aurora MySQL 版本 3 中删除。

max_prepared_stmt_count

是

max_seeks_for_key

是

max_sort_length

是

max_sp_recursion_depth

是

max_tmp_tables

是

已从 Aurora MySQL 版本 3 中删除。

max_user_connections

是

max_write_lock_count

是

metadata_locks_cache_size

是

已从 Aurora MySQL 版本 3 中删除。

min_examined_row_limit

是

使用此参数可防止记录所检查的行数少于指定行数的查询。

此参数适用于 Aurora MySQL 版本 3。

myisam_data_pointer_size

支持

myisam_max_sort_file_size

是

myisam_mmap_size

是

myisam_sort_buffer_size

是

myisam_stats_method

是

myisam_use_mmap

是

net_buffer_length

是

net_read_timeout

是

net_retry_count

是

net_write_timeout

是

old-style-user-limits

是

old_passwords

是

已从 Aurora MySQL 版本 3 中删除。

optimizer_prune_level

是

optimizer_search_depth

是

optimizer_switch

是

有关使用此开关的 Aurora MySQL 功能的信息，请参阅 Amazon Aurora MySQL 的最佳实践。

optimizer_trace

是

optimizer_trace_features

是

optimizer_trace_limit

是

optimizer_trace_max_mem_size

是

optimizer_trace_offset

是

performance-schema-consumer-events-waits-current

是

performance-schema-instrument

是

performance_schema

是

performance_schema_accounts_size

是

performance_schema_consumer_global_instrumentation

是

performance_schema_consumer_thread_instrumentation

是

performance_schema_consumer_events_stages_current

是

performance_schema_consumer_events_stages_history

是

performance_schema_consumer_events_stages_history_long

是

performance_schema_consumer_events_statements_current

是

performance_schema_consumer_events_statements_history

是

performance_schema_consumer_events_statements_history_long

是

performance_schema_consumer_events_waits_history

是

performance_schema_consumer_events_waits_history_long

是

performance_schema_consumer_statements_digest

是

performance_schema_digests_size

是

performance_schema_events_stages_history_long_size

是

performance_schema_events_stages_history_size

是

performance_schema_events_statements_history_long_size

是

performance_schema_events_statements_history_size

是

performance_schema_events_transactions_history_long_size

是

performance_schema_events_transactions_history_size

是

performance_schema_events_waits_history_long_size

是

performance_schema_events_waits_history_size

是

performance_schema_hosts_size

是

performance_schema_max_cond_classes

是

performance_schema_max_cond_instances

是

performance_schema_max_digest_length

是

performance_schema_max_file_classes

是

performance_schema_max_file_handles

是

performance_schema_max_file_instances

是

performance_schema_max_index_stat

是

performance_schema_max_memory_classes

是

performance_schema_max_metadata_locks

是

performance_schema_max_mutex_classes

是

performance_schema_max_mutex_instances

是

performance_schema_max_prepared_statements_instances

是

performance_schema_max_program_instances

是

performance_schema_max_rwlock_classes

是

performance_schema_max_rwlock_instances

是

performance_schema_max_socket_classes

是

performance_schema_max_socket_instances

是

performance_schema_max_sql_text_length

是

performance_schema_max_stage_classes

是

performance_schema_max_statement_classes

是

performance_schema_max_statement_stack

是

performance_schema_max_table_handles

是

performance_schema_max_table_instances

是

performance_schema_max_table_lock_stat

是

performance_schema_max_thread_classes

是

performance_schema_max_thread_instances

是

performance_schema_session_connect_attrs_size

是

performance_schema_setup_actors_size

是

performance_schema_setup_objects_size

是

performance_schema_show_processlist

是

 此参数确定要使用哪个 SHOW PROCESSLIST 实现：

  • 默认实现是在持有全局互斥锁的同时，从线程管理器内部跨活动的线程进行迭代。这可能会导致性能降低，尤其是在繁忙的系统上。

  • 备选 SHOW PROCESSLIST 实现基于 Performance Schema processlist 表。此实现从 Performance Schema 而不是线程管理器查询活动的线程数据，并且不需要互斥锁。

此参数适用于 Aurora MySQL 版本 2.12 及更高版本以及版本 3。

performance_schema_users_size

是

pid_file

否

plugin_dir

否

Aurora MySQL 使用不在其中直接访问文件系统的托管式实例。

port

否

Aurora MySQL 管理连接属性，并为集群中的所有数据库实例强制执行一致的设置。

preload_buffer_size

是

预加载索引时分配的缓冲区的大小。

此参数适用于 Aurora MySQL 版本 3。

profiling_history_size

支持

query_alloc_block_size

是

query_cache_limit

是

已从 Aurora MySQL 版本 3 中删除。

query_cache_min_res_unit

是

已从 Aurora MySQL 版本 3 中删除。

query_cache_size

是

默认值由公式表示。有关公式中 DBInstanceClassMemory 值的计算方式详细信息，请参阅 数据库参数公式变量。

已从 Aurora MySQL 版本 3 中删除。

query_cache_type

是

已从 Aurora MySQL 版本 3 中删除。

query_cache_wlock_invalidate

是

已从 Aurora MySQL 版本 3 中删除。

query_prealloc_size

是

range_alloc_block_size

是

read_buffer_size

是

read_only

是

启用此参数时，除副本线程执行的更新外，服务器不允许任何更新。

对于 Aurora MySQL 版本 2，有效值如下所示：

  • 0 – OFF

  • 1 – ON

  • {TrueIfReplica} – ON 适用于只读副本。这是默认值。

  • {TrueIfClusterReplica} – ON 适用于副本集群中的实例，例如跨区域只读副本、Aurora Global Database 中的辅助集群以及蓝绿部署。

建议您在 Aurora MySQL 版本 2 中使用数据库集群参数组，以确保在失效转移时将 read_only 参数应用于新的写入器实例。

注意

读取器实例始终是只读的，因为 Aurora MySQL 在所有读取器上将 innodb_read_only 设置为 1。因此，read_only 在读取器实例上是冗余的。

已从 Aurora MySQL 版本 3 的实例级别删除。

read_rnd_buffer_size

是

relay-log

否

relay_log_info_repository

是

已从 Aurora MySQL 版本 3 中删除。

relay_log_recovery

否

replica_checkpoint_group

是

Aurora MySQL 版本 3

replica_checkpoint_period

是

Aurora MySQL 版本 3

replica_parallel_workers

是

Aurora MySQL 版本 3

replica_pending_jobs_size_max

是

Aurora MySQL 版本 3

replica_skip_errors

是

Aurora MySQL 版本 3

replica_sql_verify_checksum

是

Aurora MySQL 版本 3

safe-user-create

支持

secure_auth

是

在 Aurora MySQL 版本 2 中，此参数始终处于开启状态。尝试将其关闭会生成错误。

已从 Aurora MySQL 版本 3 中删除。

secure_file_priv

否

Aurora MySQL 使用不在其中直接访问文件系统的托管式实例。

show_create_table_verbosity

是

启用此变量会导致 SHOW_CREATE_TABLE 显示 ROW_FORMAT，而不管它是否为默认格式。

此参数适用于 Aurora MySQL 版本 2.12 及更高版本以及版本 3。

skip-slave-start

否

skip_external_locking

否

skip_show_database

是

slave_checkpoint_group

是

Aurora MySQL 版本 2。在 Aurora MySQL 版本 3 中使用 replica_checkpoint_group。

slave_checkpoint_period

是

Aurora MySQL 版本 2。在 Aurora MySQL 版本 3 中使用 replica_checkpoint_period。

slave_parallel_workers

是

Aurora MySQL 版本 2。在 Aurora MySQL 版本 3 中使用 replica_parallel_workers。

slave_pending_jobs_size_max

是

Aurora MySQL 版本 2。在 Aurora MySQL 版本 3 中使用 replica_pending_jobs_size_max。

slave_sql_verify_checksum

是

Aurora MySQL 版本 2。在 Aurora MySQL 版本 3 中使用 replica_sql_verify_checksum。

slow_launch_time

支持

slow_query_log

是

有关将日志上传到 CloudWatch Logs 的说明，请参阅 将 Amazon Aurora MySQL 日志发布到 Amazon CloudWatch Logs。

slow_query_log_file

否

Aurora MySQL 使用不在其中直接访问文件系统的托管式实例。

socket

否

sort_buffer_size

是

sql_mode

是

sql_select_limit

是

stored_program_cache

是

sync_binlog

否

sync_master_info

是

sync_source_info

是

此参数适用于 Aurora MySQL 版本 3。

sync_relay_log

是

已从 Aurora MySQL 版本 3 中删除。

sync_relay_log_info

是

sysdate-is-now

是

table_cache_element_entry_ttl

否

table_definition_cache

是

默认值由公式表示。有关公式中 DBInstanceClassMemory 值的计算方式详细信息，请参阅 数据库参数公式变量。

table_open_cache

是

默认值由公式表示。有关公式中 DBInstanceClassMemory 值的计算方式详细信息，请参阅 数据库参数公式变量。

table_open_cache_instances

是

temp-pool

是

已从 Aurora MySQL 版本 3 中删除。

temptable_max_mmap

是

此参数适用于 Aurora MySQL 版本 3。有关详细信息，请参阅Aurora MySQL 版本 3 中的新临时表行为。

temptable_max_ram

是

此参数适用于 Aurora MySQL 版本 3。有关详细信息，请参阅Aurora MySQL 版本 3 中的新临时表行为。

temptable_use_mmap

是

此参数适用于 Aurora MySQL 版本 3。有关详细信息，请参阅Aurora MySQL 版本 3 中的新临时表行为。

thread_cache_size

 是 要缓存的线程数。此参数适用于 Aurora MySQL 版本 2 和 3。

thread_handling

否

thread_stack

是

timed_mutexes

是

tmp_table_size

是

在 Aurora MySQL 版本 3 中，定义由 MEMORY 存储引擎创建的内部内存中临时表的最大大小。

在 Aurora MySQL 版本 3.04 及更高版本中，定义当 aurora_tmptable_enable_per_table_limit 为 ON 时，由 TempTable 存储引擎创建的内部内存中临时表的最大大小。

有关更多信息，请参阅 限制内部内存中临时表的大小。

tmpdir

否

Aurora MySQL 使用不在其中直接访问文件系统的托管式实例。

transaction_alloc_block_size

是

transaction_isolation

是

此参数适用于 Aurora MySQL 版本 3。它将代替 tx_isolation。

transaction_prealloc_size

支持

tx_isolation

是

已从 Aurora MySQL 版本 3 中删除。它将替换为 transaction_isolation。

updatable_views_with_limit

是

validate-password

否

validate_password_dictionary_file

否

validate_password_length

否

validate_password_mixed_case_count

否

validate_password_number_count

否

validate_password_policy

否

validate_password_special_char_count

否

wait_timeout

是

Aurora 会估计 interactive_timeout 和 wait_timeout 的最小值，然后使用这个最小值作为超时来结束所有空闲会话，包括交互式会话和非交互式会话。

不适用于 Aurora MySQL 的 MySQL 参数

由于 Aurora MySQL 与 MySQL 之间存在架构差异，有些 MySQL 参数不适用于 Aurora MySQL。

以下 MySQL 参数不适用于 Aurora MySQL。此列表并不详尽。

  • activate_all_roles_on_login – 此参数不适用于 Aurora MySQL 版本 2。它在 Aurora MySQL 版本 3 中可用。

  • big_tables

  • bind_address

  • character_sets_dir

  • innodb_adaptive_flushing

  • innodb_adaptive_flushing_lwm

  • innodb_buffer_pool_chunk_size

  • innodb_buffer_pool_instances

  • innodb_change_buffering

  • innodb_checksum_algorithm

  • innodb_data_file_path

  • innodb_dedicated_server

  • innodb_doublewrite

  • innodb_flush_log_at_timeout – 此参数不适用于 Aurora MySQL。有关更多信息，请参阅 配置刷新日志缓冲区的频率。

  • innodb_flush_method

  • innodb_flush_neighbors

  • innodb_io_capacity

  • innodb_io_capacity_max

  • innodb_log_buffer_size

  • innodb_log_file_size

  • innodb_log_files_in_group

  • innodb_log_spin_cpu_abs_lwm

  • innodb_log_spin_cpu_pct_hwm

  • innodb_log_writer_threads

  • innodb_max_dirty_pages_pct

  • innodb_numa_interleave

  • innodb_page_size

  • innodb_redo_log_capacity

  • innodb_redo_log_encrypt

  • innodb_undo_log_encrypt

  • innodb_undo_log_truncate

  • innodb_undo_logs

  • innodb_undo_tablespaces

  • innodb_use_native_aio

  • innodb_write_io_threads