DataTools

DATATOOLS — Backup, dump e riordino di database MySQL/MariaDB e Microsoft SQL Server

DataTools è un'applicazione desktop per Windows che riunisce in un'unica interfaccia le operazioni ricorrenti su database MySQL/MariaDB e Microsoft SQL Server: verifica della connessione, elenco delle tabelle, esportazione (dump) selettiva dei dati, generazione di script di ripristino e riordino intelligente dei dump SQL. Il programma si appoggia agli strumenti nativi delle rispettive piattaforme — mysql.exe, mysqldump.exe e sqlcmd.exe — orchestran­doli in modo controllato, con gestione degli errori e restituzione dell'output.

Il progetto è realizzato con tecnologia .NET Framework 4.8.1 e interfaccia Windows Forms / WPF, distribuito come applicazione eseguibile con icona dedicata e modulo di aggiornamento automatico integrato, che verifica la disponibilità di nuove versioni all'avvio.

A chi è rivolto

DataTools è pensato per sviluppatori, sistemisti, tecnici di assistenza e consulenti che gestiscono ambienti database e hanno bisogno di attività rapide e ripetibili senza scrivere ogni volta righe di comando. È particolarmente indicato per chi lavora su più installazioni o più database contemporaneamente, grazie al sistema di profili di configurazione multipli.

Gestione dei profili e delle impostazioni

Le configurazioni sono salvate in un file settings.json collocato accanto all'eseguibile, con codifica UTF-8 senza BOM. Ogni profilo è identificato dal percorso di lavoro e conserva autonomamente tutti i parametri di connessione e le opzioni di backup.

• Profili multipli: un profilo distinto per ciascun percorso gestito, con elenco ordinato dei percorsi disponibili e selezione dell'ultimo utilizzato.
• Creazione automatica del profilo al primo utilizzo di un nuovo percorso, con valori predefiniti sensati.
• Gestione completa: lettura, aggiornamento (upsert) e rimozione dei profili, normalizzazione dei dati e clonazione delle impostazioni.
• Migrazione automatica dal vecchio formato a profilo singolo al nuovo formato multi-profilo, con messaggio informativo all'avvio.
• Robustezza: in caso di file mancante o illeggibile il programma avvia con i valori predefiniti e segnala l'anomalia.

Connessione ai database

Il programma supporta due motori, selezionabili nelle impostazioni: MySQL/MariaDB e Microsoft SQL Server (riconosciuto anche con la dicitura "SqlServer"). Per ciascuno sono richiesti host, database, utente e password, oltre al percorso degli eseguibili da utilizzare.

• Test di connessione per entrambi i motori, con esecuzione di una query di verifica e restituzione immediata dell'esito.
• Percorsi eseguibili configurabili: mysql.exe, mysqldump.exe e sqlcmd.exe possono risiedere in cartelle personalizzate.
• Valorizzazione predefinita intelligente del percorso di mysqldump.exe a partire dalla cartella di mysql.exe, quando non specificato.
• Controlli di validazione su eseguibili, host, database e utente, con messaggi di errore chiari prima di ogni operazione.

Esplorazione delle tabelle

Prima di qualsiasi esportazione è possibile interrogare il database per ottenere l'elenco completo delle tabelle, ordinate alfabeticamente e pronte per la selezione. Su SQL Server l'elenco è ricavato dalle tabelle utente dello schema dbo; su MySQL/MariaDB tramite l'istruzione di visualizzazione delle tabelle.

È inoltre disponibile un filtro per prefisso del nome tabella, utile per isolare sottoinsiemi coerenti di tabelle all'interno di database condivisi.

Backup e dump selettivo

Il cuore del programma è la generazione di dump SQL, con selezione puntuale delle tabelle da esportare e un ricco set di opzioni.

• MySQL/MariaDB: dump realizzato tramite mysqldump con le opzioni selezionabili transazione singola, routine, trigger, aggiunta DROP TABLE, solo struttura (no-data) e solo dati (no-create-info). Le due ultime opzioni si escludono a vicenda e vengono normalizzate automaticamente.
• Microsoft SQL Server: generazione di uno script SQL contenente la cancellazione dei dati delle tabelle selezionate e la ricostruzione tramite istruzioni INSERT, con colonne lette dinamicamente dallo schema, gestione dell'IDENTITY_INSERT per preservare i valori delle colonne identità e transazione unica protetta da XACT_ABORT. I valori sono letti in formato XML e convertiti in modo sicuro, con escape degli apici.
• Cartella di destinazione: creazione automatica della directory di output se non esistente e scrittura del file in UTF-8 senza BOM.
• Esecuzione forzata su MySQL/MariaDB, opzionalmente, per proseguire nonostante errori durante l'importazione.

