AWS ドキュメント » Amazon Relational Database Service (RDS) » Aurora のユーザーガイド » Amazon Aurora MySQL の操作 » Amazon Aurora MySQLリファレンス

Amazon Aurora MySQLリファレンス

このリファレンスには、Aurora MySQL のパラメータやステータス変数に関する情報が含まれます。

Amazon Aurora MySQL のパラメータ

Amazon Aurora MySQL DB クラスターは、他の Amazon RDS DB インスタンスを管理するのと同じ方法で、DB パラメータグループのパラメータを使用して管理します。Amazon Aurora は、複数の DB インスタンスを含む DB クラスターを使用する点が他の DB エンジンとは異なります。その結果、Aurora MySQL DB クラスターの管理に使用するパラメータの中には、クラスター全体に適用されるパラメータと、DB クラスター内の特定の DB インスタンスのみに適用されるパラメータがあります。

クラスターレベルのパラメータは、DB クラスターパラメータグループ単位で管理されます。インスタンスレベルのパラメータは、DB パラメータグループ単位で管理されます。Aurora MySQL DB クラスター内の各 DB インスタンスは MySQL データベースエンジンと互換性がありますが、一部の MySQL データベースエンジンパラメータは、クラスターレベルで適用する必要があり、DB クラスターパラメータグループを使用して管理されます。クラスターレベルのパラメータは、Aurora DB クラスター内のインスタンス用の DB パラメータグループには含まれていません。このトピックで後ほど一覧を示します。

クラスターレベルとインスタンスレベルのパラメータは、いずれも AWS マネジメントコンソール、AWS CLI、または Amazon RDS API を使用して管理できます。クラスターレベルのパラメータとインスタンスレベルのパラメータでは、管理のためのコマンドが別です。たとえば、DB クラスターパラメータグループのクラスターレベルパラメータを管理するには、AWS CLI の modify-db-cluster-parameter-group コマンドを使用し、DB クラスター内の DB インスタンスに適用される、DB パラメータグループのインスタンスレベルパラメータを管理するには、AWS CLI の modify-db-parameter-group コマンドを使用します。

クラスターレベルとインスタンスレベルのパラメータは、いずれも AWS マネジメントコンソール、AWS CLI、または Amazon RDS API を使用して表示できます。たとえば、DB クラスターパラメータグループに含まれるクラスターレベルのパラメータを表示するには、AWS CLI の describe-db-cluster-parameters コマンドを使用し、DB クラスター内の DB インスタンスの DB パラメータグループに含まれるインスタンスレベルのパラメータを表示するには、AWS CLI の describe-db-parameters コマンドを使用します。

DB パラメーターグループの詳細については、「DB パラメータグループおよび DB クラスターパラメータグループを使用する」を参照してください。

トピック

• クラスターレベルのパラメータ
• インスタンスレベルのパラメータ

クラスターレベルのパラメータ

次の表は、Aurora MySQL DB クラスター全体に適用されるすべてのパラメータを示しています。

パラメータ名	変更可能	コメント
aurora_enable_replica_log_compression	はい	Aurora グローバルデータベースの一部であるクラスターには適用されません。
aurora_enable_repl_bin_log_filtering	はい	Aurora グローバルデータベースの一部であるクラスターには適用されません。
aurora_enable_zdr	はい	詳細については、「Amazon Aurora MySQL レプリケーションの高可用性に関する考慮事項」を参照してください。
aurora_load_from_s3_role	はい	詳細については、「Amazon S3 バケットのテキストファイルから Amazon Aurora MySQL DB クラスターへのデータのロード」を参照してください。
aurora_select_into_s3_role	はい	詳細については、「Amazon Aurora MySQL DB クラスターから Amazon S3 バケット内のテキストファイルへのデータの保存」を参照してください。
auto_increment_increment	はい
auto_increment_offset	はい
aws_default_lambda_role	はい	詳細については、「Amazon Aurora MySQL DB クラスターからの Lambda 関数の呼び出し」を参照してください。
aws_default_s3_role	はい
binlog_checksum	はい
binlog_format	はい
binlog_row_image	いいえ
binlog_rows_query_log_events	いいえ
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 クラスターは、すべてのデータに対して InnoDB ストレージエンジンを使用します。
innodb_autoinc_lock_mode	はい
innodb_checksums	いいえ
innodb_cmp_per_index_enabled	はい
innodb_commit_concurrency	はい
innodb_data_home_dir	いいえ
innodb_file_per_table	はい
innodb_flush_log_at_trx_commit	はい
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_purge_batch_size	はい
innodb_purge_threads	はい
innodb_rollback_on_timeout	はい
innodb_rollback_segments	はい
innodb_spin_wait_delay	はい
innodb_strict_mode	はい
innodb_support_xa	はい
innodb_sync_array_size	はい
innodb_sync_spin_loops	はい
innodb_table_locks	はい
innodb_undo_directory	いいえ
innodb_undo_logs	はい
innodb_undo_tablespaces	いいえ
lc_time_names	はい
lower_case_table_names	はい
master-info-repository	はい
master_verify_checksum	はい
server_audit_events	はい
server_audit_excl_users	はい
server_audit_incl_users	はい
server_audit_logging	はい
server_id	いいえ
skip-character-set-client-handshake	はい
skip_name_resolve	いいえ
sync_frm	はい
time_zone	はい

