Corso MariaDB / Verificare configurazione, modalità SQL, fusi orari e log

Esaminare la configurazione MariaDB su tre livelli: file di opzioni, valori globali durante l'esecuzione e valori di sessione della connessione corrente. Modalità SQL e fusi orari possono differire tra connessioni, mentre error log e slow query log hanno scopi e condizioni di registrazione diversi.

Distinguere file, GLOBAL e SESSION

Ambito Significato Distinzione necessaria
File di opzioni Opzioni lette all'avvio di server o client File effettivo, gruppi, ordine di lettura e argomenti del servizio
GLOBAL Impostazione del server o valore iniziale per nuove connessioni Modificabilità durante l'esecuzione e privilegi dipendono dalla variabile
SESSION Valore della connessione corrente Altre connessioni possono differire; vale nella sessione

Modificare il valore globale iniziale non aggiorna necessariamente sessioni già aperte. Cambiare una sessione non dimostra quale valore resterà dopo il riavvio. Partire dalle query di lettura sotto. Gli esempi eseguibili sono verificati su MariaDB 12.3.3; i nomi delle opzioni di slow query log nel file sono destinati a MariaDB 10.11 o successiva.

La prova degli eventi pianificati descrive il contesto temporale. Per diagnosticare query, la guida a EXPLAIN e al confronto dei piani distingue stime e osservazioni effettive.

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');

Privilegi o regole di un servizio gestito possono limitare le informazioni disponibili. Controllare versione e nomi delle variabili sul server effettivamente collegato. Il riferimento delle variabili di sistema MariaDB descrive ambito e modificabilità dei valori.

Individuare il file di opzioni realmente letto

I sistemi Unix-like usano generalmente my.cnf; Windows può usare my.ini o my.cnf. La posizione dipende da installazione e argomenti del servizio. Il comando seguente mostra percorsi predefiniti e gruppi del programma. Usare il percorso completo dell'eseguibile se non è nel PATH.

mariadbd --help --verbose

Leggere file e gruppi e verificare se il servizio passa un proprio --defaults-file. Valori letti successivamente possono sostituire quelli precedenti. L'output può contenere opzioni sensibili: non condividerlo integralmente senza revisione. Le regole ufficiali dei file di opzioni ne descrivono la lettura.

Su un server di prova separato, le opzioni seguenti permettono di osservare la configurazione persistente. Salvare prima il file realmente letto e registrare le righe cambiate. Usare il gruppo [mariadbd] appropriato. Nel file i nomi non hanno il prefisso -- degli argomenti da riga di comando.

[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

Il nome del file slow log è relativo: dopo l'avvio controllare directory dati e percorso effettivo. Riavviare soltanto il server di prova isolato con la procedura Windows o Linux della propria installazione. Se non parte, esaminare l'error log e ripristinare il file salvato. Il riavvio di un server di produzione condiviso non rientra nell'esercizio.

Cambiare una modalità SQL nella sessione corrente

Creare la tabella eliminabile in appops_lab. Controllare lo scopo del database esistente e definizione e dati di mode_items prima di ripetere CREATE.

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

Nella stessa connessione salvare la lista attuale e aggiungere ONLY_FULL_GROUP_BY senza svuotare tutte le modalità:

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'aggregazione valida restituisce Books, libri, con totale 30 e Tools, strumenti, con totale 30. Senza ORDER BY l'ordine delle due righe non è garantito. Eseguire separatamente l'istruzione seguente:

SELECT category_name, price FROM mode_items GROUP BY category_name;

ONLY_FULL_GROUP_BY rifiuta price non aggregato e assente dalle colonne di raggruppamento. Dopo l'errore atteso eseguire esplicitamente il ripristino:

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

Definire il risultato richiesto e correggere aggregazione o raggruppamento, anziché eliminare tutte le modalità per mostrare un prezzo arbitrario del gruppo. I programmi memorizzati conservano anche la modalità pertinente al momento della creazione: il solo file di opzioni non spiega ogni comportamento. Il riferimento SQL_MODE descrive le regole.

Confrontare TIMESTAMP e DATETIME in fusi diversi

Usare ancora database e connessione correnti. zone_example deve essere una nuova tabella di prova; se il nome esiste, esaminarlo prima di eseguire il blocco.

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;

La prima SELECT mostra 2026-01-01 09:00:00 in entrambe le colonne. Passando a +00:00, TIMESTAMP mostra 2026-01-01 00:00:00 mentre DATETIME resta alle 09:00:00. La differenza distingue la conversione del fuso di sessione per TIMESTAMP dal valore di data e ora di DATETIME. L'ultima istruzione ripristina il fuso iniziale.

Fusi denominati come Asia/Seoul dipendono dalle tabelle dei fusi del server. Se un nome non è riconosciuto, verificarne installazione e aggiornamento. Un offset fisso e un fuso geografico non hanno necessariamente lo stesso comportamento rispetto all'ora legale. Definire regole coerenti anche per memorizzazione e visualizzazione nell'applicazione. Il riferimento delle variabili distingue time_zone e system_time_zone.

Leggere il log appropriato alla diagnosi

Log Scopo Controllo
Error log Avvio, arresto, errori e avvisi del server log_error e destinazione del servizio o container
Slow query log Query che soddisfano le condizioni di registrazione Attivazione, soglia, destinazione, filtri e minimo di righe esaminate
General query log Registrazione ampia di connessioni e query Carico ed esposizione di dati sensibili; valutare prima di lasciarlo attivo

Uno slow query log attivo non registra ogni query percepita lenta dall'utente. Controllare soglia e filtri e distinguere valori globali iniziali e sessione corrente. Verificare FILE o TABLE come destinazione. L'SQL può contenere dati personali: gestire accesso, rotazione e conservazione. La panoramica ufficiale dello slow query log descrive condizioni e modifiche dei nomi delle variabili.

In una nuova sessione del server isolato, con soglia di un secondo e filtri adeguati, SELECT SLEEP(1.2); consente di verificare la destinazione del log. La query attende intenzionalmente senza rallentare operazioni applicative. Se la registrazione manca, controllare attivazione, destinazione e filtri prima di aumentare continuamente l'attesa.

Ripristinare le impostazioni e verificare il risultato

  1. Registrare valori globali e di sessione e individuare connessioni e compiti interessati.
  2. Cambiare una condizione di sessione e osservare la differenza.
  3. Salvare e modificare il file appropriato soltanto se la modifica deve persistere al riavvio.
  4. Seguire la procedura di riavvio e leggere i valori effettivi tramite una nuova connessione.
  5. Se necessario ripristinare valori o file e verificare error log e comportamento atteso.

Per eliminare soltanto le tabelle di prova usare DROP TABLE appops_lab.mode_items, appops_lab.zone_example; dopo averne verificato nomi e conservazione. Ripristinare file, impostazioni di sessione ed eliminare tabelle sono operazioni distinte. DROP TABLE non ripristina la configurazione del server e un normale ROLLBACK non recupera le tabelle eliminate.