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

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

最終更新日:Jul 14, 2026

このトピックでは、パフォーマンスの最適化やビジネス要件を満たすために、ApsaraDB RDS for PostgreSQL インスタンスのパラメーターを変更する方法について説明します。パラメーターの変更履歴を確認することもできます。

注意事項

  • 一部のパラメーターを変更すると、インスタンスが再起動されます。パラメーターを変更して [パラメーターの適用] をクリックすると、インスタンスはすぐに再起動します。パラメーターの変更によって再起動がトリガーされるかどうかを確認するには、[変更可能なパラメーター] タブの [強制再起動] 列を確認してください。インスタンスが再起動すると、アプリケーションは切断されます。操作を進める前に、業務に支障がないことをご確認ください。

  • コンソールでパラメーターを変更する場合は、[変更可能なパラメーター] タブの [有効な値] 列をご参照ください。

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

    wal_level, max_replication_slots, max_wal_senders, max_locks_per_transaction, max_worker_processes, max_prepared_transactions

  • パラメーターを変更すると、システムは変更を適用しようとします。新しい値が無効であるか、インスタンスで障害が発生した場合、変更はロールバックされ、結果は失敗と表示されます。結果は、[編集履歴] タブの [ステータス] 列で表示できます。

  • log_statement パラメーターは直接変更できません。このパラメーターを変更するには、SQL Explorerと監査を有効化または無効化するをご参照ください。

パラメーター値の変更

  1. RDSインスタンスにアクセスし、上部のリージョンを選択し、対象のRDSインスタンスのIDをクリックします。
  2. 左側のナビゲーションペインで、[パラメーター] をクリックします。

  3. [変更可能なパラメーター] タブで、変更したいパラメーターを見つけます。パラメーターは、個別または一括で変更できます:

    • 単一のパラメーターの変更

      1. 変更するパラメーターの横にある アイコンをクリックします。

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

      3. [パラメーターの適用] をクリックします。

      4. ダイアログボックスで、新しい値が有効になるタイミングとして、[すぐに有効にする][メンテナンス期間 (02:00-06:00) 内に有効にする]、または [指定した時刻に有効にする] を選択します。その後、[OK] をクリックします。

    • パラメーターの一括変更

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

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

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

      4. [パラメーターのインポート] ダイアログボックスに、パラメーターとその新しい値を貼り付け、[OK] をクリックします。

      5. パラメーターリストの変更内容を確認し、[パラメーターの適用] をクリックします。

      6. ダイアログボックスで、新しい値が有効になるタイミングとして、[すぐに有効にする][メンテナンス時間 (02:00-06:00) 内に有効にする]、または[指定した時間に有効にする]を選択し、[OK] をクリックします。

    説明

    [予約タスク] タブでは、[メンテナンスウィンドウ内 (02:00-06:00) に有効] または [指定時間に有効] にスケジュールされたパラメーター変更タスクを表示できます。

パラメーター変更履歴の照会

  1. RDSインスタンスにアクセスし、上部のリージョンを選択し、対象のRDSインスタンスのIDをクリックします。
  2. 左側のナビゲーションペインで、[パラメーター] をクリックします。

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

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

パラメーター式

式を使用してパラメーターを設定できます。インスタンスタイプ関連のパラメーターを式に設定すると、インスタンスタイプを変更したときにパラメーター値が自動的に調整されます。これにより、パラメーター値が新しいインスタンスタイプに対して最適な状態を維持できます。

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

カテゴリ

注意事項

パラメーター

以下のパラメーターは式をサポートしています。

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

  • 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_worker_processes:同時ワーカープロセスの最大数を設定します。

説明

[max_parallel_maintenance_workers] パラメーターは、RDS PostgreSQL 11.0 以降でのみサポートされています。

effective_cache_size

変数

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

  • DBInstanceClassMemory:インスタンスタイプのメモリサイズ (バイト単位) です。この変数の値は整数です。

  • DBInstanceClassCPU:インスタンスタイプの CPU コア数です。この変数の値は整数です。

  • DBInstanceClassConnections:インスタンスタイプの最大接続数です。この変数の値は整数です。

説明

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

effective_cache_size={DBInstanceClassMemory/16384}

演算子

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

  • 除算演算子 (/):被除数を除数で割り、整数の商を返します。商が小数の場合、システムは商を丸めずに小数部分を切り捨てます。被除数と除数は小数にすることができます。

  • 乗算演算子 (*):2 つの乗数を乗算し、整数の積を返します。積が小数の場合、システムは積を丸めずに小数部分を切り捨てます。2 つの乗数は小数にすることができます。

関数

  • GREATEST() 関数は、整数またはパラメーター式のリストの中で最大の値を返します。

  • LEAST() 関数は、整数またはパラメーター式のリストの中で最小の値を返します。

  • SUM() 関数は、指定された整数またはパラメーター式の値を加算します。

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

関連ドキュメント

  • PostgreSQL パラメーターの詳細については、PostgreSQL ドキュメントの「Server Configuration」をご参照ください。

  • API 操作を呼び出してパラメーターを変更するには、以下の API をご参照ください。

    API

    説明

    ModifyParameter

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

    DescribeParameterTemplates

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

    DescribeParameters

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

よくある質問

ApsaraDB RDS for PostgreSQLインスタンスの最大接続数を変更するにはどうすればよいですか?

ApsaraDB RDS for PostgreSQL インスタンスの最大接続数は、インスタンスタイプによって決定され、手動で変更することはできません。最大接続数を増やすには、より大きなインスタンスタイプにアップグレードしてください。最大接続数は、プライマリインスタンスと読み取り専用インスタンスで異なる場合があります。詳細については、「プライマリインスタンスタイプ」および「読み取り専用インスタンスタイプ」をご参照ください。

max_slot_wal_keep_size パラメーターを変更するとエラーが発生するのはなぜですか?

この問題は、特定の ApsaraDB RDS for PostgreSQL インスタンスで発生することがあります。以下の原因と推奨事項をご確認ください。

  • これらのインスタンスでは、仕様上の制限により max_slot_wal_keep_size パラメーターは変更できません。

  • WAL ログの増加を制御するためにこのパラメーターを調整したい場合は、このパラメーターが変更可能な新しい ApsaraDB RDS for PostgreSQL インスタンスを購入することを推奨します。その後、新しいインスタンスでこのパラメーターを変更できます。