すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB RDS:インスタンスパラメーターの変更

最終更新日:Aug 08, 2026

RDS for MySQL インスタンスのパラメーター設定をコンソールまたは API を通じて変更し、変更履歴を確認できます。インスタンスパラメーターの確認

注意事項

  • インスタンスの安定性を確保するため、コンソールで表示されるパラメーターのみ変更可能です。set global コマンドはサポートされていません。

  • パラメーターを変更する際は、変更可能なパラメーター ページの 有効な値 列を確認してください。また、 を使用して、インスタンス構成の変更に自動的に適応するパラメーター設定も可能です。

  • プライマリインスタンスで変更した一部のパラメーターは、読み取り専用インスタンスに自動的に同期されます。付録:同期されるパラメーター

  • lower_case_table_names パラメーターに関する注意事項:

    • MySQL 5.7、8.0、および 8.4:テーブル名の大文字と小文字の区別は、インスタンス作成時に指定する必要があります(デフォルト値:1、大文字小文字を区別しない)。このパラメーターはインスタンス作成後に変更できず、スペックアップ後も値は変更されません。

    • MySQL 5.6:

      • このパラメーターはインスタンス作成後に変更可能ですが、インスタンスが再起動されます。オフピーク時間帯に変更することを推奨します。

      • 値を 0 から 1 に変更する場合は、事前にインスタンス内の大文字のテーブル名をすべて小文字に変換しておく必要があります。変換を行わないと、既存の大文字のテーブルにアクセスできなくなります。

      • 読み取り専用インスタンスではこのパラメーターを変更できません。プライマリインスタンスで変更を行い、その変更が読み取り専用インスタンスに同期されます。

重要

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

  • 一部のパラメーターはインスタンスを再起動しないと有効になりません変更可能なパラメーター ページの 強制再起動 列を確認してください。再起動により、約 15 秒間の接続が中断されます。アプリケーションに自動再接続メカニズムが備わっていることを確認してください。

  • 再起動を必要としないパラメーターは、新しい接続に対してのみ有効になります。既存の接続は再接続する必要があります。

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

