ApsaraDB RDS:Ajuster les paramètres de l'instance

back_log

Contrôle la longueur de la file d'attente des connexions lorsque l'instance gère un grand nombre de connexions éphémères. Lorsque la file d'attente est pleine, l'instance rejette les nouvelles demandes de connexion.

Symptôme : Une valeur trop faible provoque l'erreur applicative suivante :

SQLSTATE[HY000] [2002] Connection timed out

Valeur recommandée : 3000

net_write_timeout

Définit la durée d'attente de l'instance avant d'envoyer un bloc à un client.

Symptôme : Une valeur trop faible provoque l'erreur client suivante :

"the last packet successfully received from the server was milliseconds ago"
"the last packet sent successfully to the server was milliseconds ago"

Valeur recommandée : 60 (secondes, valeur par défaut). Si le réseau est instable ou si le client met beaucoup de temps à traiter chaque bloc, augmentez cette valeur pour éviter les déconnexions inattendues.

innodb_lock_wait_timeout

Définit le délai maximal (en secondes) pendant lequel une transaction InnoDB attend un verrou de ligne avant d'être abandonnée.

Valeur recommandée : 50

innodb_thread_concurrency

Définit le nombre maximal de threads simultanés au sein d'InnoDB. Une valeur de 0 supprime la limite.

Valeur recommandée : 0 (illimité), sauf si vous résolvez des problèmes de performance liés à une forte concurrence.

loose_rds_threads_running_high_watermark

Limite le nombre total de requêtes simultanées. Par exemple, définir ce paramètre sur 100 autorise jusqu'à 100 requêtes MySQL simultanées ; les requêtes supplémentaires sont rejetées.

Utilisez ce paramètre pour protéger l'instance contre les pics de trafic et la surcharge pendant les heures de pointe.

thread_pool_enabled

Active ou désactive la fonctionnalité de pool de threads.

Valeur recommandée : ON

thread_pool_size

Définit le nombre de groupes de threads dans le pool de threads.

Valeur recommandée : {LEAST(DBInstanceClassCPU × 2, 64)}

thread_pool_oversubscribe

Définit le nombre maximal de threads actifs par groupe de threads.

Valeur recommandée : 32

thread_stack

Définit la profondeur de la pile pour chaque thread utilisateur. Une valeur trop faible entraîne l'échec des requêtes SQL profondément récursives.

Valeur recommandée : 1048576

innodb_buffer_pool_size

Définit la taille du buffer pool InnoDB, principale zone mémoire utilisée pour mettre en cache les données de table et d'index. Un buffer pool correctement dimensionné conserve votre ensemble de travail (les données et index auxquels vos requêtes accèdent le plus souvent) en mémoire, réduisant considérablement les E/S disque.

Valeur recommandée : {DBInstanceClassMemory × 3/4}

innodb_buffer_pool_instances

Divise le buffer pool en plusieurs instances gérées indépendamment pour prendre en charge les lectures et écritures simultanées. S'applique uniquement lorsque innodb_buffer_pool_size dépasse 1 Go.

Valeur recommandée : {LEAST(DBInstanceClassMemory/1073741824, 8)}

innodb_max_dirty_pages_pct_lwm

Définit le seuil de pourcentage de pages sales qui déclenche le pré-flushing. La valeur doit être inférieure à innodb_max_dirty_pages_pct. Définir cette valeur sur 0 désactive le pré-flushing.

Valeur recommandée : 10

innodb_lru_scan_depth

Définit la profondeur à laquelle les threads de nettoyage de pages analysent la liste Least Recently Used (LRU) dans chaque instance de buffer pool lors du flushing des pages sales.

Valeur recommandée : {LEAST(DBInstanceClassMemory/1048576/8, 8192)}

innodb_page_cleaners

Définit le nombre de threads de nettoyage de pages utilisés pour flusher les pages sales depuis les instances de buffer pool. Si cette valeur dépasse le nombre d'instances de buffer pool, le système la plafonne automatiquement à la valeur de innodb_buffer_pool_instances. La valeur par défaut est 4.

Valeur recommandée : 8

tmp_table_size

Définit la taille maximale d'une table temporaire interne en mémoire par thread. La limite effective correspond à la plus petite valeur entre tmp_table_size et max_heap_table_size. Lorsqu'une table temporaire dépasse cette limite, MySQL la convertit en table sur disque (InnoDB dans MySQL 8.0 ; MyISAM dans les versions antérieures).

