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 des paramètres pour la gestion du plan de SQL requêtes Aurora Postgre

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. Ils sont disponibles dans le paramètre de cluster de base de données personnalisé et dans le groupe de paramètres de base de données associé à votre cluster de SQL base de données Aurora Postgre. 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 Activer la gestion du plan de SQL requêtes Aurora Postgre. 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 des paramètres d'un groupe de paramètres de cluster de base de données dans Amazon Aurora et Groupes de paramètres de base de données pour les instances de base de données Amazon Aurora.

apg_plan_mgmt.capture_plan_baselines

Capture les plans d'exécution des requêtes générés par l'optimiseur pour chaque SQL instruction et les stocke dans la dba_plans vue. 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.

Pour de plus amples informations, veuillez consulter 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.

Pour de plus amples informations, veuillez consulter 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.

apg_plan_mgmt.log_plan_enforcement_result

Spécifie si les résultats doivent être enregistrés pour vérifier si les plans QPM gérés 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.

apg_plan_mgmt.max_databases

Spécifie le nombre maximum de bases de données sur l'instance Writer de votre SQL cluster de bases de données Aurora Postgre qui peuvent utiliser la gestion des plans de requêtes. 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.

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'SQLinstructions que le gestionnaire de plans de requêtes peut conserver dans la apg_plan_mgmt.dba_plans vue. Nous vous recommandons de définir ce paramètre sur 10000 ou une valeur supérieure pour toutes les SQL versions d'Aurora Postgre.

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.

Pour de plus amples informations, veuillez consulter 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 plus d’informations, consultez Validation des plans.

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.

Pour de plus amples informations, veuillez consulter 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 le SQL relevé. 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_plans.

La modification de la valeur de ce paramètre ne nécessite pas de redémarrage.

Pour de plus amples informations, veuillez consulter 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 de plus amples informations, veuillez consulter 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.

Vous pouvez évaluer les temps de réponse des différents plans capturés et modifier le statut du plan, si nécessaire. Pour de plus amples informations, veuillez consulter Améliorer les plans de SQL requêtes Aurora Postgre.

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.