変更可能なパラメーターは、MySQL エンジンのバージョンによって異なります。RDS for MySQL の変更可能なパラメーター一覧

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

  1. インスタンス ページに移動します。上部ナビゲーションバーで RDS インスタンスが配置されているリージョンを選択し、対象の RDS インスタンスを見つけ、インスタンス ID をクリックします。

  2. 左側ナビゲーションウィンドウで、パラメーターの設定 をクリックします。

  3. 以下の操作を実行できます。

    単一パラメーターの変更

    1. 変更可能なパラメーター タブで、変更したいパラメーターを見つけ、シナリオに応じて値を変更します。

      • 鉛筆アイコン pencil適用中のパラメーター値 列でクリックし、推奨される値の範囲に基づいてパラメーター値を入力します。

      • 適用中のパラメーター値 列で、ドロップダウンリストからパラメーター値を選択します。

    2. OK をクリックします。

    3. 変更の送信 をクリックします。表示されるダイアログボックスで、有効開始時刻を選択します。今すぐ有効化する保守時間枠内に有効化する、または 指定時刻に発効 を選択できます。

      説明

      パラメータ変更の定時タスク タブでは、保守時間枠内に有効化する または 指定時刻に発効 を選択したパラメーター変更タスクを確認できます。

    4. (オプション)変更を送信する前にキャンセルするには、変更の取り消し をクリックします。

    テンプレートの適用とエクスポート

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

    RDS では、高性能などのシナリオ向けにシステムパラメーターテンプレートを提供しています。また、カスタムテンプレートを作成して、複数のインスタンスに一括で設定を適用することも可能です。パラメーターテンプレートの使用

    1. [テンプレートの適用]をクリックします。

    2. 適用するパラメーターテンプレートを選択し、OK をクリックします。

      説明
      • ダイアログにはパラメーター数と再起動の要否が表示されます。詳細な変更内容を確認するには、パラメーター変更内容の表示 をクリックします。

      • パラメーターテンプレートが一覧に表示されない場合は、別のリージョンにある可能性があります。テンプレートをインスタンスのリージョンにコピーしてください。パラメーターテンプレートの使用

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

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

    2. 以下のパラメーターを設定します。

      パラメーター

      説明

      テンプレート名

      テンプレート名。8~64 文字。英字、数字、ピリオド(.)、およびアンダースコア(_)を使用可能。英字で始まる必要があります。漢字を含めることはできません。

      説明

      テンプレートの説明。最大 200 文字。

    3. OK をクリックして、リージョン内に新しいパラメーターテンプレートを作成します。

    パラメーターのインポートとエクスポート

    多数のパラメーターを一度に変更する場合や現在の設定を保存する場合は、すべてのパラメーター値を TXT ファイルとしてエクスポートし、ローカルで編集してからインポートして変更を適用します。

    1. パラメーターのエクスポート をクリックして、パラメーターファイルを TXT 形式でエクスポートします。

    2. ファイルを編集した後、パラメーターのインポート をクリックし、ダイアログボックスにファイルの内容を貼り付けます。

    3. OK をクリックします。

    4. 変更の送信 をクリックします。表示されるダイアログボックスで、変更の有効開始時刻を選択します。今すぐ有効化する保守時間枠内に有効化する、または 指定時刻に発効 を選択できます。

      説明

      パラメータ変更の定時タスク タブでは、保守時間枠内に有効化する または 指定時刻に発効 を選択したパラメーター変更タスクを確認できます。

    5. (オプション)変更を送信する前にキャンセルするには、変更の取り消し をクリックします。

      重要

      Operation failed. The specified parameter format is invalid. というエラーメッセージが表示された場合は、入力したパラメーター値が パラメータ値の範囲 の範囲内かどうかを確認してください。

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

  1. ApsaraDB RDS コンソール にログインします。左側ナビゲーションウィンドウで インスタンス をクリックします。上部ナビゲーションバーで RDS インスタンスが配置されているリージョンを選択します。

  2. 複数のターゲットインスタンスの左側にあるチェックボックスをオンにし、ページ下部の 変更の送信 をクリックします。

    説明

    バッチでのパラメーター変更を行うインスタンスは、同じバージョンおよびシリーズである必要があります。そうでない場合、パラメーターの変更 ボタンがグレーアウトされ、クリックできなくなります。

  3. 表示される パラメーターの設定 ページで、変更するパラメーター名の右端にある Edit アイコンをクリックします。

  4. ボックスで新しい値を選択または入力し、OK をクリックします。

  5. 表示される パラメーターの設定 ウィンドウで変更内容を確認し、OK をクリックします。

変更履歴の確認

  1. インスタンス ページに移動します。上部ナビゲーションバーで RDS インスタンスが配置されているリージョンを選択し、対象の RDS インスタンスを見つけ、インスタンス ID をクリックします。

  2. 左側ナビゲーションウィンドウで、パラメーターの設定 をクリックします。

  3. 履歴の編集 タブをクリックします。

  4. 期間を選択し、OK をクリックします。

よくある質問

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

一部の変更は再起動なしで約 5 分以内に有効になりますが、他の変更には再起動が必要です。変更可能なパラメーター ページおよび 強制再起動 列を確認し、送信前に要否を確認してください。

パラメーターの変更が適用されないのはなぜですか?

パラメーターの変更は、変更の送信 をクリックした後にのみ適用されます。

High-availability Edition の読み取り専用インスタンスにプライマリインスタンスとセカンダリインスタンスがある場合、両方のパラメーターをどのように設定すればよいですか?

読み取り専用ペアのプライマリインスタンスでのみパラメーターを設定してください。その後、パラメーターがセカンダリインスタンスに自動的に同期されます。

expire_logs_days または binlog_expire_logs_seconds パラメーターを変更したいのですが、RDS コンソールに表示されません。どうすればよいですか?

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

