Relyt One et Neon, fait par fait

Migrer à la main une base de données Postgres vers Relyt One

Un export et une restauration manuels avec les outils clients PostgreSQL standard. Il s’adresse aux bases de données source en PostgreSQL 17 ou antérieur, comme un serveur local ou une base de données Neon dans l’une de ces versions. Remplacez les valeurs d’exemple de la première étape par vos propres chaînes de connexion, puis exécutez chaque bloc dans l’ordre.

Ces commandes ont été rejouées telles quelles entre deux serveurs PostgreSQL 17, avec les outils clients PostgreSQL 17.

1. 01

   Définir les deux chaînes de connexion

   Créez un projet dans Relyt One et copiez sa chaîne de connexion. Exportez-la avec la chaîne de connexion de la base de données source. Relyt One utilise PostgreSQL 17 ; pg_dump doit être au moins aussi récent que le serveur source, vérifiez donc sa version. Si la source est Neon, utilisez sa chaîne de connexion directe (sans pooler) : la documentation de Neon déconseille d’exécuter pg_dump via une connexion avec pooler. Si la source utilise une version plus récente que PostgreSQL 17 (par exemple Postgres 18 sur Neon), la restauration dans le PostgreSQL 17 de Relyt One n’est pas prise en charge.

   export SOURCE_DATABASE_URL="postgresql://<user>:<password>@<source-host>/<dbname>"
   export TARGET_DATABASE_URL="postgresql://<user>:<password>@<relyt-one-host>/<dbname>"
   pg_dump --version

2. 02

   Comparer les extensions

   Listez les extensions utilisées par la base de données source, puis celles disponibles dans votre base de données Relyt One. Si un élément dont dépend la source manque dans la seconde liste, les objets qui en dépendent ne pourront pas être restaurés : adaptez d’abord le schéma.

   psql "$SOURCE_DATABASE_URL" -c "SELECT extname, extversion FROM pg_extension ORDER BY 1;"
   psql "$TARGET_DATABASE_URL" -c "SELECT name, default_version FROM pg_available_extensions ORDER BY 1;"

3. 03

   Exporter la source

   Écrivez dans un fichier local une archive au format personnalisé (-Fc) de la base de données source. -v affiche chaque objet au fur et à mesure de l’export.

   pg_dump -Fc -v -d "$SOURCE_DATABASE_URL" -f source.dump

4. 04

   Restaurer dans Relyt One

   Restaurez l’archive dans votre base de données Relyt One. --no-owner et --no-acl ignorent les instructions de propriétaire et de privilèges de la source, dont les rôles n’existent généralement pas dans la cible : les objets restaurés appartiennent au rôle avec lequel vous vous connectez.

   pg_restore -v --no-owner --no-acl -d "$TARGET_DATABASE_URL" source.dump

5. 05

   Comparer le nombre de lignes

   Comptez les lignes de chaque table des deux côtés et comparez les deux sorties. Lorsqu’elles concordent, pointez votre application vers la chaîne de connexion Relyt One.

   for url in "$SOURCE_DATABASE_URL" "$TARGET_DATABASE_URL"; do
     psql "$url" -c "SELECT table_schema, table_name, (xpath('/row/c/text()', query_to_xml(format('SELECT count(*) AS c FROM %I.%I', table_schema, table_name), false, true, '')))[1]::text::bigint AS row_count FROM information_schema.tables WHERE table_type = 'BASE TABLE' AND table_schema NOT IN ('pg_catalog', 'information_schema') ORDER BY 1, 2;"
   done