---
title: "将 PostgreSQL 转储迁移到另一个版本"
description: "将 PostgreSQL 10 及以上的 pg_dump 文件转换为可在 PostgreSQL 13 到 18 导入的脚本，表、键和数据相同，并报告每项更改。"
canonical: https://intosql.com/zh-cn/postgresql-to-postgresql
last_updated: 2026-10-15
---

# 将 PostgreSQL 转储迁移到另一个版本

拖入由 pg_dump 或 pg_dumpall 生成的纯文本转储，格式为 .sql 或 .sql.gz，无论转储来自哪个版本，都能下载一个可在 PostgreSQL 13 到 18 导入的脚本。标识列、枚举、数组和 jsonb 保持不变，扩展带来的类型变为文本，每项更改都会列在报告中。

[PostgreSQL 到 PostgreSQL 迁移指南](https://intosql.com/docs/migrations/postgresql-to-postgresql)

[PostgreSQL 到 PostgreSQL 的数据类型](https://intosql.com/docs/types/postgresql-to-postgresql)

## 文件与脚本之间的变化

每一行是转换器应用的一条规则，以及该规则更改你的数据时在报告中写入的记录。

| 文件中 | 脚本中 | 报告记录 |
| --- | --- | --- |
| varchar(n), char(n), text | 相同的类型 |  |
| numeric(p,s), numeric without a precision, NaN and Infinity | 相同的类型和值 |  |
| money | numeric(19,2) | `type_replaced` |
| enum types | 相同的 enum 类型，在表之前创建 |  |
| enum columns holding values outside their labels | 不加检查约束的 text | `enum_check_skipped` |
| composite and range types the dump defines, extension types (citext, hstore, ltree, PostGIS) and multiranges | text，存放 PostgreSQL 的文本 | `type_replaced` |
| citext | text，精确比较 | `case_insensitive_collation` |
| json, jsonb | 相同的类型 |  |
| timestamp with time zone | timestamptz，时刻相同 |  |
| time, time with time zone | 相同的类型 |  |
| infinity, -infinity and BC dates | 保留 |  |
| NaN and Infinity in numeric, real and double precision | 保留 |  |
| generated columns | 相同的生成列 |  |
| generated columns with functions IntoSQL doesn't write | 带有这些值的普通列 | `generated_not_translated` |
| defaults with functions IntoSQL doesn't write | 无默认值 | `default_not_translated` |
| CHECK constraints with functions IntoSQL doesn't write | 不创建 | `check_skipped` |
| CHECK ... NOT VALID | 在行之后以 NOT VALID 添加 |  |
| gin, gist, brin and hash indexes, partial and expression indexes | 不创建 | `index_skipped` |
| foreign keys to tables the dump doesn't create | 不创建 | `foreign_key_skipped` |
| NOT NULL columns with values that become NULL | 去除 NOT NULL | `not_null_relaxed` |
| partitioned tables | 单个表，包含每个分区的行 | `partitions_dropped` |
| views, functions, procedures, triggers, rules, policies, extensions and types other than enums | 在报告中列出 | `not_converted_objects` |
| dumps without CREATE TABLE (--data-only) | 根据值推断类型 | `no_schema` |
| expressions in INSERT values | NULL | `expression_value` |
| types IntoSQL doesn't know | text | `unknown_type` |
| text that isn't valid in its encoding | 错误的字节变为替换字符 | `invalid_utf8_replaced` |
| text decoded twice (ñ) | 按原样复制 | `mojibake_suspected` |

## 将脚本导入 PostgreSQL

脚本先创建表、复制行，再添加键、索引和外键，因此导入速度快，并会在遇到第一个错误时停止。

```shell
psql -v ON_ERROR_STOP=1 -d mydb -f postgresql.postgresql.sql
```

外键先以 NOT VALID 添加，然后再验证。如果某行指向不存在的行，脚本会告诉你是哪个约束，而不是中途失败。

对于较大的转储，请先创建数据库，然后在服务器所在的机器上用 psql 运行脚本。

IntoSQL Pro 可以通过桌面应用或命令行将文件直接导入 PostgreSQL，无需生成脚本。

## 如何转储 PostgreSQL 以获得最佳结果

转换器读取转储中的内容。以下选项能让转储保留更多数据：

- --format=plain 是 pg_dump 的默认格式，写出 SQL。custom 或 directory 归档（-Fc、-Fd）可用 pg_restore -f dump.sql 转为 SQL，无需数据库服务器。
- --no-owner --no-privileges 会省略角色和授权，转换器本来也会跳过它们，因此转储更小。
- pg_dumpall 将每个数据库转储到一个文件中；每个数据库的表名前会加上该数据库名，因此不会冲突。

## 哪些内容不会转换

视图、触发器、存储过程、函数等用 PostgreSQL 自己的语言编写的对象，会按名称列在报告中，绝不会被悄悄丢弃，你可以先在要导入的 PostgreSQL 版本上逐一检查再重建。

## 关于在 PostgreSQL 版本之间迁移的问题

### 我的转储会被上传吗？

不会。转换器在你的浏览器中运行，分块从磁盘读取转储，因此转储不会离开你的电脑。桌面应用和命令行也在你的电脑上转换。

### 转储可以多大？

转换器从不把整个转储放进内存：它按范围读取文件两次，边读边写出脚本。几 GB 的转储可以在浏览器、桌面应用和命令行中转换。

### 它能读取 pg_dump -Fc 归档吗？

不能直接读取：custom 归档是二进制格式。pg_restore -f dump.sql dump.backup 会将其转为转换器读取的纯 SQL，无需连接服务器。转换器收到归档时会给出提示。

### 转储可以来自哪些 PostgreSQL 版本？

由 PostgreSQL 10 及更高版本的 pg_dump 和 pg_dumpall 写出的转储，行可以是 COPY 或 INSERT。每个测试转储都来自 PostgreSQL 13 和 18，并与其源数据逐个单元格比较。

### serial 和标识列的值会保留吗？

会。serial 和标识列保持为标识列，每行保留其 id，每个计数器从转储中序列已达到的值继续。

### 数组、enum 和其他 PostgreSQL 类型会怎样处理？

它们保持原样：数组、range、json 和 jsonb、位串，money 除外。enum 类型会以其标签重新创建。扩展带来的类型（citext、hstore、PostGIS）和复合类型变为文本，报告会说明是哪些列。

### 函数、触发器和视图怎么处理？

它们会按名称在报告中列出，但不会转换，以便你在表导入后重新创建。NOT VALID 检查约束在行之后添加，仍为未验证状态。

### 脚本可以导入哪些 PostgreSQL 版本？

PostgreSQL 13 到 18，无论转储由哪个版本写出。同一个脚本在每个版本上都能导入，如有问题会在第一个错误处停止。

## 从 PostgreSQL

- [PostgreSQL 到 MySQL](https://intosql.com/zh-cn/postgresql-to-mysql)
- [PostgreSQL 到 MariaDB](https://intosql.com/zh-cn/postgresql-to-mariadb)
- [PostgreSQL 到 SQLite](https://intosql.com/zh-cn/postgresql-to-sqlite)
- [PostgreSQL 到 SQL Server](https://intosql.com/zh-cn/postgresql-to-sql-server)
- [PostgreSQL 到 Oracle](https://intosql.com/zh-cn/postgresql-to-oracle)

## 到 PostgreSQL

- [MySQL 到 PostgreSQL](https://intosql.com/zh-cn/mysql-to-postgresql)
- [MariaDB 到 PostgreSQL](https://intosql.com/zh-cn/mariadb-to-postgresql)
- [SQL Server 到 PostgreSQL](https://intosql.com/zh-cn/sql-server-to-postgresql)
- [SQLite 到 PostgreSQL](https://intosql.com/zh-cn/sqlite-to-postgresql)
- [Oracle 到 PostgreSQL](https://intosql.com/zh-cn/oracle-to-postgresql)

## 指南和所有组合

- [PostgreSQL 到 PostgreSQL 迁移指南](https://intosql.com/docs/migrations/postgresql-to-postgresql)
- [PostgreSQL 到 PostgreSQL 的数据类型](https://intosql.com/docs/types/postgresql-to-postgresql)
- [所有数据库组合](https://intosql.com/zh-cn/database-migration)