Aurora MySQL 配置参数 - Amazon Aurora

Aurora MySQL 配置参数

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

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

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

您可以在控制台中或者使用 CLI 或 RDS API 查看集群级别和实例级别的参数。例如,您可以使用 describe-db-cluster-parameters AWS 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

使用此参数以将释放的内存保留一段时间(以毫秒为单位)。保留内存可以更快地重用。允许的值为 018446744073709551615。默认值(0)将所有内存作为可释放内存返回给操作系统。

此参数适用于 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 密码哈希。允许的值为 01(原定设置)。设置为 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 S3LOAD XML FROM S3SELECT INTO OUTFILE S3 语句时使用。

在 Aurora MySQL 版本 2 中,如果没有为相应语句的 aurora_load_from_s3_roleaurora_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

如果未设置此参数,AWS 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

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 数据库服务器从存储引擎获取数据并替换缓存中的数据前的秒数。允许的值为 031536000

此参数适用于 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。

其值可以是 DYNAMICCOMPACTREDUNDANT.

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

控制哪个内存存储引擎用于内部临时表。允许的值包括 INNODBMYISAM

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

internal_tmp_mem_storage_engine

控制哪个内存存储引擎用于内部临时表。允许的值包括 MEMORYTempTable

此参数适用于 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

INSERTUPDATEDELETELOCK 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 语句的超时时间,以毫秒为单位。值可以为 018446744073709551615。设置为 0 时,没有超时。

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

min_examined_row_limit

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

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

partial_revokes

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

preload_buffer_size

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

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

query_cache_type

已从 Aurora MySQL 版本 3 中删除。

read_only

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

对于 Aurora MySQL 版本 2,有效值如下所示:

  • 0OFF

  • 1ON

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

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

对于 Aurora MySQL 版本 3,有效值如下所示:

  • 0OFF。这是默认值。

  • 1ON

  • {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_LOSSYALL_NON_LOSSYALL_SIGNEDALL_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_timeoutwait_timeout 的最小值,然后使用这个最小值作为超时来结束所有空闲会话,包括交互式会话和非交互式会话。

internal_tmp_disk_storage_engine

控制哪个内存存储引擎用于内部临时表。允许的值包括 INNODBMYISAM

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

internal_tmp_mem_storage_engine

控制哪个内存存储引擎用于内部临时表。允许的值包括 MEMORYTempTable

此参数适用于 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 设置为 STATEMENTMIXEDROW 会自动将 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

INSERTUPDATEDELETELOCK 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 语句的超时时间,以毫秒为单位。值可以为 018446744073709551615。设置为 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 实现基于性能架构 processlist 表。此实现从性能架构而不是线程管理器查询活动的线程数据,并且不需要互斥锁。

此参数适用于 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,有效值如下所示:

  • 0OFF

  • 1ON

  • {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_limitON 时,由 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_timeoutwait_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