Connecter Sovrium à PostgreSQL

Sovrium tourne sur une base SQLite embarquée par défaut. Quand vous avez besoin d'écrivains concurrents, de réplication ou d'une base gérée, pointez-le vers PostgreSQL — sans changer la config, juste une variable d'environnement.

Définir DATABASE_URL

export DATABASE_URL="postgres://user:password@db.example.com:5432/mydb"
sovrium start app.ts

Quand DATABASE_URL est défini, Sovrium choisit le moteur Postgres, se connecte et applique votre schéma dans une transaction au démarrage. Retirez-le et Sovrium revient au SQLite par défaut sans configuration.

Vérifier

Le résumé de démarrage nomme le moteur actif — un journal de démarrage qui indique encore SQLite signifie que DATABASE_URL n'a pas atteint le processus. Pour vérifier côté base de données, listez les tables créées par Sovrium :

psql "$DATABASE_URL" -c '\dt'

Vos tables configurées y apparaissent une fois l'application démarrée. Un résultat vide signifie que l'application s'est connectée à une autre base que celle que vous inspectez. Pour une application déployée, l'URL vit sur la plateforme et non dans votre shell — passez par la console de l'hébergeur (scalingo --app my-app pgsql-console, ou docker compose exec db psql -U postgres).

Suite

• Infrastructure de base de données — comment le moteur bi-dialecte choisit SQLite ou Postgres.
• Migrations de schéma — la migration au démarrage exécutée à la connexion.
• Déployer avec Docker Compose et PostgreSQL — exécuter les deux en une seule stack.