インスタンスレベルのパラメータ

次の表は、Aurora MySQL DB クラスターの特定の DB インスタンスに適用されるパラメータの一覧です。

パラメータ名	変更可能	コメント
allow-suspicious-udfs	いいえ
aurora_lab_mode	はい	詳細については、「Amazon Aurora MySQL ラボモード」を参照してください。
aurora_oom_response	はい
autocommit	はい
automatic_sp_privileges	はい
back_log	はい
basedir	いいえ
binlog_cache_size	はい
binlog_max_flush_queue_time	はい
binlog_order_commits	はい
binlog_stmt_cache_size	はい
bulk_insert_buffer_size	はい
concurrent_insert	はい
connect_timeout	はい
core-file	いいえ
datadir	いいえ
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	はい
enforce_gtid_consistency	いいえ
eq_range_index_dive_limit	はい
event_scheduler	はい
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	はい
general_log_file	いいえ
group_concat_max_len	はい
gtid-mode	いいえ
host_cache_size	はい
init_connect	はい
innodb_adaptive_hash_index	はい
innodb_adaptive_max_sleep_delay	はい
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	はい
innodb_change_buffer_max_size	いいえ
innodb_compression_failure_threshold_pct	はい
innodb_compression_level	はい
innodb_compression_pad_pct_max	はい
innodb_concurrency_tickets	はい
innodb_file_format	はい
innodb_flush_log_at_timeout	いいえ
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	はい
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	はい
innodb_random_read_ahead	はい
innodb_read_ahead_threshold	はい
innodb_read_io_threads	いいえ
innodb_read_only	いいえ
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	はい
interactive_timeout	はい
join_buffer_size	はい
keep_files_on_create	はい
key_buffer_size	はい
key_cache_age_threshold	はい
key_cache_block_size	はい
key_cache_division_limit	はい
local_infile	はい
lock_wait_timeout	はい
log-bin	いいえ
log_bin_trust_function_creators	はい
log_bin_use_v1_row_events	はい
log_error	いいえ
log_output	はい
log_queries_not_using_indexes	はい
log_slave_updates	いいえ
log_throttle_queries_not_using_indexes	はい
log_warnings	はい
long_query_time	はい
low_priority_updates	はい
max_allowed_packet	はい
max_binlog_cache_size	はい
max_binlog_size	いいえ
max_binlog_stmt_cache_size	はい
max_connect_errors	はい
max_connections	はい	詳細については、「Aurora MySQL DB インスタンスへの最大接続数」を参照してください。
max_delayed_threads	はい
max_error_count	はい
max_heap_table_size	はい
max_insert_delayed_threads	はい
max_join_size	はい
max_length_for_sort_data	はい
max_prepared_stmt_count	はい
max_seeks_for_key	はい
max_sort_length	はい
max_sp_recursion_depth	はい
max_tmp_tables	はい
max_user_connections	はい
max_write_lock_count	はい
metadata_locks_cache_size	はい
min_examined_row_limit	はい
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	はい
optimizer_prune_level	はい
optimizer_search_depth	はい
optimizer_switch	はい
optimizer_trace	はい
optimizer_trace_features	はい
optimizer_trace_limit	はい
optimizer_trace_max_mem_size	はい
optimizer_trace_offset	はい
performance_schema	はい
pid_file	いいえ
plugin_dir	いいえ
port	いいえ
preload_buffer_size	はい
profiling_history_size	はい
query_alloc_block_size	はい
query_cache_limit	はい
query_cache_min_res_unit	はい
query_cache_size	はい
query_cache_type	はい
query_cache_wlock_invalidate	はい
query_prealloc_size	はい
range_alloc_block_size	はい
read_buffer_size	はい
read_only	いいえ
read_rnd_buffer_size	はい
relay-log	いいえ
relay_log_info_repository	はい
relay_log_recovery	いいえ
safe-user-create	はい
secure_auth	はい
secure_file_priv	いいえ
skip-slave-start	いいえ
skip_external_locking	いいえ
skip_show_database	はい
slave_checkpoint_group	はい
slave_checkpoint_period	はい
slave_parallel_workers	はい
slave_pending_jobs_size_max	はい
slave_sql_verify_checksum	はい
slow_launch_time	はい
slow_query_log	はい
slow_query_log_file	いいえ
socket	いいえ
sort_buffer_size	はい
sql_mode	はい
sql_select_limit	はい
stored_program_cache	はい
sync_binlog	いいえ
sync_master_info	はい
sync_relay_log	はい
sync_relay_log_info	はい
sysdate-is-now	はい
table_cache_element_entry_ttl	いいえ
table_definition_cache	はい
table_open_cache	はい
table_open_cache_instances	はい
temp-pool	はい
thread_handling	いいえ
thread_stack	はい
timed_mutexes	はい
tmp_table_size	はい
tmpdir	いいえ
transaction_alloc_block_size	はい
transaction_prealloc_size	はい
tx_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	はい

