Relyt One y Neon, dato por dato

Migrar a mano una base de datos Postgres a Relyt One

Un volcado y una restauración manuales con las herramientas cliente estándar de PostgreSQL. Sirve para bases de datos de origen con PostgreSQL 17 o anterior, como un servidor local o una base de datos de Neon con una de esas versiones. Reemplaza los marcadores del primer paso con tus propias cadenas de conexión y luego ejecuta cada bloque en orden.

Estos comandos se reprodujeron tal cual entre dos servidores PostgreSQL 17, con las herramientas cliente de PostgreSQL 17.

1. 01

   Definir las dos cadenas de conexión

   Crea un proyecto en Relyt One y copia su cadena de conexión. Expórtala junto con la cadena de conexión de la base de datos de origen. Relyt One usa PostgreSQL 17; pg_dump debe ser al menos tan reciente como el servidor de origen, así que revisa su versión. Si el origen es Neon, usa su cadena de conexión directa (sin pooler): la documentación de Neon desaconseja ejecutar pg_dump a través de una conexión con pooler. Si el origen usa una versión posterior a PostgreSQL 17 (por ejemplo, Postgres 18 en Neon), restaurarlo en el PostgreSQL 17 de Relyt One no es compatible.

   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

   Comparar extensiones

   Lista las extensiones que usa la base de datos de origen y luego las disponibles en tu base de datos de Relyt One. Si algo de lo que depende el origen no está en la segunda lista, los objetos que dependen de ello no se podrán restaurar, así que ajusta el esquema antes.

   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

   Volcar el origen

   Escribe en un archivo local un volcado en formato personalizado (-Fc) de la base de datos de origen. -v muestra cada objeto a medida que se vuelca.

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

4. 04

   Restaurar en Relyt One

   Restaura el archivo en tu base de datos de Relyt One. --no-owner y --no-acl omiten las sentencias de propietario y privilegios del origen, cuyos roles normalmente no existen en el destino, de modo que los objetos restaurados pertenecen al rol con el que te conectas.

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

5. 05

   Comparar el número de filas

   Cuenta las filas de cada tabla en ambos lados y compara las dos salidas. Cuando coincidan, apunta tu aplicación a la cadena de conexión de 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