

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\_stat\_activity
+ aurora\_stat\_plans

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.

![Comprendre les pics de mémoire des requêtes.](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\_stat\_statements
+ aurora\_stat\_plans

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\_compute\_plan\_id](#aurora.compute_plan_id)
+ [aurora\_stat\_plans.minutes\_until\_recapture](#aurora.minutes_until_recapture)
+ [aurora\_stat\_plans.calls\_until\_recapture](#aurora.calls_until_recapture)
+ [aurora\_stat\_plans.with\_costs](#aurora.with_costs)
+ [aurora\_stat\_plans.with\_analyze](#aurora.with_analyze)
+ [aurora\_stat\_plans.with\_timing](#aurora.with_timing)
+ [aurora\_stat\_plans.with\_buffers](#aurora.with_buffers)
+ [aurora\_stat\_plans.with\_wal](#aurora.with_wal)
+ [aurora\_stat\_plans.with\_triggers](#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\_compute\_plan\_id
<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.



- **off**
  - **Valeurs autorisées:** 0(désactivé) / **Description:** Spécifiez off pour empêcher l’attribution d’un identifiant de plan.
  - **Valeurs autorisées:** 1(activé) / **Description:** Spécifiez on pour attribuer un identifiant de plan.



### aurora\_stat\_plans.minutes\_until\_recapture
<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\_stat\_plans.calls\_until\_recapture
<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\_stat\_plans.with\_costs
<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`.



- **on**
  - **Valeurs autorisées:** 0(désactivé) / **Description:** N’affiche pas le coût estimé ni les lignes pour chaque nœud du plan.
  - **Valeurs autorisées:** 1(activé) / **Description:** Affiche le coût estimé et les lignes pour chaque nœud du plan.



### aurora\_stat\_plans.with\_analyze
<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`.



- **off**
  - **Valeurs autorisées:** 0(désactivé) / **Description:** N’inclut pas les statistiques d’exécution réelles du plan.
  - **Valeurs autorisées:** 1(activé) / **Description:** Inclut les statistiques d’exécution réelles du plan.



### aurora\_stat\_plans.with\_timing
<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`.



- **on**
  - **Valeurs autorisées:** 0(désactivé) / **Description:** N’inclut pas le temps de démarrage réel ni le temps passé dans chaque nœud du plan.
  - **Valeurs autorisées:** 1(activé) / **Description:** Inclut le temps de démarrage réel et le temps passé dans chaque nœud du plan.



### aurora\_stat\_plans.with\_buffers
<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`.



- **off**
  - **Valeurs autorisées:** 0(désactivé) / **Description:** N’inclut pas d’informations sur l’utilisation de la mémoire tampon.
  - **Valeurs autorisées:** 1(activé) / **Description:** Inclut des informations sur l’utilisation de la mémoire tampon.



### aurora\_stat\_plans.with\_wal
<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`.



- **off**
  - **Valeurs autorisées:** 0(désactivé) / **Description:** N’inclut pas d’informations sur la génération d’enregistrements WAL.
  - **Valeurs autorisées:** 1(activé) / **Description:** Inclut des informations sur la génération d’enregistrements WAL.



### aurora\_stat\_plans.with\_triggers
<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`.



- **off**
  - **Valeurs autorisées:** 0(désactivé) / **Description:** N’inclut pas les statistiques d’exécution des déclencheurs.
  - **Valeurs autorisées:** 1(activé) / **Description:** Inclut les statistiques d’exécution des déclencheurs.