適切ではない MySQL パラメータおよびステータス変数

Aurora MySQL と MySQL ではアーキテクチャに違いがあるため、一部の MySQL パラメータおよびステータス変数は Aurora MySQL に適用されません。

以下の MySQL パラメータは Aurora MySQL には適用されません。

• innodb_adaptive_flushing

• innodb_adaptive_flushing_lwm

• innodb_checksum_algorithm

• innodb_doublewrite

• 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_max_dirty_pages_pct

• innodb_use_native_aio

• innodb_write_io_threads

• thread_cache_size

以下の MySQL ステータス変数は Aurora MySQL には適用されません。

• innodb_buffer_pool_bytes_dirty

• innodb_buffer_pool_pages_dirty

• innodb_buffer_pool_pages_flushed

注記

これらのリストは完全なものではありません。

Aurora MySQL イベント

以下は、Aurora MySQL の代表的な待機イベントです。

注記

MySQL の待機イベントで使用される命名規則については、MySQL ドキュメントの「パフォーマンススキーマインストゥルメント命名規則」を参照してください。

io/aurora_redo_log_flush

この待機イベントの場合、セッションは Aurora ストレージにデータを書き込み中です。通常、この待機イベントは Aurora MySQL の書き込み I/O オペレーション用です。

io/aurora_respond_to_client

この待機イベントの場合、スレッドはクライアントに結果セットを返すプロセス中です。

io/file/csv/data

この待機イベントの場合、CSV テーブルに書き込み中のスレッドがあります。CSV テーブルの使用状況を確認してください。通常、このイベントはテーブルでの log_output の設定に伴って発生します。

io/file/innodb/innodb_data_file

この待機ベントの場合、ストレージへの I/O オペレーションを待機中のスレッドがあります。このイベントは I/O 集約型のワークロードでより一般的です。この待機イベントの大半を示す SQL ステートメントは、ディスク集約型のクエリを実行しているか、InnoDB バッファプールからは満たすことができないデータをリクエストしている可能性があります。クエリプランとキャッシュヒット比率を確認する必要があります。詳細については、MySQL ドキュメントの「バッファリングとキャッシュ」を参照してください。

io/file/sql/binlog

この待機イベントの場合、ディスクに書き込み中のバイナリログファイルを待機しているスレッドがあります。

io/socket/sql/client_connection

この待機イベントの場合、スレッドは新しい接続の処理プロセス中です。

io/table/sql/handler

