

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.

# Surveillance des plans d’exécution des requêtes et des pics de mémoire pour Aurora PostgreSQL
<a name="AuroraPostgreSQL.Monitoring.Query.Plans"></a>

Vous pouvez surveiller les plans d’exécution des requêtes dans votre instance de base de données Aurora PostgreSQL afin de détecter ceux qui contribuent à la charge actuelle de la base de données et de suivre leurs statistiques de performance au fil du temps à l’aide du paramètre `aurora_compute_plan_id`. Chaque fois qu’une requête est exécutée, un identifiant est attribué au plan d’exécution utilisé par cette requête. Cet identifiant sera utilisé lors des exécutions ultérieures du même plan.

L’`aurora_compute_plan_id` est désactivé (`OFF`) par défaut dans le groupe de paramètres de base de données à partir d’Aurora PostgreSQL 14.10, 15.5 et versions ultérieures. Pour attribuer un identifiant de plan, définissez `aurora_compute_plan_id` sur `ON` dans le groupe de paramètres.

Cet identifiant de plan est utilisé dans plusieurs utilitaires ayant un objectif différent.

Vous pouvez surveiller l’utilisation des pics de mémoire des requêtes dans votre instance de base de données afin de détecter les requêtes qui contribuent à une utilisation élevée de la mémoire de base de données à partir des versions suivantes :
+ 16.3 et toutes les versions ultérieures
+ 15.7 et versions ultérieures
+ 14.12 et versions ultérieures

Chaque fois qu’une requête est exécutée, le pic de mémoire utilisé par la requête est suivi. Les requêtes sont généralement exécutées plusieurs fois. Des valeurs d’utilisation moyenne, minimale et maximale de la mémoire pour toutes les exécutions peuvent être consultées pour chaque requête.

**Topics**
+ [Accès aux plans d’exécution des requêtes et aux pics de mémoire à l’aide des fonctions Aurora](#AuroraPostgreSQL.Monitoring.Query.Plans.Functions)
+ [Référence des paramètres des plans d’exécution des requêtes Aurora PostgreSQL](#AuroraPostgreSQL.Monitoring.Query.Plans.Parameters)

## Accès aux plans d’exécution des requêtes et aux pics de mémoire à l’aide des fonctions Aurora
<a name="AuroraPostgreSQL.Monitoring.Query.Plans.Functions"></a>

Avec `aurora_compute_plan_id`, vous pouvez accéder aux plans d’exécution à l’aide des fonctions suivantes :
+ aurora\$1stat\$1activity
+ aurora\$1stat\$1plans

Les pics de mémoire des requêtes n’incluent pas la mémoire allouée avant le début du traitement des requêtes. L’utilisation des pics de mémoire est suivie et signalée séparément pour les phases de planification et d’exécution de chaque requête.

![\[\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/aurora-apg-peakmemory.png)


Vous pouvez accéder aux statistiques relatives aux pics de mémoire des requêtes à l’aide des fonctions suivantes :
+ aurora\$1stat\$1statements
+ aurora\$1stat\$1plans

Pour plus d’informations sur ces fonctions, consultez [Référence sur les fonctions Aurora PostgreSQL](Appendix.AuroraPostgreSQL.Functions.md).

## Référence des paramètres des plans d’exécution des requêtes Aurora PostgreSQL
<a name="AuroraPostgreSQL.Monitoring.Query.Plans.Parameters"></a>

Vous pouvez utiliser les paramètres ci-dessous dans un groupe de paramètres de base de données pour surveiller les plans d’exécution des requêtes. 

**Topics**
+ [aurora\$1compute\$1plan\$1id](#aurora.compute_plan_id)
+ [aurora\$1stat\$1plans.minutes\$1until\$1recapture](#aurora.minutes_until_recapture)
+ [aurora\$1stat\$1plans.calls\$1until\$1recapture](#aurora.calls_until_recapture)
+ [aurora\$1stat\$1plans.with\$1costs](#aurora.with_costs)
+ [aurora\$1stat\$1plans.with\$1analyze](#aurora.with_analyze)
+ [aurora\$1stat\$1plans.with\$1timing](#aurora.with_timing)
+ [aurora\$1stat\$1plans.with\$1buffers](#aurora.with_buffers)
+ [aurora\$1stat\$1plans.with\$1wal](#aurora.with_wal)
+ [aurora\$1stat\$1plans.with\$1triggers](#aurora.with_triggers)

**Note**  
La configuration des paramètres `aurora_stat_plans.with_*` ne prend effet que pour les plans récemment capturés.

### aurora\$1compute\$1plan\$1id
<a name="aurora.compute_plan_id"></a>

`aurora_compute_plan_id` est un paramètre de configuration qui contrôle si un identifiant de plan est attribué lors de l’exécution de la requête.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)

### aurora\$1stat\$1plans.minutes\$1until\$1recapture
<a name="aurora.minutes_until_recapture"></a>

Nombre de minutes qui s’écoulent avant qu’un plan ne soit capturé de nouveau. La valeur par défaut est de 0, ce qui désactive la recapture d’un plan. Lorsque le seuil `aurora_stat_plans.calls_until_recapture` est dépassé, le plan est capturé de nouveau.


| Par défaut | Valeurs autorisées | Description | 
| --- | --- | --- | 
| 0 | 0-1073741823 | Définissez le nombre de minutes qui doivent s’écouler avant qu’un plan ne soit capturé de nouveau. | 

### aurora\$1stat\$1plans.calls\$1until\$1recapture
<a name="aurora.calls_until_recapture"></a>

Nombre d’appels vers un plan avant qu’il ne soit capturé de nouveau. La valeur par défaut est de 0, ce qui désactive la recapture d’un plan après un certain nombre d’appels. Lorsque le seuil `aurora_stat_plans.minutes_until_recapture` est dépassé, le plan est capturé de nouveau.


| Par défaut | Valeurs autorisées | Description | 
| --- | --- | --- | 
| 0 | 0-1073741823 | Définissez le nombre d’appels avant qu’un plan ne soit capturé de nouveau. | 

### aurora\$1stat\$1plans.with\$1costs
<a name="aurora.with_costs"></a>

Capture un plan EXPLAIN avec une estimation des coûts. Les valeurs autorisées sont `on` et `off`. La valeur par défaut est `on`.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)

### aurora\$1stat\$1plans.with\$1analyze
<a name="aurora.with_analyze"></a>

Contrôle le plan EXPLAIN avec ANALYZE. Ce mode n’est utilisé que lors de la première capture d’un plan. Les valeurs autorisées sont `on` et `off`. La valeur par défaut est `off`.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)

### aurora\$1stat\$1plans.with\$1timing
<a name="aurora.with_timing"></a>

Le calendrier du plan est capturé dans EXPLAIN quand ANALYZE est utilisé. La valeur par défaut est `on`.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)

### aurora\$1stat\$1plans.with\$1buffers
<a name="aurora.with_buffers"></a>

Les statistiques d’utilisation de la mémoire tampon du plan sont capturées dans EXPLAIN quand ANALYZE est utilisé. La valeur par défaut est `off`.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)

### aurora\$1stat\$1plans.with\$1wal
<a name="aurora.with_wal"></a>

Les statistiques d’utilisation WAL du plan sont capturées dans EXPLAIN quand ANALYZE est utilisé. La valeur par défaut est `off`.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)

### aurora\$1stat\$1plans.with\$1triggers
<a name="aurora.with_triggers"></a>

Les statistiques d’exécution du déclencheur du plan sont capturées dans EXPLAIN quand `ANALYZE` est utilisé. La valeur par défaut est `off`.

[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Monitoring.Query.Plans.html)