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

ApsaraDB RDS:ApsaraDB RDS for PostgreSQL インスタンスのパラメーターを変更する

最終更新日:Apr 02, 2025

ApsaraDB RDS for PostgreSQL インスタンスのパフォーマンスを向上させるため、または特定のビジネス要件を満たすために、ApsaraDB RDS コンソールで、または ApsaraDB RDS API を呼び出すことによって、RDS インスタンスのパラメーターを変更できます。 ApsaraDB RDS コンソールでパラメーターの変更履歴を表示することもできます。

使用上の注意

  • 一部のパラメーターの変更は、RDS インスタンスの再起動をトリガーします。 パラメーターを変更して [変更の適用] をクリックすると、RDS インスタンスはすぐに再起動します。 パラメーターの変更によって再起動がトリガーされるかどうかを確認するには、ApsaraDB RDS コンソールにログインし、[変更可能なパラメーター] タブに移動して、パラメーターの [強制再起動] 列の値を表示します。 値が「はい」の場合、パラメーターの変更は再起動をトリガーします。 値が「いいえ」の場合、パラメーターの変更は再起動をトリガーしません。 RDS インスタンスが再起動すると、アプリケーションは RDS インスタンスから切断されます。 RDS インスタンスの再起動前に、ビジネスを調整してください。 注意して進めてください。

  • RDS インスタンスのパラメーターを変更する場合、ApsaraDB RDS コンソールの [パラメーター] ページの [変更可能なパラメーター] タブにあるパラメーターの [値の範囲] 列で、パラメーターの有効な値を表示できます。

  • クラスタのプライマリインスタンスで次のパラメーターを変更すると、変更はクラスタのすべての読み取り専用ノードに同期されます。wal_levelmax_replication_slotsmax_wal_sendersmax_locks_per_transaction

  • パラメーターを変更した後、システムは変更されたパラメーターを適用しようとします。 変更されたパラメーター値が無効であるか、インスタンスの起動をブロックする場合、変更はロールバックされます。 この場合、[編集履歴] タブのパラメーターに対応する [ステータス] 列の値は [失敗] です。

  • log_statement パラメーターは直接変更できません。 SQL Explorer および監査 機能を有効または無効にすることで、このパラメーターの値を変更できます。

パラメーターの変更

  1. ApsaraDB RDS コンソールにログインし、[インスタンス] ページに移動します。 上部のナビゲーションバーで、RDS インスタンスが存在するリージョンを選択します。 次に、RDS インスタンスを見つけて、インスタンス ID をクリックします。

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

  3. [変更可能なパラメーター] タブで、ビジネス要件に基づいて RDS インスタンスのパラメーターを変更します。

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

      • パラメーターを見つけて、[実行中のパラメーター値] 列の アイコンをクリックします。

      • 新しい値を入力し、[OK] をクリックします。

      • [変更の適用] をクリックします。

      • 表示されるダイアログボックスで、新しいパラメーター設定を有効にする時間範囲を選択します。 [すぐに有効にする][メンテナンスウィンドウ内で有効にする]、または [指定した時間に有効にする] を選択できます。 次に、[OK] をクリックします。

    • 一度に複数のパラメーターを再構成する場合、次の手順を実行します。

      • [パラメーターのエクスポート] をクリックして、RDS インスタンスのパラメーター設定をファイルとしてコンピューターにダウンロードします。

      • ファイルを開き、パラメーターを変更します。

      • [パラメーターのインポート] をクリックします。

      • [パラメーターのインポート] ダイアログボックスで、ファイルからコピーしたパラメーター設定を貼り付けます。 次に、[OK] をクリックします。

      • 変更されたパラメーターの値を確認し、[変更の適用] をクリックします。

      • 表示されるダイアログボックスで、新しいパラメーター設定を有効にする時間範囲を選択します。 [すぐに有効にする][メンテナンスウィンドウ内で有効にする]、または [指定した時間に有効にする] を選択できます。 次に、[OK] をクリックします。

説明

[スケジュールされたタスク] タブで、 [メンテナンスウィンドウ内で有効にする] または [指定した時間に有効にする] が選択されている変更タスクを表示できます。

パラメーター構成履歴の表示

  1. ApsaraDB RDS コンソールにログインし、[インスタンス] ページに移動します。 上部のナビゲーションバーで、RDS インスタンスが存在するリージョンを選択します。 次に、RDS インスタンスを見つけて、インスタンス ID をクリックします。

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

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

  4. 時間範囲を選択し、[OK] をクリックします。

