sqldef : La gestion de schéma déclarative par le DDL pur

Le Pitch

sqldef est un outil de gestion de schéma en ligne de commande qui synchronise l'état d'une base de données à partir d'un fichier SQL DDL standard. Là où Prisma ou Atlas imposent un langage propriétaire, sqldef parie sur l'idempotence via le SQL que vous connaissez déjà (GitHub). C'est l'approche "Terraform" appliquée aux schémas de base de données : vous définissez la cible, l'outil calcule le diff.

Sous le capot

Le binaire se décline en versions spécifiques : mysqldef, psqldef, sqlite3def et mssqldef. Au 5 février 2026, le projet atteint la version 3.9.4 et reste activement maintenu par Takashi Kokubun, une figure respectée de la communauté Ruby (GitHub Releases). L'avantage majeur réside dans l'absence de DSL (Domain Specific Language). Vous n'apprenez pas une nouvelle syntaxe pour gérer vos index ou vos contraintes de clés étrangères (GitHub README).

Cependant, l'outil montre ses limites sur les workflows complexes. sqldef se concentre exclusivement sur le DDL (Data Definition Language) et ignore le DML (Data Manipulation Language). Cela signifie qu'il ne gère pas nativement les migrations de données, comme le déplacement de valeurs d'une colonne vers une autre avant une suppression (HN Comment, Feb 2026). Pour des opérations de "rename", des annotations explicites sont nécessaires sous peine de voir l'outil supprimer puis recréer la colonne, entraînant une perte de données.

La sécurité en production est un point de friction documenté. Si le flag --enable-drop n'est pas utilisé, l'outil est relativement sûr, mais son activation peut être fatale si le diff est mal interprété par l'utilisateur (GitHub Usage Docs). Sur des bases de données de plusieurs téraoctets, le déclenchement d'un ALTER TABLE suite à un changement de type de colonne peut provoquer des locks bloquant totalement la production (HN Comment, Feb 2026).

On ne sait pas encore si le projet prévoit un support commercial ou une structure "enterprise" pour rassurer les grands comptes (Dossier UsedBy). De même, l'intégration native avec des moteurs SQL distribués comme Spanner ou CockroachDB, au-delà de la simple compatibilité PostgreSQL, est absente à ce jour (Dossier UsedBy).

L'avis de Ruben

sqldef est l'outil parfait pour les équipes qui refusent l'abstraction inutile et veulent garder le contrôle sur leur SQL. C'est une excellente alternative à Prisma pour les projets où la performance de l'inference du schéma prime sur le confort d'un ORM. Je l'utiliserais sans hésiter pour des microservices ou des projets de taille intermédiaire. En revanche, pour du multi-téraoctets critique, l'absence de gestion native du DML et le risque de table locks imprévus m'incitent à rester sur des migrations versionnées classiques, plus lourdes mais plus prévisibles.

Codez propre,
Ruben.