Aurora PostgreSQL 実行計画のキャプチャ

Aurora PostgreSQL クエリ計画管理には、自動と手動の 2 つの異なるクエリ実行計画のキャプチャモードが用意されています。apg_plan_mgmt.capture_plans_baselines を automatic に、または manual に設定してモードを選択します。特定の SQL ステートメントの実行計画を取り込むには、手動計画取り込みを使用します。または、自動計画取り込みを使用して、アプリケーションの実行時に 2 回以上実行されるすべての (または最も遅い) 計画を取得することもできます。

オプティマイザは計画取り込み時に、管理ステートメントの初期に取得された計画のステータスを approved に設定します。オプティマイザは、管理ステートメント用に取得されたすべての追加の計画のステータスを unapproved に設定します。ただし、複数の計画が approved ステータスで保存される場合があります。例えば、1 つのステートメントに対して複数の計画が並行して作成された場合や、そのステートメントの初期の計画がコミットされる前に発生する可能性があります。

dba_plans ビューに取得して保管できる計画の最大数を制御するには、DB インスタンスレベルのパラメータグループで apg_plan_mgmt.max_plans パラメータを設定します。apg_plan_mgmt.max_plans パラメータを変更した場合、新しい値を有効にするために DB インスタンスを再起動する必要があります。詳細については、apg_plan_mgmt.max_plans パラメータを参照してください。

特定の SQL ステートメントの計画の手動取り込み

管理が必要な既知の SQL ステートメントがある場合は、ステートメントを SQL スクリプトファイルに入れてから、手動で計画を取得します。以下は、一連の SQL ステートメントに対してクエリ計画を手動で取得する方法を psql を例にとって示しています。

psql> SET apg_plan_mgmt.capture_plan_baselines = manual;
psql> \i my-statements.sql 
psql> SET apg_plan_mgmt.capture_plan_baselines = off;

各 SQL ステートメントに対して計画を取得した後、オプティマイザは apg_plan_mgmt.dba_plans ビューに新しい行を追加します。

EXPLAIN ステートメントまたは EXPLAIN EXECUTE ステートメントを SQL スクリプトファイルで使用することをお勧めします。対象となるすべての計画の取り込みに十分なバリエーションがパラメータ値に含まれていることを確認します。

オプティマイザの最小コスト計画よりも優れた計画がある場合は、オプティマイザでその優れた計画が使用されるようになります。そのためには、オプティマイザのヒントを 1 つ以上指定します。詳細については、「pg_hint_plan を使用した計画の修正」を参照してください。unapproved 計画と approved 計画のパフォーマンスを比較して、承認、拒否、または削除する方法については、「計画パフォーマンスの評価」を参照してください。

自動的な計画の取得

以下のような状況では、自動計画キャプチャを使用します。

未承認の計画のパフォーマンスを測定して、それらを承認、拒否、または削除する方法については、「計画パフォーマンスの評価」を参照してください。