从MySQL迁移到PostgreSQL的完整指南

1.引言

在现代数据库管理中，选择合适的数据库系统对业务的成功至关重要。随着企业数据量的增长和对性能要求的提高，许多公司开始考虑从MySQL迁移到PostgreSQL。这一迁移的主要原因包括以下几个方面：

1.1 性能和扩展性

PostgreSQL以其高性能和优秀的扩展能力而闻名。它支持复杂的查询优化和并发控制，能够更高效地处理大规模数据。与MySQL相比，PostgreSQL在处理复杂查询和大数据集时表现更为出色。

1.2. 标准兼容性和功能丰富

PostgreSQL严格遵循SQL标准，并提供了许多高级功能，如完整的ACID事务支持、复杂的查询和索引功能、存储过程、触发器等。其丰富的功能集使得开发人员能够更加灵活地设计和实现各种数据库应用。

1.3. 开源社区和企业支持

PostgreSQL拥有一个活跃的开源社区和广泛的企业支持。无论是社区版本还是企业版本，用户都可以获得及时的技术支持和更新。这使得PostgreSQL在稳定性和安全性方面具有显著优势。

1.4. 迁移过程中的挑战和注意事项

尽管从MySQL迁移到PostgreSQL带来了诸多优势，但这一过程也伴随着一些挑战和注意事项：

1.4.1. 语法差异

MySQL和PostgreSQL在SQL语法上存在一些差异，特别是在存储过程、函数和触发器的实现上。在迁移过程中，需要对现有的SQL脚本进行适当的调整和转换，以确保在PostgreSQL中能够正常运行。

1.4.2. 数据类型兼容性

两者在数据类型的支持和实现上也存在差异。例如，MySQL的TINYINT在PostgreSQL中没有直接对应的类型，需要转换为SMALLINT。类似的差异需要在迁移前进行详细的审查和处理。

1.4.3. 性能优化

尽管PostgreSQL在性能上具有优势，但迁移后仍需要对系统进行性能调优。包括索引的重新创建、查询的优化等，以充分发挥PostgreSQL的性能优势。

1.4.4. 数据完整性验证

在迁移过程中，确保数据的一致性和完整性至关重要。需要进行全面的数据验证，确保迁移后的数据与原数据完全一致。这包括行数验证、数据对比以及存储过程和函数的功能测试。

1.4.5. 工具的选择

选择合适的迁移工具可以显著简化迁移过程。例如，pgloader、Navicat等工具可以帮助大家完成大部份迁移步骤，减少手动干预的错误风险。关于pgloader的工具使用，可以查看pgloader官方文档，在这里就不赘述了，后续如果有需要可以针对pgloader的使用给大家进行分享。

2. 迁移步骤

将数据从一个数据库系统迁移到另一个数据库系统是一个复杂且关键的任务。以下是从MySQL迁移到PostgreSQL的完整过程，涵盖了所有相关步骤。

2.1 准备工作

2.1.1. 安装并配置MySQL和PostgreSQL

在开始迁移之前，确保MySQL和PostgreSQL都已正确安装并配置。准备工作包括安装和配置数据库系统以及备份MySQL数据库。对于Mysql、PostgreSQL的配置安装可以通过yum或者apt命令进行联网安装，也可以通过二进制进行安装，具体可以参考：

• PostgreSQL16.3基于CentOS7.9源码安装步骤
• 数据库MySQL的四种安装方式

2.1.2. 备份MySQL数据库

在进行数据迁移之前，必须备份MySQL数据库以防止数据丢失。备份可以使用mysqldump工具完成。

1.备份整个数据库
使用mysqldump命令导出整个数据库，包括表结构和数据。

mysqldump -u root -p your_database > your_database_backup.sql

2.备份单个表：
如果只需要备份特定的表，可以使用以下命令：

mysqldump -u root -p your_database table_name > table_name_backup.sql

3.备份存储过程和函数：
使用--routines选项导出存储过程和函数。

mysqldump -u root -p --routines --no-create-info --no-data --skip-triggers your_database > routines_backup.sql

