Relyt One 与 Neon，逐项事实对照

手动把 Postgres 数据库迁到 Relyt One

用标准的 PostgreSQL 客户端工具手动导出、恢复。适用于 PostgreSQL 17 及更早版本的源库，比如本地服务器，或运行这些版本的 Neon 数据库。先把第一步里的占位符换成你自己的连接字符串，再按顺序执行每一段命令。

这些命令已在两个 PostgreSQL 17 服务器之间、用 PostgreSQL 17 客户端工具按原样回放过。

1. 01

   设置两个连接字符串

   在 Relyt One 里创建一个项目并复制它的连接字符串，与源数据库的连接字符串一起导出为环境变量。Relyt One 运行的是 PostgreSQL 17；pg_dump 的版本不能低于源服务器，所以先查一下版本。如果源是 Neon，请用它的直连（非连接池）连接字符串：Neon 文档建议不要通过连接池运行 pg_dump。源库版本高于 PostgreSQL 17（例如 Neon 上的 Postgres 18）时，恢复到 Relyt One 的 PostgreSQL 17 不受支持。

   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

   核对扩展

   先列出源数据库用到的扩展，再列出 Relyt One 数据库里可用的扩展。源库依赖的扩展如果不在第二份列表里，依赖它的对象会恢复失败，请先调整表结构。

   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

   导出源数据库

   把源数据库导出成 custom 格式（-Fc）的归档文件，保存在本地。-v 会逐个打印导出的对象。

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

4. 04

   恢复到 Relyt One

   把归档恢复到 Relyt One 数据库。--no-owner 与 --no-acl 会跳过源库的属主与权限语句（这些角色在目标库里通常不存在），恢复出的对象归你连接时使用的角色所有。

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

5. 05

   核对行数

   在两边统计每张表的行数并对比两份输出。一致之后，把应用改连 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