从现有数据库导入
本指南提供了将数据从现有 MySQL 数据库导入到 Prisma Postgres 的分步说明。
您可以通过四个步骤完成此迁移
- 创建一个新的 Prisma Postgres 数据库。
- 使用
@prisma/ppg-tunnelpackage 直接连接到 Prisma Postgres 实例。 - 使用 pgloader 将您的 MySQL 数据迁移到 Prisma Postgres。
- 为 Prisma Postgres 配置您的 Prisma 项目。
Prerequisites
- 到您现有 MySQL 数据库的连接 URL。
- 一个帐户。
- 已安装 Node.js 18+。
- pgloader 已安装。
我们建议在单独的 git 开发分支中尝试此迁移。
1. 创建一个新的 Prisma Postgres 数据库
按照以下步骤创建一个新的 Prisma Postgres 数据库
- 登录到并打开控制台。
- 在您选择的workspace中，单击“新建项目”按钮。
- 在“名称”字段中键入您的项目名称，例如 hello-ppg。
- 在“Prisma Postgres”部分，单击“开始使用”按钮。
- 在“区域”下拉列表中，选择离您当前位置最近的区域，例如 美国东部（弗吉尼亚北部）。
- 单击“创建项目”按钮。
数据库配置完成后，在“设置数据库访问”部分找到您的 Prisma Postgres 连接 URL 并保存以备后用，您将在下一步中需要它。
2. 直接连接到 Prisma Postgres 实例
在此步骤中，您将使用安全的 TCP tunnel 连接到您的 Prisma Postgres 实例。
您将需要来自步骤 1的 Prisma Postgres 连接 URL
prisma+postgres://accelerate.prisma-data.net/?api_key=ey...
如果您在当前目录中已有一个设置了 DATABASE_URL 的 .env 文件，则隧道 CLI 将自动拾取它，无需手动导出它。但是，如果您尚未设置 .env 文件，则需要显式设置 DATABASE_URL 环境变量。
要设置环境变量，请打开您的终端并将 DATABASE_URL 环境变量设置为您的 Prisma Postgres 数据库 URL 的值（将 __API_KEY__ 占位符替换为您实际数据库连接 URL 的 API 密钥）
export DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key=__API_KEY__"
如果您在终端中显式设置 DATABASE_URL，则该值将优先于 .env 文件中的值。
接下来，通过执行以下命令，使用 @prisma/ppg-tunnel package 启动 TCP 隧道
npx @prisma/ppg-tunnel --host 127.0.0.1 --port 5433
您可以使用 --port 和 --host 标志提供您自己的主机和端口值来指定不同的主机和端口。只需确保在整个指南中始终如一地使用相同的主机和端口值。
Prisma Postgres auth proxy listening on 127.0.0.1:5433 🚀
Your connection is authenticated using your Prisma Postgres API key.
...
==============================
hostname: 127.0.0.1
port: 5433
username: <anything>
password: <none>
==============================
保持您当前的终端窗口或选项卡打开，以便隧道进程继续运行并且连接保持打开。
3. 使用 pgloader 将您的 MySQL 数据迁移到 Prisma Postgres
现在您已与您的 Prisma Postgres 实例建立活动连接，您将使用 pgloader 将数据从您的 MySQL 数据库导出到 Prisma Postgres。
打开一个单独的终端窗口并创建一个 config.load 文件
touch config.load
在您喜欢的文本编辑器中打开 config.load 文件，并复制粘贴以下配置
LOAD DATABASE
FROM mysql://username:password@host:PORT/database_name
INTO postgresql://user:password@127.0.0.1:5433/postgres
WITH quote identifiers, -- preserve table/column name case by quoting them
include drop,
create tables,
create indexes,
reset sequences
ALTER SCHEMA 'database_name' RENAME TO 'public';
确保在 config.load 文件中更新以下详细信息
FROMurl (MySQL 数据库 URL)- 将
username、password、host、PORT和database_name替换为您 MySQL 数据库的实际连接详细信息。 - 确保您的连接字符串包含
useSSL=true（如果需要 SSL），例如：mysql://username:password@host:PORT/database_name?useSSL=true。 请注意，当使用 PlanetScale 时，附加sslaccept=strict将不起作用。
- 将
INTOurl (Postgres 数据库 URL)- 如果您使用自定义
host和port，请使用您的 TCP 隧道详细信息更新此项（在本示例中，为了保持一致性，它是127.0.0.1和端口5433）。
- 如果您使用自定义
- 更新
ALTER SCHEMA 'database_name' RENAME TO 'public';中的database_name，使其与您的 MySQL 连接字符串中的database_name完全匹配。
在使用您更新的凭据保存配置文件后，在同一终端窗口中，执行以下命令
pgloader config.load
您应该看到类似于此的日志，这证实了您的数据已成功迁移
LOG report summary reset
table name errors rows bytes total time
------------------------- --------- --------- --------- --------------
fetch meta data 0 9 2.546s
Create Schemas 0 0 0.325s
Create SQL Types 0 0 0.635s
Create tables 0 6 5.695s
Set Table OIDs 0 3 0.328s
------------------------- --------- --------- --------- --------------
public.post 0 8 0.5 kB 4.255s
public."user" 0 4 0.1 kB 2.775s
public._prisma_migrations 0 1 0.2 kB 4.278s
------------------------- --------- --------- --------- --------------
COPY Threads Completion 0 4 5.095s
Index Build Completion 0 5 9.601s
Create Indexes 0 5 4.116s
Reset Sequences 0 2 4.540s
Primary Keys 0 3 2.917s
Create Foreign Keys 0 1 1.121s
Create Triggers 0 0 0.651s
Install Comments 0 0 0.000s
------------------------- --------- --------- --------- --------------
Total import time ✓ 13 0.8 kB 28.042s
如果您看到这样的输出，则表示您的数据已成功导出到您的 Prisma Postgres 实例。
您还可以使用 Prisma Studio 并验证迁移是否成功
npx prisma studio
4. 为 Prisma Postgres 配置您的 Prisma 项目
迁移数据后，您需要设置您的 Prisma 项目以与 Prisma Postgres 一起工作。步骤因您是否已在使用 Prisma ORM 而异。
如果您以前未使用 Prisma ORM
通过在您的项目目录中运行 npx prisma init 来初始化您项目中的 Prisma。 这将创建一个包含 schema.prisma 文件和 .env 文件（如果尚不存在）的 prisma 文件夹。
在生成的 .env 文件中，更新 DATABASE_URL 以匹配您在步骤 1中收到的 Prisma Postgres 连接字符串
DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key=__API_KEY__"
内省您新迁移的数据库，方法是运行
npx prisma db pull
此命令使用表示您迁移的表的模型更新您的 schema.prisma 文件，因此您可以开始使用 Prisma Client 查询您的数据或使用 Prisma Migrate 管理未来的更改。
恭喜！您已成功将您的 MySQL 数据库迁移到 Prisma Postgres 并配置了您的 Prisma 项目。您的迁移教程现已完成。
有关 Prisma 和 Prisma Postgres 入门的全面指南，请参阅从零开始使用 Prisma 和 Prisma Postgres。
如果您已在使用 Prisma ORM
在您的 schema.prisma 文件中，将 datasource 块中的 provider 从 mysql 更改为 postgresql
datasource db {
provider = "mysql"
provider = "postgres"
url = env("DATABASE_URL")
}
在生成的 .env 文件中，更新 DATABASE_URL 以匹配您在步骤 1中收到的新 Prisma Postgres 连接字符串
DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key=__API_KEY__"
内省您新迁移的 Prisma Postgres 数据库并生成 Prisma Client
npx prisma db pull
此命令根据新的数据库架构刷新您的 Prisma 模型。
如果您之前使用过 Prisma Migrate
- 删除您
prisma目录中现有的migrations文件夹。 - 基线化您的数据库以开始创建新的迁移。
恭喜！您已成功将您的 MySQL 数据库迁移到 Prisma Postgres 并配置了您的 Prisma 项目。您的迁移教程现已完成。