PostgreSQL インスタンスのパラメータ設定 - RDS

このトピックでは、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と監査を有効または無効にする必要があります。

パラメーター値の変更

ApsaraDB RDS コンソールにログインし、インスタンスページに移動します。上部のナビゲーションバーで、RDS インスタンスが存在するリージョンを選択します。次に、RDS インスタンスを見つけて、インスタンス ID をクリックします。
左側のナビゲーションウィンドウで、[パラメーター] をクリックします。
「[変更可能なパラメーター]」タブで、変更するパラメーターを見つけます。パラメーターは個別に、またはバッチで変更できます。
- 単一のパラメーターを変更する
  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)] または [指定時刻に有効化] にスケジュールされたパラメーター変更タスクを表示できます。

Query パラメーターの変更履歴

ApsaraDB RDS コンソールにログインし、インスタンスページに移動します。上部のナビゲーションバーで、RDS インスタンスが存在するリージョンを選択します。次に、RDS インスタンスを見つけて、インスタンス ID をクリックします。
左側のナビゲーションウィンドウで、[パラメーター] をクリックします。
[編集履歴] タブをクリックします。
時間範囲を選択し、[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}
演算子	式の構文: 式は中括弧 (`{}`) で囲まれます。除算演算子 (/): 被除数を除数で割り、整数商を返します。商が 10 進数の場合、システムは商を四捨五入せず、小数部分を切り捨てます。被除数と除数は 10 進数にすることができます。乗算演算子 (*): 2 つの乗数を乗算し、整数積を返します。積が 10 進数の場合、システムは積を四捨五入せず、小数部分を切り捨てます。2 つの乗数は 10 進数にすることができます。	effective_cache_size={DBInstanceClassMemory/16384}
関数	GREATEST() 関数は、整数のリストまたはパラメーター数式の中で最大値を返します。 LEAST() 関数は、整数のリストまたはパラメーター数式の中で最小値を返します。 SUM() 関数は、指定された整数またはパラメーター数式の値を加算します。	max_parallel_workers={GREATEST(DBInstanceClassCPU*3/4, 8)}

参照

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

API オペレーションを呼び出してパラメーターを変更するには、次の API を参照してください。

API	説明
ModifyParameter	RDS インスタンスのパラメーターを変更します。
DescribeParameterTemplates	データベースのパラメーターテンプレートを照会します。
DescribeParameters	インスタンスの現在のパラメーター設定を照会します。

よくある質問

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

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