ApsaraDB RDS for MySQL インスタンスのパラメーター構成の変更 - ApsaraDB RDS

ApsaraDB RDS for MySQL では、コンソールまたは API を使用して、パラメーター構成を変更したり、パラメーター変更履歴をクエリしたりできます。これにより、ビジネスニーズに合わせてインスタンスパラメーターを調整できます。インスタンスのパラメーター構成をクエリする方法については、「インスタンスパラメーターの表示」をご参照ください。

注意事項

インスタンスの安定性を確保するため、ApsaraDB RDS コンソールで使用可能なパラメーターのみを変更できます。set global コマンドを使用してパラメーターを変更することはできません。コンソールに表示されない、または編集できないパラメーターは変更できません。
パラメーター値を変更するときは、コンソールの [変更可能なパラメーター] ページの [変更可能なパラメーター値] 列をご参照ください。また、インスタンスパラメーターを式として設定して、パラメーターがインスタンス構成の変更に自動的に適応するようにすることもできます。
一部のパラメーターは、プライマリインスタンスで変更されると、プライマリインスタンスのすべての読み取り専用インスタンスに自動的に同期されます。これらのパラメーターのリストについては、「付録: 読み取り専用インスタンスに自動的に同期されるパラメーターのリスト」をご参照ください。
lower_case_table_names パラメーターの変更に関する注意事項:
- MySQL 8.0 の場合: インスタンスの作成時に、テーブル名で大文字と小文字を区別するかどうかを指定する必要があります。デフォルト値は 1 で、テーブル名で大文字と小文字が区別されないことを示します。インスタンスの作成後にこのパラメーターを変更することはできません。
- MySQL 5.7 および 5.6 の場合:
  - このパラメーターはインスタンスの作成後に変更できますが、変更にはインスタンスの再起動が必要です。オフピーク時にこのパラメーターを変更することをお勧めします。
  - パラメーター値を 0 から 1 に変更する場合は、事前にインスタンス内の大文字のテーブル名を小文字に変換する必要があります。そうしないと、大文字の名前を持つ既存のテーブルにアクセスできなくなります。
  - 読み取り専用インスタンスではこのパラメーターを変更できません。プライマリインスタンスでこのパラメーターを変更する必要があります。変更は読み取り専用インスタンスに同期されます。

重要

パラメーターの変更と適用には、インスタンスの再起動またはデータベースの再接続が必要になる場合があります。これらの操作はオフピーク時に実行し、アプリケーションに再接続メカニズムがあることを確認してください。

一部のパラメーターは、有効にするためにインスタンスの再起動が必要です。詳細については、コンソールの [変更可能なパラメーター] ページの [再起動が必要] 列をご参照ください。インスタンスを再起動すると、約 30 秒間接続が中断されます。アプリケーションに自動再接続メカニズムが設定されていることを確認してください。
インスタンスの再起動を必要としないパラメーター変更の場合、変更は新しいデータベース接続に対してのみ有効になります。既存のデータベース接続で変更を有効にするには、データベースから切断してから再接続する必要があります。

インスタンスパラメーターの変更

変更可能なインスタンスパラメーターは、MySQL エンジンバージョンによって異なります。詳細については、「ApsaraDB RDS for MySQL で使用可能なパラメーターのリスト」をご参照ください。

単一インスタンスのパラメーターの変更

[インスタンス] ページに移動します。上部のナビゲーションバーで、RDS インスタンスが存在するリージョンを選択します。次に、RDS インスタンスを見つけて、インスタンスの ID をクリックします。
左側のナビゲーションウィンドウで、[パラメーター設定] をクリックします。

次の操作を実行できます:

単一パラメーターの変更

[変更可能なパラメーター] タブで、変更するパラメーターを見つけ、次のいずれかの方法で値を変更します:
- [実行中のパラメータ値] 列のアイコンをクリックし、有効値の範囲に基づいて値を入力します。
- [実行中のパラメーター値] 列のドロップダウンリストから値を選択します。
[OK] をクリックします。
[パラメーターの送信] をクリックします。表示されるダイアログボックスで、[すぐに有効にする]、[メンテナンス期間中に有効にする]、または [指定した時間に有効にする] を選択します。
説明
[パラメーター変更のスケジュールされたタスク] タブで、[メンテナンス期間中に有効にする] または [指定した時間に有効にする] を選択したパラメーター変更タスクを表示できます。
(オプション) パラメーターの変更を送信する前に、[取り消し] をクリックしてキャンセルできます。

パラメーターテンプレートの適用とエクスポート

パラメーターテンプレートの適用

