Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Référence du paramètre de gestion du plan de requête Aurora PostgreSQL
Vous pouvez définir vos préférences pour l’extension `apg_plan_mgmt` en utilisant les paramètres énumérés dans cette section. Celles-ci sont disponibles dans le paramètre personnalisé du cluster de bases de données et dans le groupe de paramètres de base de données associés à votre cluster de bases de données Aurora PostgreSQL. Ces paramètres contrôlent le comportement de la fonction de gestion du plan de requête et la façon dont elle affecte l’optimiseur. Pour plus d’informations sur la configuration de la gestion du plan de requête, consultez [Activation de la gestion de plans de requêtes Aurora PostgreSQL](AuroraPostgreSQL.Optimize.overview.md#AuroraPostgreSQL.Optimize.Enable). La modification des paramètres suivants n’a aucun effet si l’extension `apg_plan_mgmt` n’est pas configurée comme indiqué dans cette section. Pour plus d’informations sur la modification des paramètres d’instance, consultez [Modification des paramètres d'un groupe de paramètres de cluster de base de données dans Amazon Aurora](USER_WorkingWithParamGroups.ModifyingCluster.md) et [Groupes de paramètres de base de données pour les instances de base de données Amazon Aurora](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
Capture les plans d’exécution des requêtes générés par l’optimiseur pour chaque instruction SQL et les stocke dans la vue `dba_plans`. Par défaut, le nombre maximal de plans pouvant être stockés est de 10 000, tel que spécifié par le paramètre `apg_plan_mgmt.max_plans`. Pour obtenir des informations de référence, consultez [apg\$1plan\$1mgmt.max\$1plans](#AuroraPostgreSQL.Optimize.Parameters.max_plans).
Vous pouvez définir ce paramètre dans le groupe de paramètres du cluster de bases de données personnalisé ou dans le groupe de paramètres de base de données personnalisé. La modification de la valeur de ce paramètre ne nécessite pas de redémarrage.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)
Pour plus d’informations, consultez [Capture des plans d'exécution d'Aurora PostgreSQL](AuroraPostgreSQL.Optimize.CapturePlans.md).
## apg\$1plan\$1mgmt.plan\$1capture\$1threshold
Spécifie un seuil de sorte que si le coût total du plan d’exécution de la requête est inférieur à celui-ci, le plan n’est pas capturé dans la vue `apg_plan_mgmt.dba_plans`.
La modification de la valeur de ce paramètre ne nécessite pas de redémarrage.
| Par défaut | Valeurs autorisées | Description |
| --- | --- | --- |
| 0 | 0 - 1.79769e\$1308 | Définit le seuil du coût total d’exécution du plan de la requête `apg_plan_mgmt` pour la capture des plans. |
Pour plus d’informations, consultez [Examen des plans de requête d'Aurora PostgreSQL dans la vue dba\$1plans](AuroraPostgreSQL.Optimize.ViewPlans.md).
## apg\$1plan\$1mgmt.explain\$1hashes
Spécifie si `EXPLAIN [ANALYZE]` affiche `sql_hash` et `plan_hash` à la fin de sa sortie. La modification de la valeur de ce paramètre ne nécessite pas de redémarrage.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)
## apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result
Spécifie si les résultats doivent être enregistrés pour voir si les plans gérés par la gestion QPM sont utilisés correctement. Lorsqu’un plan générique stocké est utilisé, aucun enregistrement n’est écrit dans les fichiers journaux. La modification de la valeur de ce paramètre ne nécessite pas de redémarrage.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)
## apg\$1plan\$1mgmt.max\$1databases
Spécifie le nombre maximum de bases de données sur votre instance en écriture du cluster de bases de données Aurora PostgreSQL qui peuvent utiliser la gestion du plan de requête. Par défaut, jusqu’à dix bases de données peuvent utiliser la gestion du plan de requête. Si vous avez plus de dix bases de données sur l’instance, vous pouvez modifier la valeur de ce paramètre. Pour savoir combien de bases de données se trouvent sur une instance donnée, connectez-vous à l’instance en utilisant `psql`. Ensuite, utilisez la méta-commande psql, `\l`, pour répertorier les bases de données.
Pour modifier la valeur de ce paramètre, vous devez redémarrer l’instance pour que le réglage prenne effet.
| Par défaut | Valeurs autorisées | Description |
| --- | --- | --- |
| 10 | 10-2147483647 | Nombre maximum de bases de données qui peuvent utiliser la gestion du plan de requête sur l’instance. |
Vous pouvez définir ce paramètre dans le groupe de paramètres du cluster de bases de données personnalisé ou dans le groupe de paramètres de base de données personnalisé.
## apg\$1plan\$1mgmt.max\$1plans
Définit le nombre maximal d’instructions SQL que le gestionnaire de plans de requêtes peut conserver dans la vue `apg_plan_mgmt.dba_plans`. Nous vous recommandons de définir ce paramètre sur `10000` ou plus pour toutes les versions Aurora PostgreSQL.
Vous pouvez définir ce paramètre dans le groupe de paramètres du cluster de bases de données personnalisé ou dans le groupe de paramètres de base de données personnalisé. Pour modifier la valeur de ce paramètre, vous devez redémarrer l’instance pour que le réglage prenne effet.
| Par défaut | Valeurs autorisées | Description |
| --- | --- | --- |
| 10 000 | 10-2147483647 | Nombre maximum de plans qui peuvent être stockés dans la vue `apg_plan_mgmt.dba_plans`. La valeur par défaut pour Aurora PostgreSQL version 10 et les versions plus anciennes est 1 000. |
Pour plus d’informations, consultez [Examen des plans de requête d'Aurora PostgreSQL dans la vue dba\$1plans](AuroraPostgreSQL.Optimize.ViewPlans.md).
## apg\$1plan\$1mgmt.plan\$1hash\$1version
Spécifie les cas d’utilisation que le calcul plan\$1hash est conçu pour couvrir. Une version supérieure de `apg_plan_mgmt.plan_hash_version` couvre toutes les fonctionnalités de la version inférieure. Par exemple, la version 3 couvre les cas d’utilisation pris en charge par la version 2.
La modification de la valeur de ce paramètre doit être suivie d’un appel à `apg_plan_mgmt.validate_plans('update_plan_hash')`. Elle met à jour les valeurs plan\$1hash dans chaque base de données avec apg\$1plan\$1mgmt installé et les entrées dans la table des plans. Pour de plus amples informations, consultez [Validation des plans](AuroraPostgreSQL.Optimize.Deleting.md#AuroraPostgreSQL.Optimize.Maintenance.ValidatingPlans).
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)
## apg\$1plan\$1mgmt.plan\$1retention\$1period
Spécifie le nombre de jours pour conserver les plans dans la vue `apg_plan_mgmt.dba_plans`, après quoi ils sont automatiquement supprimés. Par défaut, un plan est supprimé lorsque 32 jours se sont écoulés depuis la dernière utilisation du plan (la colonne `last_used` dans la vue `apg_plan_mgmt.dba_plans`). Vous pouvez remplacer la valeur de ce paramètre par n’importe quel nombre, 1 et plus.
Pour modifier la valeur de ce paramètre, vous devez redémarrer l’instance pour que le réglage prenne effet.
| Par défaut | Valeurs autorisées | Description |
| --- | --- | --- |
| 32 | 1-2147483647 | Nombre maximum de jours depuis la dernière utilisation d’un plan avant qu’il ne soit supprimé. |
Pour plus d’informations, consultez [Examen des plans de requête d'Aurora PostgreSQL dans la vue dba\$1plans](AuroraPostgreSQL.Optimize.ViewPlans.md).
## apg\$1plan\$1mgmt.unapproved\$1plan\$1execution\$1threshold
Spécifie un seuil en dessous duquel un plan non approuvé peut être utilisé par l’optimiseur. Par défaut, le seuil est de 0, de sorte que l’optimiseur n’exécute pas les plans non approuvés. La définition de ce paramètre sur un seuil de coût extrêmement bas, tel que 100, permet d’éviter les frais d’exécution. Vous pouvez également définir ce paramètre sur une valeur extrêmement élevée, telle que 10000000, en utilisant la gestion de plans réactive. Cela permet à l’optimiseur d’utiliser tous les plans choisis sans frais d’exécution. Lorsqu’un mauvais plan est découvert, vous pouvez le marquer manuellement comme « rejeté » afin qu’il ne soit pas utilisé la prochaine fois.
La valeur de ce paramètre représente une estimation du coût d’exécution d’un plan donné. Si un plan non approuvé est inférieur à ce coût estimé, l’optimiseur l’utilise pour l’instruction SQL. Vous pouvez afficher les plans capturés et leur statut (Approuvé, Non approuvé) dans la vue `dba_plans`. Pour en savoir plus, consultez [Examen des plans de requête d'Aurora PostgreSQL dans la vue dba\$1plans](AuroraPostgreSQL.Optimize.ViewPlans.md).
La modification de la valeur de ce paramètre ne nécessite pas de redémarrage.
| Par défaut | Valeurs autorisées | Description |
| --- | --- | --- |
| 0 | 0-2147483647 | Coût estimé du plan en dessous duquel un plan non approuvé est utilisé. |
Pour plus d’informations, consultez [Utilisation des plans gérés Aurora PostgreSQL](AuroraPostgreSQL.Optimize.UsePlans.md).
## apg\$1plan\$1mgmt.use\$1plan\$1baselines
Spécifie que l’optimiseur doit utiliser l’un des plans approuvés capturés et stockés dans la vue `apg_plan_mgmt.dba_plans`. Par défaut, ce paramètre est désactivé (false), ce qui amène l’optimiseur à utiliser le plan présentant le coût le plus faible qu’il génère sans autre évaluation. En activant ce paramètre (en lui attribuant la valeur true), l’optimiseur choisit un plan d’exécution de requête pour la déclaration à partir de sa référence de plan. Pour plus d’informations, consultez [Utilisation des plans gérés Aurora PostgreSQL](AuroraPostgreSQL.Optimize.UsePlans.md). Pour trouver une image détaillant ce processus, consultez [Sélection du plan à exécuter par l'optimiseur.](AuroraPostgreSQL.Optimize.UsePlans.md#AuroraPostgreSQL.Optimize.UsePlans.ChoosePlans).
Vous pouvez définir ce paramètre dans le groupe de paramètres du cluster de bases de données personnalisé ou dans le groupe de paramètres de base de données personnalisé. La modification de la valeur de ce paramètre ne nécessite pas de redémarrage.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)
Vous pouvez évaluer les temps de réponse des différents plans capturés et modifier le statut du plan, si nécessaire. Pour plus d’informations, consultez [Amélioration des plans de requêtes Aurora PostgreSQL](AuroraPostgreSQL.Optimize.Maintenance.md).
## auto\$1explain.hashes
Spécifie si la sortie auto\$1explain affiche sql\$1hash et plan\$1hash. La modification de la valeur de ce paramètre ne nécessite pas de redémarrage.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)