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 base de données et dans le groupe de paramètres de base de données associés à votre cluster de base 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. 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 de plus amples informations sur la modification des paramètres d'instance, veuillez consulter Modification de paramètres dans un groupe de paramètres de cluster de base de données et Utilisation de groupes de paramètres de base de données dans une instance de base de données.
Paramètres
- apg_plan_mgmt.capture_plan_baselines
- apg_plan_mgmt.plan_capture_threshold
- apg_plan_mgmt.explain_hashes
- apg_plan_mgmt.log_plan_enforcement_result
- apg_plan_mgmt.max_databases
- apg_plan_mgmt.max_plans
- apg_plan_mgmt.plan_hash_version
- apg_plan_mgmt.plan_retention_period
- apg_plan_mgmt.unapproved_plan_execution_threshold
- apg_plan_mgmt.use_plan_baselines
- auto_explain.hashes
apg_plan_mgmt.capture_plan_baselines
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_plan_mgmt.max_plans.
Vous pouvez définir ce paramètre dans le groupe de paramètres du cluster de base 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.
| Par défaut | Valeurs autorisées | Description |
|---|---|---|
| off | automatique | Active la capture de plan pour toutes les bases de données de l'instance de base de données. Collecte un plan pour chaque instruction SQL qui s'exécute deux fois ou plus. Utilisez ce paramètre pour les charges de travail importantes ou évolutives afin d'assurer la stabilité du plan. |
| manuelle | Active la capture du plan pour les instructions suivantes uniquement, jusqu'à ce que vous la désactiviez à nouveau. Ce paramètre vous permet de capturer les plans d'exécution des requêtes pour des instructions SQL critiques spécifiques uniquement ou pour des requêtes problématiques connues. | |
| off | Désactive la capture de plan. |
Pour plus d'informations, consultez Capture des plans d'exécution d'Aurora PostgreSQL.
apg_plan_mgmt.plan_capture_threshold
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+308 | Définit le seuil du coût total d'exécution du plan de la requête |
Pour plus d'informations, consultez Examen des plans de requête d'Aurora PostgreSQL dans la vue dba_plans.
apg_plan_mgmt.explain_hashes
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.
| Par défaut | Valeurs autorisées | Description |
|---|---|---|
| 0 | 0 (désactivé) | EXPLAIN n'affiche pas sql_hash et plan_hash sans l'option true de hachage. |
| 1 (activé) | EXPLAIN affiche sql_hash et plan_hash sans l'option true de hachage. |
apg_plan_mgmt.log_plan_enforcement_result
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.
| Par défaut | Valeurs autorisées | Description |
|---|---|---|
| none | none | N'affiche aucun résultat d'application de plan dans les fichiers journaux. |
| on_error | Affiche uniquement le résultat d'application de plan dans les fichiers journaux quand la gestion QPM n'utilise pas les plans gérés. | |
| Tout | Affiche tous les résultats d'application de plan dans les fichiers journaux, y compris les succès et les échecs. |
apg_plan_mgmt.max_databases
Spécifie le nombre maximum de bases de données sur votre instance en écriture du cluster de base 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 base de données personnalisé ou dans le groupe de paramètres de base de données personnalisé.
apg_plan_mgmt.max_plans
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 base 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 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_plans.
apg_plan_mgmt.plan_hash_version
Spécifie les cas d'utilisation que le calcul plan_hash 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_hash dans chaque base de données avec apg_plan_mgmt installé et les entrées dans la table des plans. Pour de plus amples informations, veuillez consulter Validation des plans.
| Par défaut | Valeurs autorisées | Description |
|---|---|---|
| 1 | 1 | Calcul plan_hash par défaut. |
| 2 | Le calcul plan_hash a été modifié pour la prise en charge de plusieurs schémas. | |
| 3 | Le calcul plan_hash a été modifié pour la prise en charge de plusieurs schémas et la prise en charge des tables partitionnées. | |
| 4 | Le calcul plan_hash a été modifié pour les opérateurs parallèles et pour prendre charge les nœuds matérialisés. |
apg_plan_mgmt.plan_retention_period
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 paramètre 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_plans.
apg_plan_mgmt.unapproved_plan_execution_threshold
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, veuillez consulter la section Examen des plans de requête d'Aurora PostgreSQL dans la vue 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-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.
apg_plan_mgmt.use_plan_baselines
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. Pour trouver une image détaillant ce processus, consultez Sélection du plan à exécuter par l'optimiseur..
Vous pouvez définir ce paramètre dans le groupe de paramètres du cluster de base 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.
| Par défaut | Valeurs autorisées | Description |
|---|---|---|
| false | true | Utilisez un plan approuvé, préféré ou non approuvé à partir de la liste apg_plan_mgmt.dba_plans. Si aucun de ces plans ne répond à tous les critères d'évaluation de l'optimiseur, celui-ci peut alors utiliser le plan présentant le coût le plus faible qu'il a lui-même généré. Pour plus d'informations, consultez Sélection du plan à exécuter par l'optimiseur.. |
| false | Utilisez le plan de coût minimum généré par l'optimiseur. |
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 Maintenance des plans d'exécution d'Aurora PostgreSQL.
auto_explain.hashes
Spécifie si la sortie auto_explain affiche sql_hash et plan_hash. La modification de la valeur de ce paramètre ne nécessite pas de redémarrage.
| Par défaut | Valeurs autorisées | Description |
|---|---|---|
| 0(désactivé) | 0(désactivé) | Le résultat de auto_explain n'affiche pas sql_hash et plan_hash. |
| 1(activé) | Le résultat de auto_explain montre sql_hash et plan_hash. |