Symptôme : Les requêtes complexes avec GROUP BY ou DISTINCT qui ne peuvent pas être servies par un index s'exécutent plus lentement lorsque les tables temporaires débordent sur le disque.

Valeur par défaut : 2097152. Augmentez cette valeur sur les instances disposant de suffisamment de mémoire si les requêtes contiennent de nombreuses clauses GROUP BY ou DISTINCT.

innodb_io_capacity

Définit le nombre maximal d'opérations d'E/S par seconde que les tâches d'arrière-plan InnoDB peuvent consommer.

Valeur recommandée : 20000

innodb_io_capacity_max

Définit le nombre maximal d'IOPS qu'InnoDB peut utiliser lorsque le flushing prend du retard par rapport au taux configuré.

Valeur recommandée : 40000

innodb_flush_neighbors

Contrôle si InnoDB flush les pages sales voisines lors du flushing d'une page sale. Valeurs valides :

• 0 : Flush uniquement la page sale cible.

• 1 : Flush la page cible et ses voisines dans la même étendue.

• 2 : Flush toutes les pages sales dans la même étendue.

Valeur recommandée : 0

innodb_change_buffering

Retarde les opérations d'écriture sur les index secondaires pour convertir les E/S aléatoires en E/S séquentielles. Cela aide sur les disques durs, mais apporte un bénéfice limité sur le matériel de stockage moderne.

Valeur recommandée : none

innodb_log_file_size

Définit la taille de chaque fichier journal dans le groupe de redo logs. La taille totale des redo logs est innodb_log_file_size × innodb_log_files_in_group et ne peut pas dépasser 512 Go. La valeur par défaut est de 48 Mo.

Un fichier journal plus grand réduit la fréquence des points de contrôle et les E/S disque, mais augmente le temps de récupération après incident. Définissez cette valeur suffisamment grande pour que l'instance puisse gérer le trafic d'écriture pendant plus d'une heure, lissant ainsi la différence entre les E/S aux heures de pointe et aux heures creuses.

Valeur recommandée : Configurez en fonction des spécifications de votre instance.

open_files_limit

Définit le nombre de descripteurs de fichiers que l'instance peut ouvrir simultanément. Affecte également innodb_open_files.

Valeurs recommandées :

• MySQL 5.6 : 65535

• MySQL 5.7 et 8,0 : 655350

Pour les instances disposant de 32 cœurs CPU ou plus et d'un grand nombre de sessions ou de tables actives, définissez cette valeur légèrement au-dessus du nombre réel de fichiers de l'instance.

innodb_open_files

Définit le nombre maximal de descripteurs de fichiers qu'InnoDB peut avoir ouverts simultanément.

Symptôme : Une valeur trop faible provoque l'avertissement suivant, qui dégrade les performances :

[Warning] [MY-012152] [InnoDB] Open files * exceeds the limit *

Valeur recommandée : 20000

table_open_cache

Définit le nombre maximal de tables que le serveur garde ouvertes dans toutes les instances de cache de table. Une valeur trop faible dégrade les performances des requêtes sous forte concurrence ; une valeur trop élevée augmente la consommation de mémoire. Surveillez l'utilisation de la mémoire lors de l'augmentation de cette valeur.

Valeur recommandée : {LEAST(DBInstanceClassMemory/1073741824 × 1024, 16384)}

table_open_cache_instances

Partitionne le cache de table en instances séparées, chacune ayant une taille de table_open_cache / table_open_cache_instances. Cela réduit la contention sur le cache de table entre les sessions.

Valeur recommandée : 16

innodb_autoinc_lock_mode

Contrôle la manière dont InnoDB gère les verrous auto-incrémentaux pour les clés primaires auto-incrémentales. Valeurs valides :

• 0 (traditionnel) : Conserve le verrou AUTO-INC pendant toute la durée de l'instruction. Limite considérablement la concurrence des INSERT.

• 1 (consécutif, par défaut) : Conserve brièvement le verrou AUTO-INC. Le libère immédiatement pour les insertions à nombre de lignes fixe ; le conserve pendant toute la durée de l'instruction pour les insertions à nombre de lignes variable.

• 2 (entrelacé) : Libère le verrou AUTO-INC dès que la valeur est attribuée, quel que soit le fait que le nombre de lignes soit fixe ou non.

