Quand une application WinDev part vers .NET, sa base HFSQL doit partir aussi, et c’est souvent là que les projets se jouent. Une base de dix ans contient des types approximatifs, des encodages hérités, des clés qui n’en sont pas, et un volume que personne n’a mesuré depuis longtemps. Voici comment un hub de synchronisation de 108 tables et 6,2 millions de lignes a été migré vers SQL Server, sans perte et avec une preuve pour chaque table.
Le contexte : un hub au centre de tout
Le logiciel migré est un hub de synchronisation : il relie l’ERP d’un distributeur à ses sites e-commerce, à des places de marché et à des transporteurs. Développé en WinDev sur une base HFSQL, il était devenu un point unique de fragilité : base propriétaire difficile à sauvegarder et à interroger, évolutions coûteuses, dépendance à une compétence rare.
La cible retenue au cadrage : C# / .NET 8 pour le code, SQL Server 2017 pour les données. Le choix d’une version précise de SQL Server n’est pas un détail : il fixe les fonctionnalités que le nouveau schéma a le droit d’utiliser.
Cartographier avant de migrer : 108 tables, 1 124 champs
La première étape n’écrit rien dans SQL Server. Elle lit HFSQL : 108 tables et 1 124 champs ont été cartographiés, avec leur type réel, leur usage réel et leurs liaisons. La source fait foi ; la documentation, quand elle existe, sert de point de comparaison, pas de référence.
Cette cartographie révèle ce qu’une base HFSQL accumule avec le temps :
- des types choisis par commodité : montants en réel, dates en chaîne, booléens en entier ;
- des encodages hérités, qui se manifestent sur les accents et les caractères spéciaux au premier export ;
- des clés garanties par le code WinDev plutôt que par la base, et des index posés au fil des besoins ;
- une volumétrie concentrée sur quelques tables, qui dictera la stratégie d’import.
Sans cette étape, chaque surprise arrive en recette, c’est-à-dire au pire moment.
Importer fidèlement, puis moderniser
La tentation est de copier HFSQL « à l’identique » dans SQL Server et de passer à la suite. C’est rapide le premier jour et coûteux tous les suivants : on obtient une base relationnelle qui n’en a que le nom, sans intégrité référentielle, avec des conversions de types dans chaque requête.
La démarche retenue sépare deux temps :
- Un import fidèle en zone de staging. Chaque table HFSQL est recopiée telle quelle dans un schéma de staging. Ce staging prouve que tout a été lu, et il permet de rejouer la suite autant de fois que nécessaire sans retoucher la source.
- Une transformation vers un schéma modernisé. À partir du staging, on construit le schéma cible : types corrects, clés primaires et étrangères, contraintes, index utiles. Les décisions sont consignées, table par table.
Le staging est la version « rapide » que tout le monde voulait ; simplement, il est assumé comme une étape et non comme une fin.
Un import parallélisé : 2 minutes en local, 46 minutes en production
La volumétrie impose de mesurer. L’importeur .NET 8 a été parallélisé, et les chiffres parlent d’eux-mêmes :
- environ 2 minutes pour l’import complet sur un poste local ;
- environ 46 minutes en production, à travers un VPN, pour 6,2 millions de lignes et 92 tables dans le périmètre de l’import.
Cet écart entre local et production n’est pas une anomalie : c’est la latence réseau. Le mesurer à l’avance permet de dimensionner la fenêtre de bascule au lieu de la découvrir le jour J. Il explique aussi pourquoi chaque table doit pouvoir être rejouée seule : sur 46 minutes, un incident sur une table ne doit pas obliger à tout recommencer.
La preuve : source = cible, systématiquement
Une migration sans preuve est une rumeur. Pour chaque table du périmètre, un contrôle compare la source HFSQL et la cible SQL Server : comptages, contrôles de contenu, cohérence des clés. Le contrôle est systématique, pas par sondage, et il est rejoué après chaque import.
C’est cette preuve, table par table, que l’on présente à la direction et aux utilisateurs. Elle vaut plus que n’importe quelle démonstration d’écran.
Le runbook de bascule
Le dernier livrable n’est pas du code : c’est un runbook, la liste ordonnée des opérations de bascule, avec pour chacune la durée mesurée, le contrôle attendu et le retour arrière possible. Il a été répété avant le jour J. Le jour J, on l’exécute ; on n’improvise pas.
Le rôle de l’équipe métier
La preuve technique ne dispense pas de la recette métier ; elle la rend possible. Tant que les comptages et les contrôles ne sont pas au vert, demander aux utilisateurs de valider serait leur faire perdre leur temps. Une fois la preuve établie, leur travail devient précis : rejouer leurs cas réels, une commande, une expédition, un retour, et constater que le résultat est le même.
Le staging y contribue directement. Comme il conserve une copie fidèle de la source, on peut, pendant toute la recette, comparer une valeur de l’ancien monde et une valeur du nouveau sans rouvrir l’application WinDev. Les écarts remontés par les utilisateurs se diagnostiquent en quelques minutes au lieu de quelques heures, et chacun est tranché avant la bascule, jamais après.
Les pièges, en résumé
- Types et encodages HFSQL : les découvrir à la cartographie, pas à la recette.
- Clés et index : ce que le code WinDev garantissait doit être garanti par la base cible.
- Volumétrie : mesurer l’import en conditions réelles, réseau compris.
- Recette métier : la preuve technique source = cible ne remplace pas la validation des utilisateurs sur leurs cas réels ; elle la rend possible.
La migration de la base est la première étape de la méthode complète décrite dans Migrer une application WinDev vers .NET sans régression. Si vous avez une base HFSQL à sortir, la page services décrit l’audit qui précède toute migration : nombre de tables, volumes, systèmes connectés, scénarios.
Pour aller plus loin : la page Migration WinDev rassemble la méthode en six étapes, les cas réalisés chiffrés et un simulateur d’estimation en jours-homme.