For AI agents: the complete documentation index is available at https://docs.ovhcloud.com/fr/llms.txt, the full documentation bundle is available at https://docs.ovhcloud.com/fr/llms-full.txt, and this page is available as Markdown at https://docs.ovhcloud.com/fr/guides/public-cloud/databases/mysql-advanced-parameters-references.md.
Aller au contenu

Paramètres avancés des Public Cloud Databases pour MySQL

Voir en Markdown

Ce guide liste tous les paramètres avancés pris en charge qui vous permettent de configurer votre service Public Cloud Databases pour MySQL selon vos cas d'usage

Objectif

Ce guide liste tous les paramètres avancés pris en charge qui vous permettent de configurer votre service Public Cloud Databases pour MySQL selon vos cas d'usage.

Prérequis

  • Un projet Public Cloud dans votre compte OVHcloud.
  • Une base de données fonctionnant sur votre service Public Cloud Databases OVHcloud (ce guide peut vous aider à répondre à ce prérequis).

En pratique

Info

Les paramètres avancés peuvent également être gérés avec Terraform, via l'argument advanced_configuration (paires clé/valeur) de la ressource ovh_cloud_project_database.

Depuis la console OVHcloud

Veuillez consulter ce guide pour savoir comment modifier vos paramètres avancés depuis la console OVHcloud.

Depuis l'API

Veuillez consulter ce guide pour savoir comment modifier vos paramètres avancés depuis l'API OVHcloud.

Paramètres avancés pour MySQL

Voici les paramètres avancés disponibles pour un service MySQL :

Info

Le tableau ci-dessous liste les paramètres avancés disponibles pour un service MySQL. Votre service affiche la liste exacte, avec les valeurs autorisées, dans l'onglet Configuration de la console OVHcloud et via l'API.

mysql.lower_case_table_names ne peut être défini qu'à la création du service.