Valeur recommandée : 2. Cela élimine les interblocages AUTO-INC et améliore les performances des instructions INSERT … SELECT.

innodb_adaptive_hash_index

Active ou désactive l'index de hachage adaptatif, qui aide InnoDB à localiser rapidement les pages du buffer pool en fonction des modèles de requête.

Symptôme : Lorsqu'il est activé (ON), certaines instructions — en particulier les DDL — peuvent déclencher la maintenance de l'index de hachage adaptatif, bloquant d'autres requêtes ou dégradant les performances.

Valeur recommandée : OFF. Pour plus d'informations, consultez les bonnes pratiques relatives aux index de hachage adaptatifs d'ApsaraDB RDS for MySQL.

rpl_semi_sync_master_timeout

Définit la durée pendant laquelle l'instance RDS principale attend que l'instance RDS secondaire accuse réception des journaux binaires avant qu'une transaction ne soit validée. Si le délai est dépassé, la réplication passe du mode semi-synchrone au mode asynchrone. Une fois que l'instance secondaire a rattrapé son retard, la réplication revient automatiquement en mode semi-synchrone.

Valeur recommandée : 1000 (millisecondes, soit 1 seconde). Pour les charges de travail nécessitant une fiabilité élevée des données, augmentez cette valeur pour éviter la dégradation vers la réplication asynchrone. Sachez qu'une valeur élevée peut bloquer les requêtes d'écriture lors de transactions longues, ce qui peut amener le composant de haute disponibilité (HA) à détecter une panne de l'instance et à initier un basculement.

slave_parallel_workers

Définit le nombre de threads de relecture parallèle sur l'instance RDS secondaire. Trop peu de threads limitent le débit de relecture parallèle et augmentent la latence de réplication.

Valeur recommandée : {GREATEST(DBInstanceClassCPU, 8)}

binlog_transaction_dependency_tracking

Spécifie comment MySQL suit les dépendances des transactions pour la réplication parallèle. Définir cette valeur sur WRITESET active la détection des conflits au niveau des lignes, permettant une relecture parallèle plus rapide sur l'instance RDS secondaire.

Valeur recommandée : WRITESET. Définissez transaction_write_set_extraction avant de modifier ce paramètre. Pour plus de détails, consultez la rubrique Modifier les paramètres liés à WRITESET.

binlog_transaction_dependency_history_size

Définit le nombre maximal d'entrées de transaction hachées conservées en mémoire pour le suivi des dépendances. Lorsque la limite est atteinte, toutes les entrées sont effacées.

Symptôme : Une valeur trop faible réduit la concurrence de relecture parallèle sur l'instance RDS secondaire, augmentant ainsi la latence de réplication.

Valeur recommandée : 500000. Pour plus de détails, consultez la rubrique Modifier les paramètres liés à WRITESET.

transaction_write_set_extraction

Définit l'algorithme de hachage utilisé par WRITESET.

Valeur recommandée : XXHASH64. Pour plus de détails, consultez la rubrique Modifier les paramètres liés à WRITESET.

query_cache_size

Contrôle la mémoire allouée au cache de requêtes MySQL. Lorsqu'il est activé, MySQL vérifie le cache avant d'exécuter une requête. Sur les charges de travail à dominante lecture avec peu d'écritures, cela peut améliorer les performances. Sur les charges de travail à dominante écriture, le mécanisme de verrouillage du cache de requêtes provoque des conflits fréquents qui dégradent les performances des requêtes SELECT.

Symptôme : De nombreuses connexions bloquées dans ces états :

checking query cache for query
waiting for query cache lock
storing result in query cache

