# Aurora PostgreSQL クエリ計画管理のパラメータリファレンス このセクションに記載されているパラメータを使用して、`apg_plan_mgmt` 拡張機能を設定できます。これらは、カスタム DB クラスターパラメータと Aurora PostgreSQL DB クラスターに関連付けられた DB パラメータグループで使用できます。これらのパラメータは、クエリ計画管理機能の動作と、それがオプティマイザに与える影響を制御します。クエリ計画管理のセットアップの詳細については、「[Aurora PostgreSQL のクエリプラン管理をオンにする](AuroraPostgreSQL.Optimize.overview.md#AuroraPostgreSQL.Optimize.Enable)」を参照してください。次のパラメータを変更しても、`apg_plan_mgmt` 拡張機能はそのセクションで詳述されているように設定されていない場合は効果がありません。パラメータの変更については、「[Amazon Aurora での DB クラスターパラメータグループのパラメータの変更](USER_WorkingWithParamGroups.ModifyingCluster.md)」および「[Amazon Aurora DB インスタンスの DB パラメータグループ](USER_WorkingWithDBInstanceParamGroups.md)」を参照してください。 **Topics** + [apg\$1plan\$1mgmt.capture\$1plan\$1baselines](#AuroraPostgreSQL.Optimize.Parameters.capture_plan_baselines) + [apg\$1plan\$1mgmt.plan\$1capture\$1threshold](#AuroraPostgreSQL.Optimize.Parameters.plan_capture_threshold) + [apg\$1plan\$1mgmt.explain\$1hashes](#AuroraPostgreSQL.Optimize.Parameters.explain_hashes) + [apg\$1plan\$1mgmt.log\$1plan\$1Enforcement\$1result](#AuroraPostgreSQL.Optimize.Parameters.log_plan_enforcement_result) + [apg\$1plan\$1mgmt.max\$1databases](#AuroraPostgreSQL.Optimize.Parameters.max_databases) + [apg\$1plan\$1mgmt.max\$1plans](#AuroraPostgreSQL.Optimize.Parameters.max_plans) + [apg\$1plan\$1mgmt.plan\$1hash\$1version](#AuroraPostgreSQL.Optimize.Parameters.plan_hash_version) + [apg\$1plan\$1mgmt.plan\$1retention\$1period](#AuroraPostgreSQL.Optimize.Parameters.plan_retention_period) + [apg\$1plan\$1mgmt.unapproved\$1plan\$1execution\$1threshold](#AuroraPostgreSQL.Optimize.Parameters.unapproved_plan_execution_threshold) + [apg\$1plan\$1mgmt.use\$1plan\$1baselines](#AuroraPostgreSQL.Optimize.Parameters.use_plan_baselines) + [auto\$1explain.hashes](#AuroraPostgreSQL.Optimize.Parameters.auto_explain.hashes) ## apg\$1plan\$1mgmt.capture\$1plan\$1baselines 各 SQL ステートメントのオプティマイザによって生成されたクエリ実行計画をキャプチャし、`dba_plans` ビューに保存します。デフォルトでは、`apg_plan_mgmt.max_plans` パラメータで指定された保存可能な最大の計画数は 10,000 です。参考情報については、「[apg\$1plan\$1mgmt.max\$1plans](#AuroraPostgreSQL.Optimize.Parameters.max_plans)」を参照してください。 このパラメータは、カスタム DB クラスターのパラメータグループまたはカスタム DB パラメータグループで設定できます。このパラメータの値を変更しても、再起動は必要ありません。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html) 詳細については、「[Aurora PostgreSQL 実行計画のキャプチャ](AuroraPostgreSQL.Optimize.CapturePlans.md)」を参照してください。 ## apg\$1plan\$1mgmt.plan\$1capture\$1threshold クエリ実行計画の合計コストがしきい値を下回った場合に、計画が `apg_plan_mgmt.dba_plans` ビューにキャプチャされないようにしきい値を指定します。 このパラメータの値を変更しても、再起動は必要ありません。 | デフォルト | 許可される値 | 説明 | | --- | --- | --- | | 0 | 0 - 1.79769e\$1308 | プランをキャプチャするための `apg_plan_mgmt` クエリプランの合計実行コストのしきい値を設定します。 | 詳細については、「[dba\$1plans ビューで Aurora PostgreSQL クエリ計画を検証する](AuroraPostgreSQL.Optimize.ViewPlans.md)」を参照してください。 ## apg\$1plan\$1mgmt.explain\$1hashes `EXPLAIN [ANALYZE]` が出力の最後に `sql_hash` と `plan_hash` を表示するかどうかを指定します。このパラメータの値を変更しても、再起動は必要ありません。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html) ## apg\$1plan\$1mgmt.log\$1plan\$1Enforcement\$1result QPM 管理プランが適切に使用されているかどうかを確認するために結果を記録する必要があるかどうかを指定します。保存されているジェネリックプランを使用すると、ログファイルにレコードは書き込まれません。このパラメータの値を変更しても、再起動は必要ありません。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html) ## apg\$1plan\$1mgmt.max\$1databases Aurora PostgreSQL DB クラスターのライターインスタンスで、クエリ計画管理を使用できるデータベースの最大数を指定します。デフォルトでは、最大 10 個のデータベースでクエリ計画管理を使用できます。インスタンスに 10 個を超えるデータベースがある場合は、この設定値を変更できます。特定のインスタンスにあるデータベースの数を確認するには、`psql` を使用してインスタンスに接続します。次に、psql メタコマンドの `\l` を使用して、データベースを一覧表示します。 このパラメータの値を変更した場合、設定を有効にするためにインスタンスを再起動する必要があります。 | デフォルト | 許可される値 | 説明 | | --- | --- | --- | | 10 | 10-2147483647 | インスタンスでクエリ計画管理を使用できるデータベースの最大数です。 | このパラメータは、カスタム DB クラスターのパラメータグループまたはカスタム DB パラメータグループで設定できます。 ## apg\$1plan\$1mgmt.max\$1plans クエリプランマネージャが `apg_plan_mgmt.dba_plans` ビューで保持できる SQL ステートメントの最大数を設定します。Aurora PostgreSQL のすべてのバージョンで、このパラメータを `10000` 以上に設定することをお勧めします。 このパラメータは、カスタム DB クラスターのパラメータグループまたはカスタム DB パラメータグループで設定できます。このパラメータの値を変更した場合、設定を有効にするためにインスタンスを再起動する必要があります。 | デフォルト | 許可される値 | 説明 | | --- | --- | --- | | 10000 | 10-2147483647 | `apg_plan_mgmt.dba_plans` ビューに保存できる計画の最大数。 Aurora PostgreSQL バージョン 10 以前では、デフォルトは 1,000 です。 | 詳細については、「[dba\$1plans ビューで Aurora PostgreSQL クエリ計画を検証する](AuroraPostgreSQL.Optimize.ViewPlans.md)」を参照してください。 ## apg\$1plan\$1mgmt.plan\$1hash\$1version plan\$1hash 計算が対象とするユースケースを指定します。`apg_plan_mgmt.plan_hash_version` の上位バージョンは、下位バージョンのすべての機能をカバーします。例えば、バージョン 3 はバージョン 2 でサポートされるユースケースをカバーします。 このパラメータの値を変更した後は、`apg_plan_mgmt.validate_plans('update_plan_hash')` を呼び出す必要があります。apg\$1plan\$1mgmt がインストールされている各データベースの plan\$1hash 値とプランテーブルのエントリを更新します。詳細については、[計画の検証](AuroraPostgreSQL.Optimize.Deleting.md#AuroraPostgreSQL.Optimize.Maintenance.ValidatingPlans)を参照してください。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html) ## apg\$1plan\$1mgmt.plan\$1retention\$1period `apg_plan_mgmt.dba_plans` ビューで計画を保持する日数を指定し、それ以降は自動的に削除されます。デフォルトでは、計画は最後に使用されてから 32 日が経過すると削除されます (`apg_plan_mgmt.dba_plans` ビューの `last_used` 列)。この設定は、1 以上の任意の数に変更できます。 このパラメータの値を変更した場合、設定を有効にするためにインスタンスを再起動する必要があります。 | デフォルト | 許可される値 | 説明 | | --- | --- | --- | | 32 | 1-2147483647 | 計画が最後に使用された日付から、計画が自動的に削除されるまでの最大日数。 | 詳細については、「[dba\$1plans ビューで Aurora PostgreSQL クエリ計画を検証する](AuroraPostgreSQL.Optimize.ViewPlans.md)」を参照してください。 ## apg\$1plan\$1mgmt.unapproved\$1plan\$1execution\$1threshold オプティマイザによって未承認の計画を使用可能なコストのしきい値を指定します。デフォルトでは、しきい値は 0 で、オプティマイザは未承認の計画を実行しません。このパラメータを 100 などのごく低いコストのしきい値に設定すると、小さなプランに対するプラン適用のオーバーヘッドを回避できます。リアクティブスタイルのプラン管理では、このパラメータを 10000000 など、非常に大きな値に設定することもできます。これにより、オプティマイザはプラン適用のオーバーヘッドなしに、選択したすべてのプランを使用できます。ただし、不適切なプランが見つかった場合は、手動で「拒否」とマークして、次回使用されないようにすることができます。 このパラメータの値は、特定の計画を実行するためのコスト見積もりを表します。未承認計画が推定コストを下回る場合、オプティマイザはその計画を SQL ステートメントに使用します。`dba_plans` ビューで、キャプチャされた計画とそのステータス (承認済み、未承認) を確認できます。詳細については[dba\$1plans ビューで Aurora PostgreSQL クエリ計画を検証する](AuroraPostgreSQL.Optimize.ViewPlans.md)を参照してください。 このパラメータの値を変更しても、再起動は必要ありません。 | デフォルト | 許可される値 | 説明 | | --- | --- | --- | | 0 | 0-2147483647 | 未承認の計画が使用された場合、それ以下の見積もりの計画コスト | 詳細については、「[Aurora PostgreSQL 管理計画を使用する](AuroraPostgreSQL.Optimize.UsePlans.md)」を参照してください。 ## apg\$1plan\$1mgmt.use\$1plan\$1baselines `apg_plan_mgmt.dba_plans` ビューでオプティマイザがキャプチャされ、保存された承認済み計画のいずれかを使用するように指定します。デフォルトでは、このパラメータはオフ (false) になっているため、オプティマイザが生成した最小コスト計画をそのまま使用します。このパラメータをオンにする (true に設定する) と、オプティマイザは計画ベースラインからステートメントのクエリ実行計画を選択するよう強制されます。詳細については、「[Aurora PostgreSQL 管理計画を使用する](AuroraPostgreSQL.Optimize.UsePlans.md)」を参照してください。このプロセスの詳細を示すイメージを検索するには、「[オプティマイザが実行する計画を選択する方法。](AuroraPostgreSQL.Optimize.UsePlans.md#AuroraPostgreSQL.Optimize.UsePlans.ChoosePlans)」を参照してください。 このパラメータは、カスタム DB クラスターのパラメータグループまたはカスタム DB パラメータグループで設定できます。このパラメータの値を変更しても、再起動は必要ありません。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html) 必要に応じて、キャプチャしたさまざまな計画の応答時間を評価し、計画のステータスを変更できます。詳細については、「[Aurora PostgreSQL クエリ計画の改善](AuroraPostgreSQL.Optimize.Maintenance.md)」を参照してください。 ## auto\$1explain.hashes auto\$1explain の出力に sql\$1hash と plan\$1hash を表示するかどうかを指定します。このパラメータの値を変更しても、再起動は必要ありません。 [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)