Parameters
binlog_retention_period long
min: 600 max: 9007199254740991
Attention : réduire cette valeur peut rendre un grand nombre de journaux binaires éligibles à la purge en une seule fois. Selon le volume, cela peut parfois bloquer le processus de commit de MySQL et empêcher les écritures jusqu'à la fin de la purge. Par précaution, privilégiez une diminution progressive de la valeur, par petits paliers et pendant une période de faible trafic, plutôt qu'une baisse brutale en une seule étape.
mysql.automatic_sp_privileges boolean
Lorsque cette option est activée, le serveur accorde automatiquement les privilèges EXECUTE et ALTER ROUTINE au créateur d'une routine stockée, et les révoque lorsque la routine est supprimée.
mysql.connect_timeout long
min: 2 max: 3600
Le nombre de secondes pendant lesquelles le serveur mysqld attend un paquet de connexion avant de répondre par Bad handshake.
mysql.default_time_zone string
Fuseau horaire par défaut du serveur, exprimé sous forme de décalage par rapport à UTC (de -12:00 à +12:00), d'un nom de fuseau horaire, ou de 'SYSTEM' pour utiliser le fuseau horaire par défaut du serveur MySQL.
mysql.div_precision_increment long
min: 0 max: 30
Nombre de chiffres ajoutés à l'échelle du résultat des divisions effectuées avec l'opérateur /. La valeur par défaut est 4.
mysql.end_markers_in_json boolean
Indique si la sortie JSON de l'optimiseur, comme EXPLAIN FORMAT=JSON, ajoute des marqueurs de fin qui répètent la clé d'une structure près de son accolade fermante, ce qui facilite la lecture des structures JSON volumineuses.
mysql.eq_range_index_dive_limit long
min: 0 max: 4294967295
Le nombre de plages d'égalité dans une requête à partir duquel l'optimiseur passe des index dives aux statistiques d'index pour estimer le nombre de lignes concernées. 0 signifie que les index dives sont toujours utilisés. La valeur par défaut est 200.
mysql.group_concat_max_len long
min: 4 max: 18446744073709552000
La longueur maximale autorisée, en octets, pour le résultat de la fonction GROUP_CONCAT().
mysql.information_schema_stats_expiry long
min: 900 max: 31536000
Le délai, en secondes, avant l'expiration des statistiques mises en cache.
mysql.innodb_adaptive_hash_index boolean
Indique si l'indexation par hachage adaptatif d'InnoDB est activée. Le réglage optimal dépend de la charge de travail : l'indexation par hachage adaptatif accélère les recherches pour certaines charges, mais son verrou interne peut devenir un point de contention en cas de forte concurrence ; la désactiver peut alors améliorer le débit.
mysql.innodb_change_buffer_max_size long
min: 0 max: 50
Taille maximale du buffer de modification InnoDB, exprimée en pourcentage de la taille totale du pool de buffers. La valeur par défaut est 25.
mysql.innodb_flush_neighbors long
min: 0 max: 2
Indique si le vidage d'une page du pool de buffers InnoDB entraîne également le vidage d'autres pages modifiées dans le même extent (la valeur par défaut est 1) : 0 - les pages modifiées du même extent ne sont pas vidées, 1 - vide les pages modifiées contiguës du même extent, 2 - vide les pages modifiées du même extent.
mysql.innodb_ft_enable_stopword boolean
Indique si le traitement des mots vides (stopwords) est appliqué lors de la création ou de la reconstruction d'un index FULLTEXT InnoDB. Activé par défaut.
mysql.innodb_ft_max_token_size long
min: 10 max: 84
Longueur maximale des mots stockés dans un index FULLTEXT InnoDB.
mysql.innodb_ft_min_token_size long
min: 0 max: 16
Longueur minimale des mots stockés dans un index FULLTEXT InnoDB. La modification de ce paramètre entraînera un redémarrage du service MySQL.
mysql.innodb_ft_num_word_optimize long
min: 1000 max: 10000
Nombre de mots traités lors de chaque opération OPTIMIZE TABLE sur un index FULLTEXT InnoDB. La valeur par défaut est 2000.
mysql.innodb_ft_result_cache_limit long
min: 1000000 max: 4294967295
Mémoire maximale, en octets, utilisée par requête pour le cache de résultats des recherches FULLTEXT InnoDB. Cette limite est fixée automatiquement en fonction de la mémoire de votre offre ; définir une valeur remplace la valeur par défaut calculée.
mysql.innodb_ft_server_stopword_table string
Cette option permet de spécifier votre propre liste de mots vides (stopwords) pour l'index FULLTEXT InnoDB, pour toutes les tables InnoDB.
mysql.innodb_ft_user_stopword_table string
Cette option permet de spécifier votre propre liste de mots vides (stopwords) pour l'index FULLTEXT InnoDB, pour des tables InnoDB spécifiques.
mysql.innodb_io_capacity long
min: 100 max: 4294967295
Le nombre d'opérations d'E/S par seconde (IOPS) disponibles pour les tâches d'arrière-plan d'InnoDB, comme le vidage des pages du pool de buffers et la fusion des données du buffer de modification. Définissez une valeur adaptée au stockage sous-jacent ; elle ne doit pas dépasser innodb_io_capacity_max.
mysql.innodb_io_capacity_max long
min: 100 max: 4294967295
Le nombre maximal d'opérations d'E/S par seconde (IOPS) que les tâches d'arrière-plan d'InnoDB peuvent effectuer lorsque le vidage prend du retard. La valeur par défaut est le double de innodb_io_capacity (2000 au minimum). Cette valeur doit être supérieure ou égale à innodb_io_capacity.
mysql.innodb_lock_wait_timeout long
min: 1 max: 3600
La durée, en secondes, pendant laquelle une transaction InnoDB attend un verrou de ligne avant d'abandonner. La valeur par défaut est 120.
mysql.innodb_log_buffer_size long
min: 1048576 max: 4294967296
La taille en octets du buffer qu'InnoDB utilise pour écrire dans les fichiers de log sur le disque. Les valeurs supérieures à 15 % de la RAM fournie par votre offre sont refusées, car un buffer plus grand laisse moins de mémoire pour le pool de buffers et les connexions clientes.
mysql.innodb_max_dirty_pages_pct double
min: 5 max: 99
Pourcentage de pages modifiées dans le pool de buffers InnoDB à partir duquel InnoDB commence un vidage intensif. Réduire cette valeur répartit plus uniformément les E/S d'écriture et raccourcit la reprise après incident, au prix du vidage de pages qui auraient pu être modifiées à nouveau. Doit rester supérieur ou égal à innodb_max_dirty_pages_pct_lwm. La valeur par défaut est 90.
mysql.innodb_max_dirty_pages_pct_lwm double
min: 0 max: 99
Pourcentage de pages modifiées dans le pool de buffers InnoDB à partir duquel InnoDB commence un pré-vidage, afin d'éviter que le taux de pages modifiées n'atteigne innodb_max_dirty_pages_pct. 0 désactive le pré-vidage. Ne peut pas être supérieur à innodb_max_dirty_pages_pct. La valeur par défaut est 10.
mysql.innodb_max_purge_lag long
min: 0 max: 4294967295
Retard maximal, en nombre de transactions en attente, que l'opération de purge InnoDB peut accumuler avant que les INSERT, UPDATE et DELETE ne soient ralentis pour lui permettre de rattraper ce retard. Le délai s'applique par ligne et augmente avec le retard ; il est plafonné par innodb_max_purge_lag_delay, qui doit également être défini pour que cette option ait un effet. La valeur par défaut est 0, ce qui n'entraîne jamais aucun délai.
mysql.innodb_max_purge_lag_delay long
min: 0 max: 10000000
Plafond, en microsecondes, du délai par ligne que innodb_max_purge_lag applique aux INSERT, UPDATE et DELETE. MySQL limite systématiquement le délai à cette valeur : tant qu'elle vaut 0, aucun délai n'est appliqué et innodb_max_purge_lag seul n'a aucun effet. Les deux options doivent être différentes de zéro pour que l'une ou l'autre prenne effet. La valeur par défaut est 0.
mysql.innodb_online_alter_log_max_size long
min: 65536 max: 1099511627776
La limite supérieure, en octets, de la taille des fichiers de log temporaires utilisés lors des opérations DDL en ligne sur les tables InnoDB.
mysql.innodb_optimize_fulltext_only boolean
Lorsque cette option est activée, OPTIMIZE TABLE sur les tables InnoDB met uniquement à jour l'index FULLTEXT au lieu de reconstruire la table. Elle est destinée à être activée temporairement pendant la maintenance des index FULLTEXT, puis désactivée ; tant qu'elle est activée, OPTIMIZE TABLE ne récupère pas l'espace de la table.
mysql.innodb_print_all_deadlocks boolean
Lorsque cette option est activée, les informations relatives à tous les interblocages (deadlocks) dans les transactions utilisateur InnoDB sont enregistrées dans le journal d'erreurs. Désactivé par défaut.
mysql.innodb_read_io_threads long
min: 1 max: 64
Le nombre de threads d'E/S pour les opérations de lecture dans InnoDB. La valeur par défaut est 4. La modification de ce paramètre entraînera un redémarrage du service MySQL.
mysql.innodb_rollback_on_timeout boolean
Lorsque cette option est activée, un dépassement de délai de transaction entraîne l'abandon et l'annulation complète de la transaction par InnoDB. La modification de ce paramètre entraînera un redémarrage du service MySQL.
mysql.innodb_thread_concurrency long
min: 0 max: 1000
Définit le nombre maximal de threads autorisés dans InnoDB. La valeur par défaut est 0 (concurrence infinie - aucune limite).
mysql.innodb_write_io_threads long
min: 1 max: 64
Le nombre de threads d'E/S pour les opérations d'écriture dans InnoDB. La valeur par défaut est 4. La modification de ce paramètre entraînera un redémarrage du service MySQL.
mysql.interactive_timeout long
min: 30 max: 604800
Le nombre de secondes pendant lesquelles le serveur attend une activité sur une connexion interactive avant de la fermer.
mysql.internal_tmp_mem_storage_engine string
values: MEMORY, TempTable
Le moteur de stockage pour les tables temporaires internes en mémoire.
mysql.log_output string
values: NONE, TABLE
La destination de sortie du journal des requêtes lentes lorsque slow_query_log est activé (ON). Pour stocker les requêtes lentes dans la table mysql.slow_log, choisissez TABLE. Pour désactiver les journaux de requêtes lentes, choisissez NONE.
mysql.long_query_time double
min: 0 max: 3600
Les slow_query_logs fonctionnent pour les instructions SQL dont l'exécution prend plus de long_query_time secondes.
mysql.lower_case_table_names long
values: 0, 1
Définit la manière dont les noms de tables et de bases de données sont stockés et comparés. 0 = sensible à la casse (par défaut), 1 = noms stockés en minuscules, comparaisons insensibles à la casse. Cette option ne peut être définie qu'à la création du service et ne peut pas être modifiée par la suite. Consultez la documentation MySQL sur la sensibilité à la casse des identifiants pour plus de détails.
mysql.max_allowed_packet long
min: 102400 max: 1073741824
Taille, en octets, du plus grand message pouvant être reçu par le serveur. La valeur par défaut est 67108864 (64M). Les instructions et les lignes dépassant cette taille sont rejetées avec une erreur de paquet trop volumineux (packet too large).
mysql.max_connections long
min: 30 max: 100000
Le nombre maximal de connexions clientes simultanées autorisées. Réduisez cette valeur pour réserver de la mémoire à d'autres usages. La valeur ne peut pas dépasser la limite fixée par votre offre. Passer à une offre supérieure n'augmente pas une valeur que vous avez définie explicitement : augmentez-la vous-même après le changement d'offre.
mysql.max_execution_time long
min: 0 max: 4294967295
Délai d'exécution maximal, en millisecondes, pour les instructions SELECT de premier niveau en lecture seule. 0 (la valeur par défaut) signifie qu'aucun délai n'est appliqué.
mysql.max_heap_table_size long
min: 1048576 max: 1073741824
Limite la taille des tables internes en mémoire. Définissez également tmp_table_size. La valeur par défaut est 16777216 (16M).
mysql.max_seeks_for_key long
min: 1 max: 18446744073709552000
Limite du nombre maximal supposé de recherches d'index pour trouver des lignes à partir d'une clé. Réduire cette valeur amène l'optimiseur à privilégier les recherches par index plutôt que les parcours de table complets.
mysql.max_user_connections long
min: 0 max: 99990
Le nombre maximal de connexions simultanées autorisées pour un même compte utilisateur. 0, la valeur par défaut, signifie qu'aucune limite n'est appliquée par compte. Toute autre valeur doit être inférieure d'au moins 10 à max_connections, afin que la supervision et vos propres sessions d'administration puissent toujours se connecter lorsqu'une application atteint sa propre limite. Les connexions de réplication et de gestion du service ne sont pas concernées, quelle que soit la valeur définie.
mysql.net_buffer_length long
min: 1024 max: 1048576
Tailles initiales du buffer de connexion et du buffer de résultat. La valeur par défaut est 16384 (16K). La modification de ce paramètre entraînera un redémarrage du service MySQL.
mysql.net_read_timeout long
min: 1 max: 3600
Le nombre de secondes à attendre pour recevoir davantage de données d'une connexion avant d'interrompre la lecture.
mysql.net_write_timeout long
min: 1 max: 3600
Le nombre de secondes à attendre pour qu'un bloc soit écrit sur une connexion avant d'interrompre l'écriture.
mysql.optimizer_prune_level long
min: 0 max: 1
Contrôle les heuristiques appliquées lors de l'optimisation des requêtes pour écarter de l'espace de recherche de l'optimiseur les plans partiels les moins prometteurs. 0 désactive les heuristiques (recherche exhaustive) ; 1 écarte les plans en fonction du nombre de lignes récupérées.
mysql.optimizer_search_depth long
min: 0 max: 62
Profondeur maximale de la recherche effectuée par l'optimiseur de requêtes lors du choix de l'ordre des jointures. Des valeurs élevées produisent de meilleurs plans pour les jointures portant sur de nombreuses tables, mais allongent la compilation ; 0 laisse l'optimiseur choisir la profondeur automatiquement.
mysql.optimizer_switch string
Liste, séparée par des virgules, d'affectations d'indicateurs de l'optimiseur sous la forme flag=on|off|default, ou la valeur unique default pour réinitialiser tous les indicateurs. Les indicateurs non listés conservent leur valeur actuelle. Contrôle des comportements de l'optimiseur de requêtes comme la fusion d'index (index merge), la jointure par hachage (hash join) et les stratégies de semi-jointure.
mysql.performance_schema_events_statements_history_size long
min: 0 max: 1024
Le nombre de lignes par thread dans la table events_statements_history.
mysql.relay_log_space_limit long
min: 134217728 max: 18446744073709552000
L'espace maximal, en octets, utilisé par l'ensemble des journaux de relais (relay logs) lors de la réplication depuis une source de migration externe. Lorsque cette limite est atteinte, le thread d'E/S de réplication cesse de récupérer les événements du relay log jusqu'à ce que le thread SQL ait rattrapé son retard. Augmentez cette valeur pour accorder davantage d'espace de relay log à une migration volumineuse, en vous assurant que le disque du service est dimensionné en conséquence. Ce paramètre s'applique uniquement au nœud qui réplique depuis la source externe ; les nœuds de secours utilisent toujours la valeur par défaut (la plus petite valeur entre 5 Gio et 30 % du disque du service), qui est également utilisée lorsque cette option n'est pas définie.
mysql.slow_query_log boolean
Le journal des requêtes lentes permet de capturer les requêtes lentes. Définir slow_query_log sur false vide également la table mysql.slow_log.
mysql.sort_buffer_size long
min: 32768 max: 1073741824
Taille du buffer de tri en octets pour l'optimisation ORDER BY. La valeur par défaut est 262144 (256K). Les valeurs supérieures à 2 % de la RAM fournie par votre offre sont refusées, car le buffer est alloué par session et son coût est multiplié par le nombre de connexions.
mysql.sql_mode string
Mode SQL global. Définissez une valeur vide pour utiliser les valeurs par défaut du serveur MySQL. Si ce champ n'est pas défini à la création d'un nouveau service, un mode SQL par défaut (strict, conforme au standard SQL) est attribué.
mysql.sql_require_primary_key boolean
Exige la définition d'une clé primaire pour les nouvelles tables ou pour les anciennes tables modifiées avec ALTER TABLE, et échoue si elle est absente. Il est recommandé de toujours définir des clés primaires, car diverses fonctionnalités peuvent être compromises si une table volumineuse en est dépourvue.
mysql.tmp_table_size long
min: 1048576 max: 1073741824
Limite la taille des tables internes en mémoire. Définissez également max_heap_table_size. La valeur par défaut est 16777216 (16M).
mysql.wait_timeout long
min: 1 max: 2147483
Le nombre de secondes pendant lesquelles le serveur attend une activité sur une connexion non interactive avant de la fermer. Les valeurs inférieures à 30 sont refusées, car un délai plus court fermerait vos propres connexions inactives entre deux instructions.
mysql.windowing_use_high_precision boolean
Indique si les fonctions de fenêtrage sont calculées avec une haute précision. Désactiver cette option privilégie la vitesse au détriment de l'exactitude lors de l'évaluation des fonctions de fenêtrage.

Aller plus loin

Rejoignez notre chaîne Discord dédiée : https://discord.gg/ovhcloud. Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l'équipe qui développe nos services de bases de données.

Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.

Rejoignez notre communauté d'utilisateurs.

Cette page vous a-t-elle aidé ?