Cours MariaDB / Vérifier la configuration, les modes SQL, les fuseaux et les journaux

Pour examiner la configuration MariaDB, distinguez les fichiers d’options, les valeurs globales en cours et les valeurs de la session connectée. Les modes SQL et les fuseaux horaires peuvent varier entre connexions ; le journal d’erreurs et le journal des requêtes lentes répondent à des questions différentes et ne suivent pas les mêmes conditions d’enregistrement.

Distinguer le fichier, GLOBAL et SESSION

Portée Signification Point à vérifier
Fichier d’options Options lues au démarrage du serveur ou du client Fichiers effectifs, groupes d’options, ordre de lecture et arguments du service
GLOBAL Valeur du serveur ou valeur par défaut des nouvelles connexions Possibilité de modification dynamique et droits requis selon la variable
SESSION Valeur de la connexion courante Une autre connexion peut différer ; la valeur cesse avec la session

Changer une valeur par défaut globale ne met pas nécessairement à jour les sessions existantes. Changer seulement une session ne démontre pas non plus ce qui survivra au redémarrage. Commencez par les requêtes de lecture ci-dessous. Les exemples exécutables ont été vérifiés sur MariaDB 12.3.3 ; les noms d’options du journal lent dans le fichier ciblent MariaDB 10.11 et versions ultérieures.

Le guide des événements planifiés illustre l’importance du contexte horaire pour les tâches. Pour le diagnostic des requêtes, le guide EXPLAIN et comparaison des plans aide à distinguer les estimations du plan d’une observation de l’exécution réelle.

SELECT VERSION(), @@GLOBAL.sql_mode, @@SESSION.sql_mode,
       @@GLOBAL.time_zone, @@SESSION.time_zone, @@system_time_zone;
SHOW GLOBAL VARIABLES WHERE Variable_name IN
  ('datadir', 'log_error', 'log_output', 'log_slow_query',
   'log_slow_query_file', 'log_slow_query_time');

Les droits ou la politique d’un service administré peuvent limiter les informations disponibles. Examinez la version du serveur effectivement interrogé et ses variables au lieu de transférer les hypothèses d’une autre installation. La référence des variables système MariaDB précise la portée et la possibilité de modification dynamique de chaque paramètre.

Identifier les fichiers réellement lus par le service

Les systèmes de type Unix utilisent couramment my.cnf, tandis que Windows peut utiliser my.ini ou my.cnf. Les chemins exacts dépendent de l’installation et des arguments de démarrage du service. La commande suivante indique les chemins par défaut et les groupes d’options du binaire ; utilisez son chemin complet s’il n’est pas accessible dans PATH.

mariadbd --help --verbose

Lisez les sections concernant les fichiers et groupes d’options, puis vérifiez si le service fournit un --defaults-file distinct. Un fichier lu plus tard peut remplacer une valeur précédente. La sortie peut contenir des options sensibles : ne la partagez pas intégralement. Les règles officielles des fichiers d’options décrivent cette lecture.

Sur un serveur d’exercice réservé à cet usage, les options suivantes peuvent montrer une configuration persistante. Sauvegardez d’abord le véritable fichier lu et notez précisément les lignes modifiées. Ajoutez-les au groupe [mariadbd] approprié ; les noms dans le fichier n’utilisent pas le préfixe de ligne de commande --.

[mariadbd]
sql-mode=STRICT_TRANS_TABLES,ERROR_FOR_DIVISION_BY_ZERO,NO_ENGINE_SUBSTITUTION
default-time-zone=+00:00
log-output=FILE
log-slow-query=ON
log-slow-query-time=1
log-slow-query-file=appops-slow.log

Le nom du journal lent est relatif : interrogez ensuite le répertoire des données et le chemin effectivement utilisé. Redémarrez uniquement ce serveur isolé avec le gestionnaire de services Windows ou la procédure Linux habituelle de l’installation. Si le démarrage échoue, examinez le journal d’erreurs et rétablissez le fichier sauvegardé. Le redémarrage d’un serveur de production partagé ne fait pas partie de cet exercice.

Changer un mode SQL dans la session courante

Créez cette table jetable dans votre schéma d’apprentissage appops_lab. Si le schéma existe déjà, confirmez son usage ; si mode_items existe, inspectez sa définition et les données de l’exercice précédent avant de répéter la création.

CREATE DATABASE IF NOT EXISTS appops_lab
  CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE appops_lab;
CREATE TABLE mode_items (
  item_id INT PRIMARY KEY, category_name VARCHAR(20), price INT
) ENGINE=InnoDB;
INSERT INTO mode_items VALUES (1, 'Books', 10), (2, 'Books', 20), (3, 'Tools', 30);

Dans la même connexion, conservez les modes actuels et ajoutez ONLY_FULL_GROUP_BY, sans vider toute la liste :

SET @saved_mode = @@SESSION.sql_mode;
SET SESSION sql_mode = CONCAT_WS(',', NULLIF(@saved_mode, ''), 'ONLY_FULL_GROUP_BY');
SELECT category_name, SUM(price) AS total FROM mode_items GROUP BY category_name;

