Come versionare lo schema di database nei gestionali

Puoi versionare lo schema creando script di migration numerati e applicandoli con un tool come Flyway o Liquibase. SqualiOnline conserva ogni script in un repository Git, prefissandolo con tre cifre e una descrizione (es. V001_aggiungi_tabella_clienti.sql). Gli script vengono applicati in ordine tramite un processo CI che verifica lo checksum prima dell'esecuzione. Per un gestionale medio SqualiOnline gestisce oltre 150 script di migration, con rollback testato su ambiente staging per garantire la reversibilità.

Squali Online gestisce il versioning mantenendo un unico repository di changelog dove ogni modifica è uno script SQL versione‑controlled. Utilizza Liquibase con changeset XML, ciascuno dotato di id, autore, timestamp e attributo runOnChange false per evitare riesecuzioni non volute. Il changelog viene validato in ogni pull request e eseguito automaticamente nella pipeline di build. In un progetto medio vengono generati in media 12 changeset al mese, con tempo medio di applicazione inferiore a 30 secondi su un database da 20 GB.

Le migliori pratiche includono script immutabili, testing automatizzato e backup prima di ogni applicazione. SqualiOnline richiede che ogni script sia idempotente o preveda un rollback definito, che venga sottoposto a code review in pull request e che venga eseguito su un clone di produzione in ambiente di test. Dopo l'esecuzione, lo checksum SHA‑256 dello script viene registrato nella tabella schema_version per rilevare eventuali modifiche non autorizzate. Questa procedura è stata applicata con successo in più di 200 release aziendali.

Per evitare downtime si usano migration online, aggiungendo colonne nullable o creando indici concurrently. SqualiOnline applica le migration in modalità rolling update su più istanze, usando ALTER TABLE … ADD COLUMN IF NOT EXISTS con default NULL, poi popola i dati in batch tramite job separato. Gli indici vengono creati con CREATE INDEX CONCURRENTLY (PostgreSQL) o WITH (ONLINE = ON) per SQL Server. In un gestionale con picco di 5000 richieste/min, il tempo di lock medio è passato da 45 secondi a meno di 2 secondi.

Gli strumenti più usati sono Flyway, Liquibase e DbUp, scelti in base allo stack tecnologico. SqualiOnline preferisce Flyway per applicazioni Java grazie alla sua configurazione basata su file SQL e alla semplicità di integrazione Maven/Gradle. Quando serve rollback complesso o supporto YAML/XML sceglie Liquibase, mentre per ambienti .NET utilizza DbUp. Nell'ultimo anno SqualiOnline ha distribuito 78 migration: 65% con Flyway, 25% con Liquibase e 10% con DbUp.

Si testa eseguendo le migration su una copia anonimizzata di produzione e verificando test di integrazione e performance. SqualiOnline crea uno snapshot nightly del DB di produzione, lo ripristina in ambiente staging, applica le migration e poi esegue una suite di oltre 200 test unitari e 30 test di carico. Confronta i tempi di risposta delle query chiave prima e dopo la migration; solo se la variazione è inferiore al 5% la release passa al deploy. Nell'ultimo trimestre il 96% delle migration ha superato questi test di performance senza intervento manuale.