Migrer vers Lampion
Lampion utilise du PostgreSQL standard. Aucune couche propriétaire, aucun fork.
Migrez depuis n'importe quel provider en quelques minutes avec pg_dump et pg_restore.
Vue d'ensemble
Une migration vers Lampion suit toujours le même schéma : exporter, créer, restaurer, vérifier, basculer. La majorité des migrations prennent moins de 10 minutes pour une base < 5 GB.
Prérequis — PostgreSQL client tools (pg_dump, pg_restore, psql) en version ≥ 17. Sur Debian/Ubuntu : apt install postgresql-client-17. Sur macOS : brew install postgresql@17.
Exporter la base source
Récupérez un dump complet depuis votre provider actuel. Le format custom (-Fc) est recommandé : il est compressé, supporte la restauration parallèle, et permet de filtrer à la restauration.
Pourquoi --no-owner et --no-privileges ? Lampion utilise son propre rôle cloud_admin. Ces flags évitent les erreurs role "xxx" does not exist à la restauration.
Créer le projet Lampion
Créez un projet via la console ou l'API. Vous récupérez immédiatement une connection string prête à l'emploi.
Restaurer le dump
Utilisez la connection string Lampion comme cible. Le flag --jobs=4 parallélise la restauration et accélère le processus pour les grosses bases.
Bases > 10 GB — Augmentez temporairement la taille du compute via la console (4-8 CU) avant la restauration, puis revenez à 0.25 CU. Vous économisez en temps de restore et en coût.
Vérifier la migration
Comparez le nombre de tables, d'index, et le compte de lignes pour chaque table critique.
ANALYZE post-restore — pg_restore ne lance pas ANALYZE automatiquement. Lancez VACUUM ANALYZE pour que le planner ait des statistiques fraîches sur vos tables migrées.
Basculer le trafic
Mettez à jour la DATABASE_URL de vos applications. Pour minimiser le downtime, passez en lecture seule sur la source pendant le switch.
Guides par provider
Spécificités par fournisseur source. La logique reste la même partout : exporter, restaurer, switcher.
Pièges courants
Les problèmes les plus fréquents et comment les résoudre.
Si votre source utilise pgvector, postgis ou autres, installez-les sur Lampion avant le restore via la console (Settings → Extensions) ou l'API.
$ curl -X POST -H "Authorization: Bearer $TOKEN" \ -d '{"name":"pgvector"}' \ api.lampion.cloud/v1/projects/{id}/endpoints/{eid}/extensions
Toujours utiliser --no-owner --no-privileges au dump ET au restore. Si vous avez besoin de rôles applicatifs spécifiques, créez-les après le restore via la section Roles de la console ou l'API.
Si vous avez fait un dump puis des écritures sur la source avant la coupure, les séquences peuvent être en retard. Resynchronisez-les après le switch :
SELECT setval(pg_get_serial_sequence('users', 'id'), (SELECT MAX(id) FROM users));
Pour les très grosses bases : (1) resize le compute Lampion à 8 CU avant le restore, (2) utilisez --jobs=8, (3) dumpez par schéma ou par table si possible pour pouvoir reprendre en cas d'échec, (4) ouvrez un ticket support avant la migration pour bénéficier d'un accompagnement.
Lampion impose TLS 1.3 sur toutes les connexions. Ajoutez toujours ?sslmode=require à la fin de la connection string si votre client ne le fait pas automatiquement.
Lampion utilise UTF8 et la collation en_US.utf8 par défaut. Si votre source utilise une collation différente, créez la base manuellement avec la bonne collation avant le restore.