これはテーブル I/O 待機イベントです。通常、この種のイベントにはファイル I/O イベントなどのネストイベントが続きます。パフォーマンススキーマの「原始的」イベントと「分子的」イベントの詳細については、MySQL ドキュメントの「パフォーマンススキーマの原子的および分子的イベント」を参照してください。

lock/table/sql/handler

この待機イベントは、テーブルロック待機イベントハンドラです。パフォーマンススキーマの「原始的」イベントと「分子的」イベントの詳細については、MySQL ドキュメントの「パフォーマンススキーマの原子的および分子的イベント」を参照してください。

synch/cond/mysys/my_thread_var::suspend

この待機イベントの場合、スレッドは条件の待機中に停止されます。たとえば、スレッドがテーブルレベルのロックを待機しているときに、このイベントが発生します。ワークロードを調査し、データベースインスタンスのテーブルロックを取得する可能性があるスレッドを確認することをお勧めします。MySQL のテーブルロックの詳細については、MySQL ドキュメントの「テーブルロックの問題」を参照してください。

synch/cond/sql/MDL_context::COND_wait_status

この待機イベントの場合、テーブルのメタデータロックを待機中のスレッドがあります。詳細については、MySQL ドキュメントの「ロック操作の最適化」を参照してください。

synch/cond/sql/MYSQL_BIN_LOG::COND_done

この待機イベントの場合、ディスクに書き込み中のバイナリログファイルを待機しているスレッドがあります。変化率が非常に高いデータベースではバイナリログ記録の競合が発生する場合があります。

synch/mutex/innodb/aurora_lock_thread_slot_futex

この待機イベントの場合、InnoDB レコードロックを待機しているスレッドがあります。このイベントが発生する場合は、ワークロードの競合がないかどうかデータベースを確認します。詳細については、MySQL ドキュメントの「InnoDB Locking」を参照してください。

synch/mutex/innodb/buf_pool_mutex

この待機イベントの場合、スレッドは InnoDB バッファプールのロックを取得しています。

synch/mutex/sql/LOCK_open

この待機イベントの場合、LOCK_open を使用してデータディクショナリのさまざまなオブジェクトを保護しています。この待機イベントは、これらのロック取得を待機中のスレッドがあることを示します。通常、このイベントはデータディクショナリの競合に伴って発生します。

synch/mutex/sql/LOCK_table_cache

この待機イベントの場合、テーブルキャッシュインスタンスのロック取得を待機中のスレッドがあります。詳細については、MySQL ドキュメントの「MySQL でのテーブルのオープンとクローズの方法」を参照してください。

synch/mutex/sql/LOG

この待機イベントの場合、ログロックを待機中のスレッドがあります。たとえば、スレッドは、スロークエリログファイルに書き込むためにロックを待機している場合があります。

synch/mutex/sql/MYSQL_BIN_LOG::LOCK_commit

この待機イベントの場合、バイナリログにコミットする目的でロック取得を待機中のスレッドがあります。変化率が非常に高いデータベースではバイナリログ記録の競合が発生する場合があります。使用している MySQL のバージョンによっては、バイナリログの整合性と耐久性を保護するために使用される特定のロックがあります。RDS MySQL の場合、バイナリログはレプリケーションと自動バックアッププロセスに使用されます。Aurora MySQL の場合、バイナリログはネイティブのレプリケーションやバックアップに必要ありません。バイナリログはデフォルトで無効になっていますが、これを有効にして外部のレプリケーションや変更データのキャプチャに使用できます。詳細については、MySQL ドキュメントの「バイナリログ」を参照してください。

synch/mutex/sql/MYSQL_BIN_LOG::LOCK_log

この待機イベントの場合、スレッドはバイナリログファイルをアクティブにロックしています。変化率が非常に高いデータベースではバイナリログ記録の競合が発生する場合があります。使用している MySQL のバージョンによっては、バイナリログの整合性と耐久性を保護するために使用される特定のロックがあります。

synch/rwlock/innodb/dict

この待機イベントの場合、InnoDB データディクショナリに保持されている rwlock を待機中のスレッドがあります。

synch/rwlock/innodb/dict sys RW lock

この待機イベントの場合、InnoDB データディクショナリに保持されている rwlock を待機中のスレッドがあります。

synch/rwlock/innodb/dict_operation_lock

この待機イベントの場合、InnoDB データディクショナリのオペレーションのロックを保持しているスレッドがあります。