ApsaraDB RDS は、高性能を必要とするシナリオなど、さまざまなビジネスシナリオの要件を満たすために、さまざまなシステムパラメーターテンプレートを提供します。また、カスタムパラメーターテンプレートを作成して、一度に複数のパラメーターを構成することもできます。詳細については、「パラメーターテンプレートの使用」をご参照ください。

[テンプレートの適用] をクリックします。
パラメーターテンプレートを選択し、[OK] をクリックします。
説明
- テンプレート内のパラメーターの数を表示し、新しいパラメーター値を有効にするためにインスタンスを再起動する必要があるかどうかを確認できます。パラメーターの変更に関する詳細を表示するには、[変更されたパラメーターの表示] をクリックします。
- 目的のパラメーターテンプレートが見つからない場合は、テンプレートとインスタンスが同じリージョンにあるかどうかを確認してください。異なるリージョンにある場合は、パラメーターテンプレートをインスタンスが存在するリージョンにコピーできます。詳細については、「パラメーターテンプレートの使用」をご参照ください。

パラメーターテンプレートのエクスポート

[テンプレートとしてエクスポート] をクリックします。

次のパラメーターを構成します。

パラメーター	説明
テンプレート名	テンプレートの名前。名前は文字で始まる必要があり、文字、数字、ピリオド (.)、アンダースコア (_) を含めることができます。名前には中国語文字を含めることはできず、長さは 8〜64 文字である必要があります。
説明	テンプレートの説明。これはテンプレートの管理に役立ちます。説明は最大 200 文字です。

[OK] をクリックします。現在のリージョンに新しいパラメーターテンプレートが作成されます。

パラメーターのインポートとエクスポート (TXT フォーマット)

一度に複数のパラメーターを変更したり、インスタンスのパラメーター構成を取得したりするには、パラメーターをローカルの TXT ファイルにエクスポートできます。このファイルには、インスタンスのすべてのパラメーター値が含まれています。ファイル内のパラメーターを変更した後、ファイルを ApsaraDB RDS インスタンスにインポートして変更を適用できます。

[パラメーターのエクスポート] をクリックして、パラメーター構成をローカルの TXT ファイルにエクスポートします。
パラメーター構成ファイルを変更した後、[パラメーターのインポート] をクリックし、ファイルの内容をダイアログボックスに貼り付けます。
[OK] をクリックします。
[パラメーターの送信] をクリックします。表示されるダイアログボックスで、有効になる時間を選択します。[すぐに有効にする]、[メンテナンス期間中に有効にする]、または [指定した時間に有効にする] を選択できます。
説明
[パラメーター変更のスケジュールされたタスク] タブで、[メンテナンス期間中に有効にする] または [指定した時間に有効にする] を選択したパラメーター変更タスクを表示できます。
(オプション) 変更を送信する前に、[取り消し] をクリックしてキャンセルできます。
重要
操作に失敗しました。指定されたパラメーターフォーマットが無効です。 というエラーメッセージが表示された場合は、パラメーターに入力した値が [パラメーター値の範囲] 列で指定された有効範囲内にあるかどうかを確認してください。

複数のインスタンスのパラメーターをバッチで変更する

ApsaraDB RDS コンソールにログインします。左側のナビゲーションウィンドウで、[インスタンス] をクリックします。上部のナビゲーションバーで、RDS インスタンスが存在するリージョンを選択します。
ターゲットインスタンスのチェックボックスを選択し、ページの下部にある [パラメーターの変更] をクリックします。
説明
バッチで変更するインスタンスは、同じデータベースエンジンバージョンと RDS エディションを使用する必要があります。そうしないと、[パラメーターの変更] ボタンがグレー表示されます。
[パラメーター設定] ダイアログボックスで、変更するパラメーターの名前の横にあるアイコンをクリックします。
[構成値] フィールドで、新しい値を選択または入力し、[OK] をクリックします。
[パラメーター設定] ダイアログボックスで、変更を確認し、[OK] をクリックします。

パラメーター変更履歴のクエリ

[インスタンス] ページに移動します。上部のナビゲーションバーで、RDS インスタンスが存在するリージョンを選択します。次に、RDS インスタンスを見つけて、インスタンスの ID をクリックします。
左側のナビゲーションウィンドウで、[パラメーター設定] をクリックします。
[パラメーター変更履歴] タブをクリックします。
時間範囲を選択し、[OK] をクリックします。

よくある質問

パラメーターの変更はすぐに有効になりますか？インスタンスの再起動は必要ですか？

一部のパラメーター変更は約 5 分で有効になり、インスタンスの再起動は必要ありません。他のパラメーター変更は、有効にするためにインスタンスの再起動が必要です。詳細については、ApsaraDB RDS コンソールの [変更可能なパラメーター] ページの [再起動が必要] 列をご参照ください。変更を送信する前に、再起動が必要かどうかを確認する必要があります。