4.验证备份文件：
确保备份文件已正确生成，并且可以读取。可以简单地查看备份文件的内容：

less your_database_backup.sql

通过完成以上准备工作，可以确保MySQL和PostgreSQL环境已正确设置，并且数据已备份，为接下来的迁移步骤打下基础。

2.2 迁移表结构

在迁移表结构时，数据类型的转换是关键的一步。MySQL和PostgreSQL在数据类型的支持和实现上有一些差异，需要进行适当的映射和转换。以下是常用数据类型的对比：

数据类型对比

MySQL	PostgreSQL	说明
TINYINT	SMALLINT	小范围整数，PostgreSQL没有直接的TINYINT，需要转换为SMALLINT
SMALLINT	SMALLINT	小范围整数
MEDIUMINT	INTEGER	中等范围整数，PostgreSQL没有直接的MEDIUMINT，可以转换为INTEGER
INT	INTEGER	标准整数类型
BIGINT	BIGINT	大范围整数
FLOAT	REAL	单精度浮点数
DOUBLE	DOUBLE PRECISION	双精度浮点数
DECIMAL	DECIMAL	精确的小数
NUMERIC	NUMERIC	精确的小数，等同于DECIMAL
CHAR	CHAR	定长字符串
VARCHAR	VARCHAR	可变长度字符串
TINYTEXT	TEXT	小文本字段，PostgreSQL用TEXT替代
TEXT	TEXT	文本字段
MEDIUMTEXT	TEXT	中等大小文本字段，PostgreSQL用TEXT替代
LONGTEXT	TEXT	大文本字段，PostgreSQL用TEXT替代
DATE	DATE	日期
DATETIME	TIMESTAMP	日期和时间，PostgreSQL用TIMESTAMP替代
TIME	TIME	时间
YEAR	INTEGER	年份，PostgreSQL没有直接的YEAR类型，可以使用INTEGER
ENUM	VARCHAR	枚举类型，PostgreSQL没有直接的ENUM，可以使用VARCHAR
SET	VARCHAR	集合类型，PostgreSQL没有直接的SET，可以使用VARCHAR
BLOB	BYTEA	二进制大对象
TINYBLOB	BYTEA	小二进制对象，PostgreSQL用BYTEA替代
MEDIUMBLOB	BYTEA	中等大小二进制对象，PostgreSQL用BYTEA替代
LONGBLOB	BYTEA	大二进制对象，PostgreSQL用BYTEA替代

迁移步骤：

1. 导出MySQL表结构： 使用mysqldump命令导出MySQL数据库的表结构。
2. 转换表结构为PostgreSQL兼容格式： 根据上表中的数据类型对比，手动或使用工具调整导出的SQL文件，确保数据类型在PostgreSQL中正确映射。
3. 导入到PostgreSQL： 使用psql命令将转换后的表结构导入到PostgreSQL中，创建所需的表和列。

⚠️注意事项：

1. 在进行数据类型转换时，需特别注意数据类型的精度和范围，确保在PostgreSQL中的数据类型能够满足原MySQL数据的需求。
2. 特殊数据类型的转化，例如：MySQL当中的TINYINT(1)表示Boolean的字段，在PostgreSQL需要转化为Boolean类型；PostgreSQL没有MySQL的BLOB类型，所以需要把BLOB类型转化为BYTEA

2.3 迁移数据

迁移数据是从MySQL到PostgreSQL过程中最关键的一步。这个过程涉及导出MySQL数据、转换数据格式、导入到PostgreSQL以及验证数据的一致性。以下是详细的步骤描述。

2.3.1. 导出MySQL数据

首先，需要将MySQL数据库中的数据导出为一个文件。这可以通过使用mysqldump工具来实现。

导出步骤：

1. 打开终端。
2. 使用mysqldump命令导出数据 mysqldump -u [username] -p [database_name] --no-create-info > data_backup.sql 其中：

• [username]是MySQL的用户名。
• [database_name]是要导出的数据库名称。
• --no-create-info选项表示只导出数据，不包括表结构。

2. 转换数据文件格式