式を使用したパラメーターの構成

RDS インスタンスのパラメーターを式に設定できます。 インスタンスタイプ関連のパラメーターを式に設定すると、インスタンスタイプが変更されたときにパラメーターの値が動的に変更されます。

次の表は、サポートされている式の構文を示しています。

カテゴリ

説明

パラメーター

式をサポートするパラメーター

  • work_mem:データが一時ファイルに書き込まれる前に、内部ソート操作とハッシュテーブルによって使用されるメモリ量。

  • maintenance_work_mem:VACUUM や CREATE INDEX などのメンテナンス操作に使用できるメモリの最大量。

  • autovacuum_work_mem:各 autovacuum ワーカープロセスが使用できるメモリの最大量。

  • max_parallel_workers:システムが並列クエリでサポートできるワーカーの最大数。

  • max_parallel_workers_per_gather:単一の Gather または Gather Merge ノードで起動できるワーカーの最大数。

  • effective_cache_size:単一のクエリで使用可能なディスクキャッシュの有効サイズに関するプランナーの想定。

  • autovacuum_max_workers:autovacuum ランチャーを除き、同時に実行できる autovacuum プロセスの最大数。

  • max_wal_size:チェックポイントをトリガーする先行書き込みログ (WAL) ファイルのサイズ。

  • min_wal_size:将来のチェックポイントで再利用するためにリサイクルする WAL ファイルの最小サイズ。 WAL ディスクの使用量がこの設定値を下回っている限り、古い WAL ファイルは常にチェックポイントで将来使用するためにリサイクルされ、削除されません。

  • temp_file_limit:プロセスがソートやハッシュの一時ファイル、または保持されたカーソルのストレージファイルなどの一時ファイルに使用できるディスク容量の最大値。

  • wal_buffers:WAL ファイルの共有メモリ内のディスクページバッファーのサイズ。これは、ディスクに書き込まれていない WAL データに使用される共有メモリの量を示します。

  • max_parallel_maintenance_workers:単一の CREATE INDEX 操作で起動できる並列ワーカーの最大数。

説明

max_parallel_maintenance_workers パラメーターは PostgreSQL 11.0 から PostgreSQL 14.0 でサポートされています。 その他のパラメーターは PostgreSQL 10.0 から PostgreSQL 14.0 でサポートされています。

effective_cache_size

変数

  • AllocatedStorage:インスタンスタイプでサポートされているストレージ容量 (MB 単位)。 この変数の値は整数です。

  • DBInstanceClassMemory:インスタンスタイプでサポートされているメモリ容量 (バイト単位)。 この変数の値は整数です。

  • DBInstanceClassCPU:インスタンスタイプでサポートされているコア数。 この変数の値は整数です。

  • DBInstanceClassConnections:インスタンスタイプでサポートされている最大接続数。 この変数の値は整数です。

説明

インスタンスタイプ、および各インスタンスタイプでサポートされているストレージ容量、メモリ容量、コア数、最大接続数については、プライマリ ApsaraDB RDS for PostgreSQL インスタンスのインスタンスタイプ をご参照ください。

effective_cache_size={DBInstanceClassMemory/16384}

演算子

  • 式の構文:式は一対の中括弧 {} で囲まれます。

  • 除算演算子 (/):この演算子は、数を別の数で割るために使用されます。 商が小数の場合、商は四捨五入されず、整数部分のみがカウントされます。 被除数と除数は小数にすることができます。

  • 乗算演算子 (*):この演算子は、数を別の数で乗算するために使用されます。 積が小数の場合、積は四捨五入されず、整数部分のみがカウントされます。 乗数は小数にすることができます。

関数

  • GREATEST() 関数は、整数配列の最大値、または式配列によって計算された最大値を返します。

  • LEAST() 関数は、整数配列の最小値、または式配列によって計算された最小値を返します。

  • SUM() 関数は、整数、または指定された式によって計算された値を加算します。

max_parallel_workers={GREATEST(DBInstanceClassCPU*3/4, 8)}

関連情報

  • PostgreSQL パラメーターの詳細については、サーバー構成 をご参照ください。

  • API 操作を使用してパラメーターを変更する方法の詳細については、次の表をご参照ください。

    操作

    説明

    ModifyParameter

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

    DescribeParameterTemplates

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

    DescribeParameters

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