Accès à plus de texte SQL dans le tableau de bord Performance Insights

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

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).

Limites de taille de texte pour Aurora MySQL

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é
Aurora MySQL	4,096 bytes

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 Aurora 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'API AWS CLI or, Performance Insights n'applique pas la limite de 4 Ko imposée par la console. DescribeDimensionKeyset GetResourceMetrics renvoient au maximum 500 octets.

Note

GetDimensionKeyDetailsrenvoie 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 Aurora PostgreSQL

Aurora 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 Aurora PostgreSQL version 9.6, la valeur par défaut du paramètre track_activity_query_size est 1 024 octets. Sur Aurora 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 Aurora 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 de plus amples informations sur le paramètre track_activity_query_size d'instance de base de données, veuillez consulter Run-time Statistics 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 Aurora 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.

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

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

Pour de plus amples informations sur la définition d'un paramètre d'instance de base de données, veuillez consulter Modification de paramètres dans un groupe de paramètres de bases de données.

Affichage et téléchargement de texte SQL dans le tableau de bord de Performance Insights

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/.

2. Dans le volet de navigation, choisissez Performance Insights.

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

   Le tableau de bord de Performance Insights s'affiche pour votre instance de base de données.

4. Faites défiler jusqu'à l'onglet Top SQL (Principaux éléments SQL).

5. Choisissez le signe plus pour développer un résumé SQL et choisissez l'une des requêtes enfants du résumé.

   Les instructions SQL dont la taille du texte est supérieure à 500 octets ressemblent à l'image ci-dessous.

   

6. Faites défiler jusqu'à l'onglet SQL text (Texte SQL).

   

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

7. (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.