由于MySQL和PostgreSQL的数据格式有所不同，需要将导出的MySQL数据文件转换为适合PostgreSQL的格式。pgloader是一个强大的工具，可以简化这个过程。

转换步骤：

1. 安装pgloader(如果尚未安装): sudo yum install pgloader -y
2. 使用pgloader进行数据转换和导入:
   pgloader mysql://[username]:[password]@localhost/[database_name] postgresql://[pg_username]:[pg_password]@localhost/[pg_database_name]
   其中：

• [username]和[password]是MySQL的用户名和密码
• [database_name]是MySQL数据库的名称
• [pg_username]和[pg_password]是PostgreSQL的用户名和密码
• [pg_database_name]是PostgreSQL数据库的名称

3. 导入到PostgreSQL

如果没有使用pgloader，需要手动将数据文件导入到PostgreSQL。

导入步骤：

1. 打开终端。
2. 使用psql命令导入数据。 psql -U [pg_username] -d [pg_database_name] -f data_backup.sql 其中：

• [pg_username]是PostgreSQL的用户名。
• [pg_database_name]是要导入数据的PostgreSQL数据库名称。
• data_backup.sql是导出的MySQL数据文件。

4. 数据完整性验证

在数据导入后，需要进行数据完整性验证，以确保数据迁移过程中没有丢失或损坏。

验证步骤：

1. 行数验证:
   在MySQL和PostgreSQL中分别查询每个表的行数，确保行数一致。 SELECT COUNT(*) FROM table_name;
2. 数据对比:
   随机抽取若干条记录，比较MySQL和PostgreSQL中的数据是否一致。 SELECT * FROM table_name WHERE id = random_id;
3. 完整性检查
   确保所有外键、唯一约束等数据库完整性规则在 PostgreSQL 中正确实现
4. 业务逻辑验证
   使用应用程序的业务逻辑进行数据验证。编写脚本或程序调用应用程序接口，验证数据是否符合预期
5. 数据范围和分布验证
   验证特定列的数据范围和分布是否一致。例如，检查 日期 列的 最小值 和 最大值 是否相同
6. NULL值验证
   检查各个表中 NULL 值的分布是否一致
7. 聚合函数验证
   使用聚合函数（如： SUM、AVG、MAX、MIN ）验证数据的一致性
8. 应用程序功能测试
   通过应用程序执行常规操作，验证迁移后的数据是否支持应用程序的正常运行。包括数据 插入、更新、删除和查询 等操作

⚠️注意事项：

1. 字符编码：确保MySQL和PostgreSQL的字符编码一致，避免出现乱码问题。
2. 事务处理：在数据导入过程中使用事务，以确保数据的一致性和完整性。
3. 索引和约束：在导入数据前，可以暂时禁用索引和约束，提高数据导入速度。导入完成后再重新在PostgreSQL侧进行重建。

2.4 迁移存储过程和函数

将MySQL的存储过程和函数迁移到PostgreSQL时，需要了解两者之间的系统函数和语法差异。以下是详细的对比表格：

迁移步骤：

1. 导出MySQL存储过程和函数：
   使用mysqldump命令导出MySQL数据库中的存储过程和函数。 mysqldump -u [username] -p --routines --no-create-info --no-data --skip-triggers [database_name] > routines_backup.sql
2. 转换存储过程和函数为PostgreSQL兼容格式
   手动调整导出的存储过程和函数，使其适应PostgreSQL的语法
3. 导入到PostgreSQL
   使用psql命令将转换后的存储过程和函数导入到PostgreSQL中。 psql -U [pg_username] -d [pg_database_name] -f routines_backup_pg.sql

2.4.1 系统函数对比

功能	MySQL	PostgreSQL
当前日期和时间	NOW()	CURRENT_TIMESTAMP
当前用户	CURRENT_USER()	CURRENT_USER
字符串长度	CHAR_LENGTH(string)	LENGTH(string)
数学函数	ABS(number), ROUND(number)	ABS(number), ROUND(number)
随机数生成	RAND()	RANDOM()
子字符串	SUBSTRING(string, pos, len)	SUBSTRING(string FROM pos FOR len)
日期加减	DATE_ADD(date, INTERVAL expr unit)	date + interval 'expr unit'
日期格式化	DATE_FORMAT(date, format)	TO_CHAR(date, format)