パラメーターを変更しても応答がないのはなぜですか？

パラメーター変更タスクは、パラメーター値を設定して [パラメーターの送信] をクリックした後にのみ実行されます。

読み取り専用インスタンスがプライマリノードとセカンダリノードを持つ高可用性 (HA) インスタンスである場合、これら 2 つのノードのパラメーターはどのように設定しますか？

読み取り専用インスタンスのプライマリノードでのみパラメーターを設定する必要があります。パラメーター値はセカンダリノードに自動的に同期されます。セカンダリノードのパラメーターを直接変更することはできません。

expire_logs_days または binlog_expire_logs_seconds パラメーターを変更したいのですが、ApsaraDB RDS コンソールで見つかりません。どうすればよいですか？

expire_logs_days および binlog_expire_logs_seconds パラメーターは、オープンソースの MySQL でローカルバイナリログの保持期間を制御するために使用されますが、ApsaraDB RDS for MySQL はこの目的でこれらのパラメーターを使用しません。ApsaraDB RDS for MySQL インスタンスのバイナリログ保持期間を変更するには、ApsaraDB RDS コンソールでバイナリログ保持ポリシーを設定できます。

説明

ApsaraDB RDS for MySQL インスタンスのログおよびデータバックアップを削除または削減する方法の詳細については、「バックアップの削除または削減」をご参照ください。

lower_case_table_names パラメーターを変更するにはどうすればよいですか？

詳細については、「lower_case_table_names パラメーターの変更に関する注意事項」をご参照ください。

set global コマンドを使用してパラメーターを変更するときに、Access denied; you need (at least one of) the SUPER or SYSTEM_VARIABLES_ADMIN privilege(s) for this operation エラーが報告された場合はどうすればよいですか？

ApsaraDB RDS for MySQL は、set global コマンドを使用したパラメーターの変更をサポートしていません。ApsaraDB RDS コンソールで使用可能なパラメーターのみを変更できます。コンソールに表示されない、または編集できないパラメーターは変更できません。

collation_connection および collation_database パラメーターを変更するにはどうすればよいですか？

ApsaraDB RDS for MySQL では、collation_connection および collation_database パラメーターを直接変更することはできません。ただし、ApsaraDB RDS コンソールで init_connect パラメーターを 'set names utf8mb4'、'set names utf8'、'set default_collation_for_utf8mb4=utf8mb4_general_ci'、'set default_collation_for_utf8mb4=utf8mb4_general_ci;set names utf8mb4'、'set names utf8mb4 collate utf8mb4_general_ci'、または 'set names utf8mb4 COLLATE utf8mb4_bin' などのサポートされている値に設定することで変更できます。

パラメーターを構成すると、新しい接続が作成されるたびに、システムは指定されたコマンドを自動的に実行します。これにより、文字セットと照合順序が変更されます。ただし、アプリケーションがセッションの照合順序を個別に調整しないようにしてください。そうしないと、アプリケーションの後続のセッションレベルの照合順序設定が現在の構成を上書きします。

sql_log_bin パラメーターを変更できますか？

いいえ。ApsaraDB RDS for MySQL は、各セッションからのバイナリログレコードがディスクに永続化されるように、デフォルトですべてのセッションに対して sql_log_bin を強制します。これにより、プライマリ/セカンダリレプリケーションのデータ整合性が保証されます。

wait_timeout パラメーターへの変更が有効にならないのはなぜですか？

wait_timeout パラメーターへの変更は、新しい接続に対してのみ有効になります。既存の接続で変更を有効にするには、データベースから切断してから再接続する必要があります。

付録: 読み取り専用インスタンスに自動的に同期されるパラメーターのリスト

プライマリ ApsaraDB RDS for MySQL インスタンスで次のパラメーターを変更すると、変更はプライマリインスタンスのすべての読み取り専用インスタンスに自動的に同期されます。

lower_case_table_names
説明
ApsaraDB RDS for MySQL 8.0 の場合、テーブル名で大文字と小文字を区別するかどうかは、インスタンスの作成時にのみ指定できます。インスタンスの作成後は、lower_case_table_names パラメーターを変更することはできません。
innodb_large_prefix
loose_validate_password_length
default_time_zone
rpl_semi_sync_slave_enabled
character_set_server
collation_server

API	説明
インスタンスパラメーターの変更	ModifyParameter 操作を呼び出して、RDS インスタンスのパラメーターを変更します。
パラメーターの有効な値とデフォルト値のクエリ	DescribeParameterTemplates 操作を呼び出して、データベースパラメーターテンプレートを表示します。
パラメーター構成のクエリ	DescribeParameters 操作を呼び出して、インスタンスの現在のパラメーター構成をクエリします。

ApsaraDB RDS:インスタンスパラメーターの設定