Lille, le 18 novembre 2026

PostgreSQL Migrator est un produit issu des Dalibo Labs avec pour ambition de simplifier drastiquement la conversion et la copie des données vers PostgreSQL. L’outil est devenu depuis moins d’une année, le compagnon indispensable pour les chantiers de modernisation et de transition vers PostgreSQL que nous réalisons pour nos différents clients.

Bien que l’outil puisse procéder à de nombreuses conversions de façon autonome, il reste possible de contrôler finement les transformations de composants à l’aide des règles de conversion.

Les règles de conversion

Un projet de migration est composé de plusieurs fichiers techniques :

  • Les fichiers de configuration pg_migrate.toml et pg_migrate.auto.toml ;
  • Les fichiers du catalogue hors-ligne, au format JSON dans un répertoire caché .pg_migrate ;
  • Les fichiers de traces .log et de profiling (profile.json).

Toute transformation se déclare dans l’un des deux fichiers TOML. À l’instar du fichier postgresql.auto.conf, le fichier pg_migrate.auto.toml surcharge les valeurs définies dans le fichier pg_migrate.toml. Son principal intérêt réside dans la génération de configuration que nous verrons en fin de cet article.

Une règle de conversion spécifique à une colonne doit être un élément du tableau Convert.Rules. Grâce à elle, il est possible de renommer une colonne, changer son type, son expression, etc. La documentation présente les différentes syntaxes. L’exemple ci-dessous correspond à une règle qui convertit la colonne DATE_CREATION en type date (au lieu du type timestamp without time zone par défaut) tout en lui affectant une nouvelle expression de valeur par défaut current_date.

[[Convert.Rules]]
Path = "Tables/DEMO.CLIENT/Columns/DATE_CREATION"
Type = "date"
Expression = "current_date"

Le chemin d’un composant (le Path) est un identifiant unique au sein du catalogue hors-ligne. Il est construit pendant la phase d’inspection du modèle de donnée source.

Il existe d’autres configurations pour appliquer des transformations génériques, c’est-à-dire, appliquées à l’ensemble des composants. Chaque connecteur dispose de sa propre table de correspondance, accessible dans la documentation Il est possible de surcharger ou de compléter cette table à l’aide du tableau associatif Convert.DataTypes.

[Convert.DataTypes]
"NUMBER(28,0)" = "bigint"

D’autres règles comme RenameConstraints et RenameIndexes s’inspirent d’une pratique très courante pour régler les conflits d’espace de noms. Ces options sont similaires à INDEXES_RENAMING de l’outil Ora2Pg, pour le renommage automatique des index.

Génération de configuration

Très souvent, il devient pertinent de dupliquer une règle spécifique d’une colonne à une autre colonne qui partage les mêmes caractéristiques techniques ou métiers. Dans ce cas précis, les conversions génériques ne peuvent pas nous aider.

PostgreSQL Migrator propose une fonctionnalité expérimentale très utile, capable de générer le fichier pg_migrate.auto.toml à l’aide du moteur de templating fourni avec le langage Go. Il devient alors possible de traiter les données du catalogue pour généraliser une règle de conversion à un sous-ensemble de composants.

L’exemple ci-dessous provient d’un fichier de template, nommé pg_migrate.auto.toml.tmpl (oui, nous n’avons pas peur des extensions de fichier). En substance, ce template identifie dans le modèle source toutes les colonnes ayant pour expression SYSDATE et leur applique la règle de conversion présenté plus haut.

# Code generated from pg_migrate.auto.toml.tmpl - DO NOT EDIT.
{{- range .Source.Tables }}
{{- range .Columns }}
{{- if eq .Expression "SYSDATE " }}

[[Convert.Rules]]
Path = "{{ .ObjectPath }}"
Type = "date"
Expression = "current_date"
{{- end }}
{{- end }}
{{- end }}

La génération du fichier pg_migrate.auto.toml se déclenche avec la sous-commande _build (non documentée à cette heure et susceptible de changer). Elle détermine le template associé au fichier et met en relation les données catalogue Source (le fichier .pg_migrate/Source.json) avec le moteur de templating.

$ pg_migrate --verbose _build pg_migrate.auto.toml
# 15:59:15 DEBUG Read template.      path=pg_migrate.auto.toml.tmpl
#                                    fields=[Source]
# 15:59:15 INFO Rendering template.  in=pg_migrate.auto.toml.tmpl
#                                    out=pg_migrate.auto.toml

Le fichier final contient alors les règles de conversion, déclinées pour chaque colonne métier concernée.

# Code generated from pg_migrate.auto.toml.tmpl - DO NOT EDIT.
[[Convert.Rules]]
Path = "Tables/DEMO.CLIENT/Columns/DATE_CREATION"
Type = "date"
Expression = "current_date"

[[Convert.Rules]]
Path = "Tables/DEMO.COMMANDE/Columns/DATE_COMMANDE"
Type = "date"
Expression = "current_date"

Moderniser nos pratiques

Le système actuel de conversion a fait l’objet de plusieurs itérations durant l’élaboration du produit PostgreSQL Migrator. Nos nombreuses expériences dans la conversion de modèles de données Oracle ont été condensées dans ce moteur léger et bigrement efficace.

La fonctionnalité de générateur, entièrement basée sur ce que le langage Go peut offrir, est présente depuis les tous premiers jours de l’outil. Nous pensons qu’elle sera appréciée par un public très large, adepte des pratiques modernes dans la déclaration de configuration.

Vous souhaitez tester l’outil ? Découvrez notre guide en ligne pour en appréhender les différentes fonctionnalités.


DALIBO

DALIBO est le spécialiste français de PostgreSQL®. Nous proposons du support, de la formation et du conseil depuis 2005.