2.4.2 语法对比

功能/特性	MySQL	PostgreSQL
存储过程定义	CREATE PROCEDURE proc_name (params) BEGIN ... END;	CREATE OR REPLACE PROCEDURE proc_name (params) LANGUAGE plpgsql AS $$ BEGIN ... END; $$;
函数定义	CREATE FUNCTION func_name (params) RETURNS type BEGIN ... END;	CREATE OR REPLACE FUNCTION func_name (params) RETURNS type LANGUAGE plpgsql AS $$ DECLARE ... BEGIN ... END; $$;
参数	输入、输出、输入输出参数	输入参数（默认），使用IN、OUT、INOUT指定
变量声明	DECLARE var_name type;	DECLARE var_name type; 在DECLARE块中
异常处理	DECLARE ... HANDLER	EXCEPTION 块
条件控制	IF ... THEN ... ELSE ... END IF;	IF ... THEN ... ELSE ... END IF;
循环控制	WHILE ... DO ... END WHILE;	WHILE ... LOOP ... END LOOP;
结果集处理	SELECT ... INTO var;	SELECT ... INTO var;

2.4.3 示例说明

• 在MySQL中定义存储过程和函数

-- 存储过程
DELIMITER //
CREATE PROCEDURE example_procedure(IN param1 INT)
BEGIN
    SELECT * FROM example_table WHERE id = param1;
END //
DELIMITER ;


-- 函数
DELIMITER //
CREATE FUNCTION example_function(param1 INT) RETURNS INT
BEGIN
    DECLARE result INT;
    SELECT column INTO result FROM example_table WHERE id = param1;
    RETURN result;
END //
DELIMITER ;

• 在PostgreSQL中转换存储过程和函数

-- 存储过程
CREATE OR REPLACE PROCEDURE example_procedure(param1 INT)
LANGUAGE plpgsql
AS $$
BEGIN
    SELECT * FROM example_table WHERE id = param1;
END;
$$;

-- 函数
CREATE OR REPLACE FUNCTION example_function(param1 INT) RETURNS INT
LANGUAGE plpgsql
AS $$
DECLARE
    result INT;
BEGIN
    SELECT column INTO result FROM example_table WHERE id = param1;
    RETURN result;
END;
$$;

2.4.3 存储过程和函数测试

迁移完成后，存储过程和函数的测试是确保迁移成功的重要步骤。测试的目的是验证在PostgreSQL中存储过程和函数的功能是否与在MySQL中一致，主要从如下几方面进行测试验证：

1. 功能测试
   需要确保每个存储过程和函数在PostgreSQL中按预期工作。可以通过创建测试用例来调用每个存储过程和函数，并验证其输出是否正确。例如，对于存储过程get_user_by_id，可以在PostgreSQL中执行CALL get_user_by_id(1);，并检查返回结果是否正确。
2. 性能测试
   对比MySQL和PostgreSQL中存储过程和函数的执行时间，确保性能没有显著下降。这可以通过在两个数据库中分别执行相同的存储过程或函数，并记录其执行时间来实现。例如，在MySQL中执行CALL get_user_by_id(1);，然后在PostgreSQL中执行相同的命令，并比较执行时间。
3. 边界测试
   测试存储过程和函数的边界情况，如最大和最小输入值，空值处理，异常情况等。例如，可以在PostgreSQL中执行CALL
   get_user_by_id(NULL);、CALL get_user_by_id(-1);和CALL
   get_user_by_id(99999999);，以确保存储过程和函数能够正确处理各种输入情况。
4. 集成测试
   通过应用程序执行常规操作，验证迁移后的数据是否支持应用程序的正常运行。这包括在应用程序中调用存储过程和函数，并验证结果是否与预期一致。例如，在Java应用程序中，通过JDBC连接到PostgreSQL数据库，调用存储过程get_user_by_id，并检查返回结果是否正确。

3.注意事项