Ripristino e riordino dei dump

DataTools sa eseguire file SQL di ripristino su entrambi i motori e, per MySQL/MariaDB, offre un modulo di riordino intelligente del dump che ne riscrive il contenuto in un ordine corretto per l'importazione.

• Esecuzione di file SQL: su MySQL/MariaDB tramite redirezione dell'input (come in uno script batch), su SQL Server tramite sqlcmd con parametro di input.
• Analisi dei blocchi: il dump viene suddiviso in blocchi per tabella, riconoscendo DROP TABLE IF EXISTS e le clausole CREATE TABLE con riferimenti a chiavi esterne.
• Ordinamento topologico: le tabelle vengono ricollocate rispettando le dipendenze dichiarate, con l'ordine di creazione calcolato automaticamente e l'ordine di cancellazione ottenuto per inversione.
• Filtro per prefisso applicato anche in fase di riordino, con errore esplicito se nessuna tabella corrisponde al prefisso indicato.
• Wrapper di sicurezza: possibilità di incapsulare il dump con la disattivazione e riattivazione dei controlli sulle chiavi esterne e sui vincoli di unicità, per importazioni fluide.
• Pulizia del SQL: rimozione dei commenti di blocco, delle variabili @OLD_ e delle impostazioni di fuso orario, e sostituzione dei DROP TABLE iniziali con un'unica sequenza ordinata.
• Ripristino completo del database su SQL Server: opzione di Drop & Create con passaggio in SINGLE_USER e ROLLBACK IMMEDIATE, per ricreare il database da zero prima del caricamento.

Vantaggi

• Un'unica interfaccia per due mondi: MySQL/MariaDB e SQL Server gestiti con la stessa logica operativa e lo stesso modello di configurazione.
• Operatività rapida: elenco tabelle, selezione e dump in pochi passaggi, senza digitare comandi a mano.
• Configurazioni riutilizzabili: profili separati per ogni ambiente, con passaggio immediato dall'uno all'altro e nessun rischio di sovrascrivere i parametri altrui.
• Dump più affidabili: gestione di chiavi esterne, unicità, identità e transazioni riduce gli errori in fase di ripristino.
• Tracciabilità degli errori: gli eseguibili nativi vengono invocati con cattura completa di output ed errori; il codice di uscita diverso da zero viene segnalato con il messaggio restituito dallo strumento.
• Aggiornamenti gestiti: il controllo versione all'avvio avvisa l'utente quando è disponibile una nuova release.
• Nessuna dipendenza da server o agenti: applicazione desktop autonoma che utilizza gli strumenti client già presenti o installabili sulla macchina.

Scenari d'uso

• Backup selettivo in produzione: esportazione delle sole tabelle rilevanti, con struttura e dati, senza appesantire il database per l'intera istanza.
• Allestimento di ambienti di test: copia di un sottoinsieme di tabelle da un ambiente e ricostruzione su un altro database, con ordine di creazione corretto.
• Ripristino guidato di un dump: riordino del file SQL per eliminare gli errori di dipendenza fra tabelle e importazione con vincoli temporaneamente disattivati.
• Migrazione fra clienti o installazioni: profili separati per ciascun percorso di lavoro, pronti all'uso con un semplice cambio di selezione.
• Manutenzione periodica: salvataggio di struttura o soli dati a seconda della necessità, con o senza routine e trigger.
• Supporto tecnico su database remoti: verifica immediata della raggiungibilità del server e della correttezza delle credenziali prima di ogni intervento.
• Ambienti misti: stesso strumento per database MySQL/MariaDB e SQL Server all'interno dello stesso parco macchine.

Note tecniche

• Piattaforma: .NET Framework 4.8.1, applicazione Windows con interfaccia Windows Forms/WPF.
• Strumenti esterni richiesti: mysql.exe e mysqldump.exe per MySQL/MariaDB, sqlcmd.exe per SQL Server.
• Output generato in UTF-8 senza BOM; comunicazione con gli eseguibili in codifica UTF-8 e carattere predefinito utf8mb4 su MySQL/MariaDB.
• Gestione sicura degli argomenti da riga di comando, con quotatura dei valori contenenti spazi o caratteri speciali e corretta delimitazione degli identificatori su SQL Server.