L’agrégation valide renvoie Books avec un total de 30 et Tools avec un total de 30. L’ordre de ces deux lignes n’est pas garanti ici, car la requête ne contient pas d’ORDER BY. Exécutez séparément la requête suivante :

SELECT category_name, price FROM mode_items GROUP BY category_name;

ONLY_FULL_GROUP_BY refuse le prix non agrégé, absent des colonnes de regroupement. Après cette erreur attendue, exécutez explicitement les instructions de restauration :

SET SESSION sql_mode = @saved_mode;
SELECT @@SESSION.sql_mode;

Au lieu de supprimer tous les modes pour autoriser un prix arbitraire par groupe, déterminez le résultat attendu et corrigez l’agrégation ou le regroupement. Les programmes stockés conservent aussi des modes pertinents de leur création : la valeur présente dans un fichier ne suffit donc pas à expliquer tous leurs comportements. La référence SQL_MODE décrit ces conditions.

Comparer TIMESTAMP et DATETIME entre deux fuseaux

Restez dans la même base et la même connexion. La table zone_example doit être un nouvel objet d’exercice ; inspectez un éventuel objet existant avant de poursuivre.

SET @saved_time_zone = @@SESSION.time_zone;
SET SESSION time_zone = '+09:00';
CREATE TABLE zone_example (id INT PRIMARY KEY, ts TIMESTAMP, dt DATETIME);
INSERT INTO zone_example VALUES (1, '2026-01-01 09:00:00', '2026-01-01 09:00:00');
SELECT ts, dt FROM zone_example;
SET SESSION time_zone = '+00:00';
SELECT ts, dt FROM zone_example;
SET SESSION time_zone = @saved_time_zone;

Le premier SELECT affiche 2026-01-01 09:00:00 dans les deux colonnes. Après le passage à +00:00, TIMESTAMP affiche 2026-01-01 00:00:00, tandis que DATETIME conserve 09:00:00. Cela distingue la conversion de TIMESTAMP selon le fuseau de session des champs de date et d’heure d’un DATETIME. La dernière instruction rétablit le fuseau initial.

Les zones nommées, par exemple Asia/Seoul, dépendent des tables de fuseaux horaires du serveur. Si une zone n’est pas reconnue, examinez leur installation et leur mise à jour. Un décalage numérique fixe et une zone géographique ne suivent pas nécessairement les mêmes règles d’heure saisonnière. Définissez également une politique cohérente de stockage et d’affichage dans l’application ; les descriptions de time_zone et system_time_zone dans la référence des variables système distinguent leurs portées.

Lire le journal qui répond à la question

Journal Usage Éléments à examiner
Erreurs Démarrage, arrêt, erreurs et avertissements du serveur log_error et destination des journaux du service ou du conteneur
Requêtes lentes Diagnostic des requêtes répondant aux critères configurés Activation, seuil, sortie, filtres et minimum de lignes examinées
Requêtes générales Enregistrement large des connexions et requêtes Coût et exposition de données sensibles ; ne pas supposer un enregistrement permanent par défaut

Un journal lent actif n’enregistre pas toutes les requêtes qu’un utilisateur juge lentes. Examinez son seuil et ses filtres, et distinguez les valeurs globales par défaut de celles de la session courante. Vérifiez aussi si la sortie est FILE ou TABLE. Le SQL pouvant contenir des données personnelles, contrôlez l’accès aux journaux, leur rotation et leur conservation. La présentation du journal des requêtes lentes décrit les conditions d’enregistrement et les noms de variables renommées.

Dans une nouvelle session sur le serveur isolé, avec un seuil d’une seconde et des filtres permissifs, SELECT SLEEP(1.2); peut aider à contrôler la destination du journal. Cette requête attend volontairement au lieu de ralentir une charge métier. Si aucune entrée n’apparaît, vérifiez l’activation, la destination et les filtres avant d’augmenter répétitivement la durée d’attente.

Rétablir les paramètres et confirmer le résultat

  1. Relevez les valeurs de session et globales, puis identifiez les connexions et tâches qu’une modification peut affecter.
  2. Modifiez une seule condition de session et observez son effet.
  3. Seulement si la persistance est nécessaire, sauvegardez le fichier d’options puis modifiez le paramètre approprié.
  4. Suivez la procédure de redémarrage de l’administrateur et interrogez les valeurs effectives depuis une nouvelle connexion.
  5. Au besoin, restaurez les valeurs enregistrées ou le fichier sauvegardé, puis vérifiez le journal d’erreurs et le comportement attendu.

Pour supprimer seulement les tables devenues inutiles, utilisez DROP TABLE appops_lab.mode_items, appops_lab.zone_example; après avoir confirmé leurs noms et leur caractère jetable. Restaurer un fichier, rétablir les paramètres de session et supprimer les tables sont des actions distinctes : supprimer une table ne remet pas la configuration du serveur à sa valeur initiale. Un rollback ordinaire ne récupère pas les tables supprimées.