RDS for PostgreSQL インスタンスのパラメーターを設定する - ApsaraDB RDS

コンソールで、または API 操作を呼び出すことによって、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 と監査コンソールで SQL Explorer と監査を有効または無効にすることで、このパラメーターの値を変更できます。

パラメーター値の変更

ApsaraDB RDS コンソールにログインし、[インスタンス] ページに移動します。上部のナビゲーションバーで、RDS インスタンスが存在するリージョンを選択します。次に、RDS インスタンスを見つけて、インスタンス ID をクリックします。
左側のナビゲーションウィンドウで、[パラメーター] をクリックします。
[編集可能なパラメーター] タブで、変更するパラメーターを見つけます。パラメーターは一度に 1 つずつ、またはバッチで変更できます。次のステップでは、これらの操作を実行する方法について説明します。
- 単一パラメーターの変更
  1. 変更するパラメーターの横にあるアイコンをクリックします。
  2. 宛先の値を入力し、[OK] をクリックします。
  3. [パラメーターの送信] をクリックします。
  4. 表示されるダイアログボックスで、新しい値が有効になるタイミングを指定します。[すぐに適用]、[メンテナンス期間内に適用]、または [指定した時間に適用] を選択できます。次に、[OK] をクリックします。
- バッチでのパラメーターの変更
  1. [パラメーターのエクスポート] をクリックして、パラメーターファイルをコンピューターにダウンロードします。
  2. パラメーターファイルを開き、パラメーター値を変更します。
  3. [パラメーターのインポート] をクリックします。
  4. [パラメーターのインポート] ウィンドウで、変更するパラメーターとその値を貼り付け、[OK] をクリックします。
  5. パラメーターリストで変更を確認し、[パラメーターの送信] をクリックします。
  6. 表示されるダイアログボックスで、新しい値が有効になるタイミングを選択します。[すぐに適用]、[メンテナンス期間内に適用]、または [指定した時間に適用] を選択し、[OK] をクリックします。
説明
[スケジュールされたパラメーター変更タスク] タブでは、[メンテナンス期間内に適用] または [指定した時間に適用] に設定されているパラメーター変更タスクを表示できます。

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

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	説明
ModifyParameter	RDS インスタンスのパラメーターを変更します。
DescribeParameterTemplates	データベースのパラメーターテンプレートを照会します。
DescribeParameters	インスタンスの現在のパラメーター設定を照会します。