

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.

# Accès à plus de texte SQL dans le tableau de bord Performance Insights
<a name="USER_PerfInsights.UsingDashboard.SQLTextSize"></a>

Par défaut, chaque ligne du tableau **Top SQL (Principaux éléments SQL)** affiche 500 octets de texte SQL pour chaque instruction SQL.

![\[500 octets de code SQL\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-top-sql-bytes.png)


Lorsqu'une instruction SQL dépasse 500 octets, vous pouvez afficher davantage de texte dans la section **SQL text** (Texte SQL) située sous le tableau **Top SQL** (Top SQL). Dans ce cas, la longueur maximale du texte affiché dans **SQL text** (Texte SQL) est de 4 Ko. Cette limite est imposée par la console et est soumise aux limites fixées par le moteur de base de données. Pour enregistrer le texte affiché dans **SQL text** (Texte SQL), sélectionnez **Download** (Télécharger).

**Topics**
+ [Limites de taille de texte pour les moteurs Amazon RDS](#sql-text-engine-limits)
+ [Définition de la limite de taille d’un texte SQL pour les instances de base de données Amazon RDS pour PostgreSQL](USER_PerfInsights.UsingDashboard.SQLTextLimit.md)
+ [Affichage et téléchargement de texte SQL dans le tableau de bord de Performance Insights](view-download-text.md)

## Limites de taille de texte pour les moteurs Amazon RDS
<a name="sql-text-engine-limits"></a>

Lorsque vous téléchargez du texte SQL, le moteur de la base de données détermine sa longueur maximale. Vous pouvez télécharger du texte SQL jusqu'aux limites suivantes par moteur.


| Moteur de base de données | Longueur maximale du texte téléchargé | 
| --- | --- | 
| Amazon RDS pour MySQL et MariaDB | La longueur est fixée à 4 096 octets lorsque le schéma de performance est activé. Lorsque le schéma de performance n’est pas activé, la longueur est fixée à 65 535 octets. | 
| Amazon RDS for Microsoft SQL Server | 4,096 caractères | 
| Amazon RDS for Oracle | 1 000 octets | 

La section **SQL text** (Texte SQL) de la console Performance Insights affiche jusqu'au la taille maximum renvoyée par le moteur. Par exemple, si MySQL renvoie au plus 1 Ko à Performance Insights, celui-ci ne peut collecter et afficher que 1 Ko, même si la requête d'origine est plus volumineuse. Ainsi, lorsque vous visualisez la requête en **SQL text** (Texte SQL) ou que vous la téléchargez, Performance Insights renvoie le même nombre d'octets.

Si vous utilisez l’AWS CLI ou l’API, Performance Insights n’a pas la limite de 4 Ko imposée par la console. `DescribeDimensionKeys` et `GetResourceMetrics` renvoient au maximum 500 octets. 

**Note**  
`GetDimensionKeyDetails` renvoie la requête complète, mais la taille dépend de la limite du moteur.

# Définition de la limite de taille d’un texte SQL pour les instances de base de données Amazon RDS pour PostgreSQL
<a name="USER_PerfInsights.UsingDashboard.SQLTextLimit"></a>

Amazon RDS pour PostgreSQL gère le texte différemment. Vous pouvez définir la limite de taille du texte avec le paramètre `track_activity_query_size` de l’instance de base de données. Ce paramètre possède les caractéristiques suivantes :

Taille de texte par défaut  
Sur Amazon RDS pour PostgreSQL version 9.6, la valeur par défaut du paramètre `track_activity_query_size` est 1 024 octets. Sur Amazon RDS pour PostgreSQL version 10 ou versions ultérieures, la valeur par défaut est 4 096 octets.

Taille maximale du text  
La limite de `track_activity_query_size` est de 102 400 octets pour Amazon RDS pour PostgreSQL version 12 et versions inférieures. Le maximum est de 1 Mo pour la version 13 et versions ultérieures.   
Si le moteur renvoie 1 Mo à Performance Insights, la console affiche uniquement les 4 premiers Ko. Si vous téléchargez la requête, vous obtenez la totalité des 1 Mo. Dans ce cas, l’affichage et le téléchargement renvoient des quantités différentes d’octets. Pour plus d’informations sur le paramètre `track_activity_query_size` d’instance de base de données, consultez [Run-time Statistics](https://www.postgresql.org/docs/current/runtime-config-statistics.html) dans la documentation PostgreSQL.

Pour augmenter la taille du texte SQL, augmentez la limite `track_activity_query_size`. Pour modifier ce paramètre, modifiez sa valeur dans le groupe de paramètres associé à l’instance de base de données Amazon RDS pour PostgreSQL.

**Pour modifier le paramètre lorsque l’instance utilise le groupe de paramètres par défaut**

1. Créez un nouveau groupe de paramètres pour l’instance de base de données, associé au moteur de base de données et à sa version appropriés.

1. Définissez le paramètre dans le nouveau groupe de paramètres.

1. Associez le nouveau groupe de paramètres à l’instance de base de données.

Pour plus d’informations sur la définition d’un paramètre d’instance de base de données, consultez [Modification de paramètres dans un groupe de paramètres de base de données dans Amazon RDS](USER_WorkingWithParamGroups.Modifying.md).

# Affichage et téléchargement de texte SQL dans le tableau de bord de Performance Insights
<a name="view-download-text"></a>

Dans le tableau de bord de Performance Insights, vous pouvez afficher ou télécharger le texte SQL.

**Pour afficher du texte SQL supplémentaire dans le tableau de bord de Performance Insights**

1. Ouvrez la console Amazon RDS à l'adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).

1. Dans le panneau de navigation, choisissez **Performance Insights**.

1. Choisissez une instance de base de données.

1. Faites défiler la page jusqu’à l’onglet **Principaux SQL** dans le tableau de bord Performance Insights.

1. Choisissez le signe plus pour développer une synthèse SQL et choisissez l’une des requêtes enfants de la synthèse.

   Les instructions SQL dont la taille du texte est supérieure à 500 octets ressemblent à l’image ci-dessous.  
![\[Instructions SQL dont le texte est volumineux\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-1.png)

1. Faites défiler jusqu’à l’onglet **SQL text** (Texte SQL).  
![\[La section relative aux informations SQL montre plus de texte SQL\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-2.png)

   Le tableau de bord de Performance Insights peut afficher jusqu’à 4 096 octets par instruction SQL.

1. (Facultatif) Choisissez **Copy (Copier)** pour copier l’instruction SQL affichée ou **Download (Télécharger)** pour télécharger l’instruction SQL et en afficher le texte jusqu’à la limite du moteur de base de données.
**Note**  
Pour copier ou télécharger l’instruction SQL, désactivez les bloqueurs de fenêtres contextuelles. 