Valeur recommandée : Laissez désactivé (valeur par défaut d'ApsaraDB RDS). Si vous avez précédemment activé le cache de requêtes et observez les symptômes ci-dessus, désactivez-le.

eq_range_index_dive_limit

Contrôle le moment où l'optimiseur passe des plongées d'index à l'estimation basée sur les statistiques pour les conditions de plage d'égalité. Pour une requête telle que :

col_name IN (val1, ..., valN)
col_name = val1 OR ... OR col_name = valN

Si N est inférieur à cette limite, l'optimiseur échantillonne les données en utilisant des plongées d'index. Si N est supérieur ou égal à cette limite, l'optimiseur utilise plutôt les statistiques de table.

Pour plus d'informations, consultez la documentation MySQL sur eq_range_index_dive_limit.

Valeurs recommandées :

• MySQL 5.6 : 10

• MySQL 5.7 et 8,0 : 100

loose_rds_max_tmp_disk_space

Limite la taille totale des fichiers temporaires sur l'instance.

Symptôme : Le dépassement de cette limite provoque l'erreur suivante :

The table '/home/mysql/dataxxx/tmp/#sql_2db3_1' is full

Vérifiez d'abord si les instructions SQL générant des fichiers temporaires peuvent être optimisées. Si l'instance dispose de suffisamment d'espace disque et que les requêtes ne peuvent pas être évitées, augmentez cette valeur.

loose_innodb_rds_faster_ddl

Accélère certaines opérations DDL (telles que les modifications de schéma) en utilisant un mécanisme de gestion du buffer pool développé par l'équipe ApsaraDB RDS, réduisant ainsi l'impact des DDL sur les charges de travail en cours d'exécution.

Valeur recommandée : Activé.

innodb_ft_cache_size

Définit la mémoire (en octets) allouée aux données d'index plein texte par table.

Valeur recommandée : 8000000

innodb_ft_total_cache_size

Définit la mémoire totale (en octets) allouée aux données d'index plein texte pour toutes les tables de l'instance.

Valeur recommandée : 640000000

innodb_ft_result_cache_limit

Définit la limite de mémoire (en octets) pour l'ensemble de résultats de chaque requête d'index plein texte.

Valeur recommandée : 2000000000

innodb_purge_threads

Définit le nombre de threads d'arrière-plan qu'InnoDB utilise pour purger les enregistrements undo. Davantage de threads améliorent le débit de purge, empêchent l'accumulation de fichiers undo et améliorent les performances DML et des requêtes dans certaines charges de travail.

Valeur recommandée : LEAST(DBInstanceClassMemory/1073741824, 8)

innodb_sync_array_size

Définit la taille du tableau d'attente des mutex/verrous. Une valeur plus élevée améliore la concurrence pour les charges de travail générant de nombreux threads en attente. Ce paramètre est lu au démarrage et ne peut pas être modifié à l'exécution. Si le nombre de threads en attente dépasse fréquemment 768, augmentez cette valeur.

Valeur recommandée : 128

innodb_parallel_read_threads

Définit le nombre de threads simultanés pour les scans de clé primaire. Ce paramètre présente des bugs connus.

Valeur recommandée : 0 (désactivé)

performance_schema

Active ou désactive Performance Schema, qui instrumente l'exécution interne de MySQL. Son activation ajoute une surcharge mémoire et peut affecter les performances.

Valeur recommandée : OFF

general_log

Active ou désactive le journal général des requêtes, qui enregistre chaque instruction reçue par le serveur.

Symptôme : L'activation de ce journal peut épuiser le stockage de l'instance. Pour plus d'informations, consultez la FAQ sur la fonctionnalité de journal général des requêtes.

Valeur recommandée : OFF

default_time_zone

Définit le fuseau horaire par défaut du serveur.

Symptôme : Un fuseau horaire non défini ou incorrect entraîne des conversions de temps erronées, des horodatages incohérents et une utilisation accrue du CPU due à des ajustements fréquents de fuseau horaire, en particulier dans les applications desservant plusieurs régions.

Valeur recommandée : Définissez en fonction de vos besoins métier. Pour plus de détails, consultez les bonnes pratiques relatives au paramètre time_zone dans ApsaraDB RDS for MySQL.

loose_tokudb_buffer_pool_ratio

Définit le pourcentage de mémoire tampon que les tables TokuDB peuvent utiliser, par rapport à innodb_buffer_pool_size. Par exemple, si innodb_buffer_pool_size est de 1 000 Mo et que ce paramètre est défini sur 50, les tables TokuDB peuvent utiliser jusqu'à 500 Mo.

Augmentez cette valeur si les tables TokuDB constituent la charge de travail principale de l'instance.

loose_max_statement_time

Définit la durée d'exécution maximale des requêtes, en millisecondes. Les requêtes dépassant cette limite sont interrompues. Par défaut, la durée des requêtes est illimitée.

Symptôme : Le dépassement de la limite provoque l'erreur suivante :

ERROR 3006 (HY000): Query execution was interrupted, max_statement_time exceeded

Définissez ce paramètre lorsque vous devez appliquer des limites de temps d'exécution des requêtes sur l'instance.