説明

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 というエラーが発生します。どうすればよいですか?

RDS for MySQL は set global コマンドをサポートしていません。コンソールで表示されるパラメーターのみ変更可能です。

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

collation_connection および collation_database を直接変更することはできません。代わりに、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 パラメーターを変更できますか?

いいえ。RDS for MySQL では、レプリケーション時のデータ整合性を維持するために、すべてのセッションで sql_log_bin が強制的に有効になります。

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

wait_timeout パラメーターの変更は、新しい接続に対してのみ適用されます。既存の接続は切断して再接続する必要があります。

クライアントが返す wait_timeout の値がコンソールで設定した値と異なるのはなぜですか?

デフォルトでは、SHOW VARIABLES はパラメーターのセッションレベルの値を返します。これはグローバルレベルの値と異なる場合があります。インタラクティブな接続(mysql コマンドラインクライアントなど)では、wait_timeout のセッションレベルの値が interactive_timeout の初期化値によって上書きされます。たとえば、コンソールで wait_timeout を 86400 に設定し、interactive_timeout をデフォルト値の 7200 のままにした場合、インタラクティブな接続で SHOW VARIABLES LIKE 'wait_timeout' を実行すると、86400 ではなく 7200 が返されます。SHOW GLOBAL VARIABLES LIKE 'wait_timeout' を実行してグローバルパラメーターの値を確認し、設定が有効になっていることを確認してください。

RDS インスタンスで performance_schema パラメーターが有効になっていますが、performance_schema.session_connect_attrs テーブルをクエリしてもレコードが見つかりません。どうすればよいですか?

RDS コンソールで loose_performance_schema_session_connect_attrs_size パラメーターを 0 より大きい値に設定してください。

performance_schema パラメーターを ON に設定しようとした際に InvalidParameters.Prohibited エラーが発生しました。どうすればよいですか?

performance_schema パラメーターは、0 および 1 の値のみを受け付けます。ONOFF などの値はサポートされていません。このパラメーターを有効にするには 1 を、無効にするには 0 を設定してください。ON に設定した後に InvalidParameters.Prohibited エラーが発生した場合は、値を 1 に変更して、再度変更を送信してください。

暗黙の主キー情報を表示するために show_ipk_info パラメーターを有効にするにはどうすればよいですか?

一部のパラメーターはコンソールで変更できず、セッションレベルでのみ有効になります。 show_ipk_info はそのようなパラメーターの 1 つです。このパラメーターはコンソールの 変更可能なパラメーター タブに表示されず、グローバルレベルでの設定もサポートされていません。RDS がテーブルに自動的に作成する暗黙の主キーを表示するには、データベースセッションで次の文を実行します。

SET show_ipk_info=on;

この文を実行した後、SHOW CREATE TABLE を使用するか、information_schema.columns テーブルをクエリして、RDS が自動的に作成する暗黙の主キーカラム (__#alibaba_rds_row_id#__) を確認できます。この設定は現在のセッションでのみ有効です。新しいセッションごとに再度この文を実行する必要があります。

付録:同期されるパラメーター

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

  • lower_case_table_names

    説明

    RDS for MySQL 5.7、8.0、および 8.4 では、テーブル名の大文字と小文字の区別はインスタンス作成時にのみ指定可能であり、lower_case_table_names パラメーターはその後変更できません。MySQL 5.6 のみがプライマリインスタンスでのこのパラメーターの変更をサポートしており、変更内容は読み取り専用インスタンスに同期されます。image

  • innodb_large_prefix

  • loose_validate_password_length

  • default_time_zone

  • rpl_semi_sync_slave_enabled

  • character_set_server

  • collation_server

API リファレンス

API

説明

ModifyParameter

RDS インスタンスのパラメーターを変更します。

DescribeParameterTemplates

データベースパラメーターテンプレートを照会します。

DescribeParameters

インスタンスのパラメーター構成を照会します。