如何将 Planetscale MySQL 迁移至 PostgreSQL？

2024-08-10 11:03:21

摆脱云厂商锁定：从 Planetscale MySQL 迁移至自托管 PostgreSQL 的实用指南

你是否正面临 Planetscale MySQL 数据库带来的成本压力或功能限制？转向自托管 PostgreSQL 或寻找更灵活的解决方案可能是你摆脱困境的关键。本文将提供一份详尽的迁移指南，帮助你将 Planetscale MySQL 数据库迁移至免费的 PostgreSQL 主机，获得更大的自由度和控制权。

云数据库迁移的挑战

直接在云托管数据库之间迁移数据并非易事，例如从 Planetscale 迁移到 Supabase。尽管 Supabase 提供了一些迁移工具，但在实际操作中可能会遇到各种复杂情况和限制。

pgloader：你的数据库迁移利器

pgloader 是一款专为将数据迁移至 PostgreSQL 而设计的强大开源工具，支持 MySQL 等多种数据源，并能轻松处理大型数据库的迁移。对于从 Planetscale 迁移至自托管 PostgreSQL 来说，pgloader 无疑是你的最佳选择。

迁移步骤详解

1. 准备工作

安装 pgloader： 参考 pgloader 官方文档，根据你的操作系统选择合适的安装方式。
导出 Planetscale 数据： 使用 Planetscale 提供的备份和导出功能将数据导出为 SQL 文件，为迁移做好准备。
设置 PostgreSQL 数据库： 在你的 PostgreSQL 主机上创建一个新的数据库，并配置好连接信息，确保迁移目标准备就绪。

2. 创建 pgloader 配置文件

创建一个名为 migration.loader 的文本文件，并在其中添加以下内容：

LOAD DATABASE
  FROM      mysql://[PLANETSCALE_USER]:[PLANETSCALE_PASSWORD]@[PLANETSCALE_HOST]:[PLANETSCALE_PORT]/[PLANETSCALE_DATABASE]
  INTO postgresql://[POSTGRES_USER]:[POSTGRES_PASSWORD]@[POSTGRES_HOST]:[POSTGRES_PORT]/[POSTGRES_DATABASE]

WITH include drop, create tables, create indexes, reset sequences

SET MySQL PARAMETERS
  character_set_client = 'utf8mb4',
  character_set_results = 'utf8mb4',
  character_set_connection = 'utf8mb4';

请将上述配置中的占位符替换为你的实际连接信息：

[PLANETSCALE_USER]：你的 Planetscale 用户名
[PLANETSCALE_PASSWORD]：你的 Planetscale 密码
[PLANETSCALE_HOST]：你的 Planetscale 数据库主机地址
[PLANETSCALE_PORT]：你的 Planetscale 数据库端口号
[PLANETSCALE_DATABASE]：你要迁移的 Planetscale 数据库名称
[POSTGRES_USER]：你的 PostgreSQL 用户名
[POSTGRES_PASSWORD]：你的 PostgreSQL 密码
[POSTGRES_HOST]：你的 PostgreSQL 数据库主机地址
[POSTGRES_PORT]：你的 PostgreSQL 数据库端口号
[POSTGRES_DATABASE]：你要迁移到的 PostgreSQL 数据库名称

3. 执行迁移

打开终端，运行以下命令：

pgloader migration.loader

pgloader 会根据配置文件连接到你的 Planetscale 和 PostgreSQL 数据库，并将数据进行迁移。

迁移过程中的注意事项

数据类型转换： 尽管 pgloader 会尽力自动转换数据类型，但在处理不同数据库系统时，仍可能遇到不兼容的情况。建议在迁移前仔细检查数据类型，并根据需要进行手动转换，以确保数据完整性。
索引和约束： 迁移过程中，索引和约束可能会丢失。为了保证数据库性能和数据完整性，建议在迁移完成后手动重建索引和约束。
数据验证： 完成迁移后，务必对数据进行全面验证，确保数据完整性和一致性，避免潜在问题。

深入 pgloader：定制你的迁移方案

pgloader 提供了丰富的选项，让你可以根据实际需求对迁移过程进行精细控制。以下是一些常用的 pgloader 选项：

--field-names-case： 控制字段名的大小写转换方式。
--type-mapping： 自定义数据类型映射规则。
--transform： 使用 SQL 语句对数据进行转换。
--log-file： 指定 pgloader 日志文件路径。
--debug： 开启调试模式，输出详细的调试信息。

总结

通过本文提供的步骤和 pgloader 这一强大工具，你可以轻松地将 Planetscale MySQL 数据库迁移至免费的 PostgreSQL 主机。这不仅能帮你摆脱对特定云厂商的依赖，还能带来更大的灵活性和控制权。

常见问题解答

pgloader 是否支持增量迁移？

是的，pgloader 支持增量迁移。你可以使用 --with-data-only 选项只迁移数据，而保留已存在的表结构。
如果迁移过程中出现错误怎么办？

查看 pgloader 的日志文件可以帮助你排查错误原因。你也可以在 pgloader 命令中添加 --debug 选项以获取更详细的调试信息。
迁移完成后，如何验证数据的一致性？

你可以使用数据库比较工具或编写 SQL 查询来比较源数据库和目标数据库中的数据。
pgloader 是否支持其他数据源？

是的，pgloader 支持多种数据源，包括 MySQL、PostgreSQL、SQLite、CSV 等。
迁移大型数据库时，需要注意哪些问题？

迁移大型数据库时，需要考虑网络带宽、磁盘空间、内存占用等因素。建议在迁移前进行充分测试，并根据实际情况调整 pgloader 的配置参数。