数据的迁移大多都是基于实际的生成环境中进行，为了尽可能减少对于业务的影响，我们应该通过细致的规划和执行，合理的停机时长规划、应用改造和生产环境验证等来确保迁移过程的顺利和成功，最大程度地减少对业务的影响，一下为在整个迁移过程中需要考虑的注意事项：

1.停机时长的考虑
迁移过程中，停机时长是一个重要的考虑因素。数据量越大，迁移所需的时间越长。因此，建议在数据量较少或业务低峰期进行迁移，以减少对生产环境的影响。为了确保数据的一致性，在停机前需要备份所有数据，并确保在迁移过程中不进行数据修改。
2.缩短停机时间的方法
为了尽可能缩短停机时间，可以考虑使用增量备份和恢复的方法，减少全量数据备份和恢复所需的时间。此外，提前准备好迁移所需的脚本和配置，可以减少实际迁移操作的时间。
3.代码兼容性
迁移过程中，需要修改应用程序的数据库连接配置，确保连接到PostgreSQL。同时，检查并修改应用程序中所有的SQL查询，确保其在PostgreSQL中能够正确执行。尤其注意MySQL特有的语法和函数，需替换为PostgreSQL兼容的语法和函数。
4.功能验证
迁移完成后，需要进行功能验证。编写和执行单元测试，确保应用程序中的所有功能在使用PostgreSQL时能够正常运行。此外，在测试环境中进行全面的集成测试，模拟生产环境中的实际操作，确保所有业务流程能够正常执行。
5.数据验证
数据验证是迁移过程中的关键步骤。使用行数验证、数据对比、校验和验证等方法，确保迁移后数据的完整性和一致性。同时，验证特定列的数据范围和分布是否一致，如日期列的最小值和最大值是否相同。
6.性能验证
性能验证也是迁移过程中不可忽视的一部分。对比迁移前后关键查询的执行时间，确保PostgreSQL中的查询性能满足需求。通过性能测试，确保PostgreSQL中的存储过程和函数的执行时间在可接受范围内。
7.系统稳定性
为了确保系统的稳定性，建议在生产环境中进行压力测试，验证系统在高负载下的稳定性和性能。同时，设置详细的监控和日志记录，及时发现和解决潜在的问题。
8.关键注意事项
在进行任何迁移操作前，务必做好全面的数据备份，以防迁移过程中出现数据丢失或损坏的情况。制定详细的迁移计划，包括每个步骤的时间安排、责任人和应急预案。如果可能，分阶段逐步实施迁移，逐步验证每个阶段的结果，以降低整体迁移的风险。

总结

从MySQL迁移到PostgreSQL是一个复杂但必要的过程，它能够为系统带来更高的性能、丰富的功能集和更强的扩展能力。整个迁移过程包括准备工作、迁移表结构、迁移数据、迁移存储过程和函数以及数据完整性验证。在每个步骤中都需要细致的规划和执行，以确保数据的一致性和完整性。

在迁移过程中，需要仔细考虑停机时长、应用改造以及生产环境中的实际验证。停机时长的规划直接影响业务的连续性，建议在业务低峰期进行迁移，并使用增量备份和恢复的方法以缩短停机时间。应用改造方面，需修改数据库连接配置和SQL查询，确保兼容PostgreSQL。生产环境验证是确保迁移成功的关键步骤，包括数据验证、性能验证和系统稳定性测试。通过行数验证、数据对比、校验和验证等方法，可以确保数据的完整性和一致性。同时，性能测试和压力测试能够确保系统在迁移后的高效稳定运行。

通过细致的规划和执行，从MySQL迁移到PostgreSQL不仅能够提升系统性能，还能为未来的发展打下坚实的基础。希望本文提供的详细步骤和注意事项能够帮助您顺利完成迁移过程，实现系统的平稳过渡和功能增强。

参考链接

以下是一些关于从MySQL迁移到PostgreSQL的参考文章和链接，这些资源可以为您提供更多的技术细节：

• PostgreSQL Official Documentation
• MySQL to PostgreSQL Migration Guide
• pgloader Documentation
• mysqldump Documentation