---
title: "在浏览器中将 PostgreSQL 迁移到 MariaDB"
description: "将 PostgreSQL 数据库迁移到 MariaDB：把 pg_dump 文件转换为表、键和数据相同的脚本，并报告每项更改。"
canonical: https://intosql.com/zh-cn/postgresql-to-mariadb
last_updated: 2026-10-15
---

# 在浏览器中将 PostgreSQL 迁移到 MariaDB

拖入由 pg_dump 或 pg_dumpall 生成的纯文本转储（.sql 或 .sql.gz），即可下载包含相同表、键、索引和数据的 MariaDB 脚本。MariaDB 无法原样存储的每个值，以及它不支持的每个对象，都会在报告中列出。

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

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

## 从 PostgreSQL 到 MariaDB 的变化

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

| 在 PostgreSQL 中 | 在 MariaDB 中 | 报告记录 |
| --- | --- | --- |
| boolean | tinyint(1) |  |
| varchar(n), char(n), text | 不超过 1024 个字符时为 varchar(n)，不超过 255 时为 char(n)，更长则为 text |  |
| numeric(p,s) past 65 digits or 30 decimals, and numeric values past what decimal(65,30) holds | varchar | `decimal_as_text` |
| money | decimal(19,2) | `type_replaced` |
| interval | varchar(100)，存放 PostgreSQL 的文本 | `type_replaced` |
| arrays (integer[], text[]...) | json 数组 | `type_replaced` |
| ranges, geometric types, tsvector, xml, hstore, composite and extension types | longtext，存放 PostgreSQL 的文本 | `type_replaced` |
| json, jsonb | json |  |
| timestamp | datetime(p) |  |
| timestamp with time zone | UTC 的 datetime(p) | `moments_as_utc` |
| time | time(p) |  |
| infinity, -infinity, BC dates and years past 9999 | NULL | `date_out_of_range` |
| NaN and Infinity in numeric, real and double precision | NULL | `invalid_value_null` |
| NOT NULL columns with values that become NULL | 去除 NOT NULL | `not_null_relaxed` |
| enum types | enum(...)，标签相同 |  |
| uuid, inet, cidr | uuid 为 uuid，inet 和 cidr 为 varchar(43) |  |
| bytea | blob、mediumblob 或 longblob；键中为 varbinary(3072) |  |
| bit(n) | 不超过 64 位时为 bit(n)，更长则为文本 |  |
| citext and nondeterministic collations | 精确比较 | `case_insensitive_collation` |
| serial, identity | AUTO_INCREMENT，从最大的 id 之后继续 |  |
| a second serial or identity column in a table | 普通整数 | `counter_dropped` |
| sequences not owned by a column | CREATE SEQUENCE，从它下一个要分配的值开始 |  |
| generated columns | 生成列，与源数据一样为 STORED |  |
| generated columns with functions MariaDB lacks | 普通列 | `generated_not_translated` |
| defaults with functions MariaDB lacks, and defaults from a sequence | 无默认值 | `default_not_translated` |
| CHECK constraints | 已转换，内联在 CREATE TABLE 中 |  |
| CHECK constraints with functions MariaDB lacks | 不创建 | `check_skipped` |
| CHECK ... NOT VALID | 不创建 | `check_not_valid` |
| gin, gist, brin and hash indexes, partial and expression indexes | 不创建 | `index_skipped` |
| foreign keys | 外键，以 FOREIGN_KEY_CHECKS=0 导入 |  |
| foreign keys to tables the dump doesn't create | 不创建 | `foreign_key_skipped` |
| partitioned tables | 单个表，包含每个分区的行 | `partitions_dropped` |
| schemas | 单个数据库，每个表名前加上其 schema 名 | `schemas_merged` |
| views, functions, procedures, triggers, rules, policies, extensions and types | 在报告中列出 | `not_converted_objects` |
| dumps without CREATE TABLE (--data-only) | 根据值推断类型 | `no_schema` |
| expressions in INSERT values | NULL | `expression_value` |
| types IntoSQL doesn't know | longtext | `unknown_type` |
| text that isn't valid in its encoding | 错误的字节变为替换字符 | `invalid_utf8_replaced` |
| text decoded twice (ñ) | 按原样复制 | `mojibake_suspected` |

## 将脚本导入 MariaDB

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

```shell
mariadb --default-character-set=utf8mb4 mydb < postgresql.mariadb.sql
```

外键按转储中的声明创建，导入行时使用 FOREIGN_KEY_CHECKS=0，与 mysqldump 的做法相同。

对于较大的转储，请在服务器所在的机器上运行客户端；如果单行非常大，请调高 max_allowed_packet。

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

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

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

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

## 哪些内容不会转换

视图、物化视图、函数、存储过程、触发器、规则、行安全策略、扩展和类型都是用 PostgreSQL 自己的语言编写的。它们会按名称在报告中列出，绝不会被悄悄丢弃，以便你为 MariaDB 重写。

## 关于 PostgreSQL 转 MariaDB 的问题

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

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

### 转储可以多大？

转换器从不把整个转储放进内存：它按范围读取文件两次，边读边写出脚本。几 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 或标识列变为 AUTO_INCREMENT，从最大的 id 之后继续。不属于任何列的序列变为 MariaDB 序列，从它们已达到的值开始。

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

数组变为 JSON 数组，布尔值变为 tinyint(1)，enum 变为标签相同的 ENUM，uuid 变为 UUID，money 变为 decimal。range、几何类型、hstore 和复合类型保留 PostgreSQL 的文本，报告会说明是哪些列。

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

它们会按名称在报告中列出，但不会转换，因为每种数据库都用自己的语言编写它们。

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

MariaDB 10.11 及更高版本。每个测试转储都能在 10.11 和 11.4 上导入，如有问题会在第一个错误处停止。

## 从 PostgreSQL

- [PostgreSQL 到 PostgreSQL](https://intosql.com/zh-cn/postgresql-to-postgresql)
- [PostgreSQL 到 MySQL](https://intosql.com/zh-cn/postgresql-to-mysql)
- [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)

## 到 MariaDB

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

## 指南和所有组合

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