跳到主内容

从现有数据库导入数据

PostgreSQL

本指南提供了将数据从现有 PostgreSQL 数据库导入到 Prisma Postgres 的分步说明。

您可以通过三个步骤完成此迁移

  1. 创建一个新的 Prisma Postgres 数据库。
  2. 通过 pg_dump 导出您的现有数据。
  3. 通过 pg_restore 将之前导出的数据导入到 Prisma Postgres。

在第三步中，您将使用直接连接在运行 pg_restore 期间安全地连接到您的 Prisma Postgres 数据库。

先决条件​

  • 现有 PostgreSQL 数据库的连接 URL
  • 一个账户
  • 已安装 Node.js 18+
  • PostgreSQL CLI 工具（pg_dump、pg_restore），用于创建和恢复备份

1. 创建一个新的 Prisma Postgres 数据库​

按照以下步骤创建一个新的 Prisma Postgres 数据库

  1. 登录到并打开控制台。
  2. 在您选择的工作区中，点击新建项目按钮。
  3. 在名称字段中输入您的项目名称，例如hello-ppg。
  4. 在Prisma Postgres部分，点击开始使用按钮。
  5. 在区域下拉菜单中，选择离您当前位置最近的区域，例如美国东部（北弗吉尼亚）。
  6. 点击创建项目按钮。

您的 Prisma Postgres 实例创建完成后，您可以进入下一步。

2. 从现有数据库导出数据​

在此步骤中，您将从现有数据库导出数据，并将其存储在本地计算机上的 .bak 文件中。

确保您已准备好现有数据库的连接 URL，其结构应如下所示

postgresql://USER:PASSWORD@HOST:PORT/DATABASE

展开下方以查看提供商特定的说明，帮助您确定正确的连接字符串

Neon

  • 确保通过关闭连接池开关来选择非池化连接字符串。
  • sslmode 必须设置为 require 并附加到您的 Neon 数据库 URL，命令才能生效。
  • 连接 URL 应类似于这样 
    postgresql://USER:PASSWORD@YOUR-NEON-HOST/DATABASE?sslmode=require
Supabase
  • 使用采用 Supavisor 会话模式 的数据库连接 URL。
  • 连接 URL 应类似于这样 
    postgres://postgres.apbkobhfnmcqqzqeeqss:[YOUR-PASSWORD]@aws-0-ca-central-1.pooler.supabase.com:5432/postgres

接下来，运行以下命令导出 PostgreSQL 数据库的数据（将 `__DATABASE_URL__` 占位符替换为您的实际数据库连接 URL）

pg_dump \
  -Fc \
  -v \
  -d __DATABASE_URL__ \
  -n public \
  -f db_dump.bak

以下是此命令使用的 CLI 选项的快速概述

  • -Fc: 使用自定义备份格式，推荐用于 pg_restore
  • -v: 以详细模式运行 pg_dump
  • -d: 指定数据库连接字符串
  • -n: 指定目标 PostgreSQL schema
  • -f: 指定备份文件的输出名称

运行此命令将创建一个名为 db_dump.bak 的备份文件，您将在下一步中使用它将数据恢复到您的 Prisma Postgres 数据库中。

3. 将数据导入 Prisma Postgres​

在本节中，您将使用TCP 隧道连接到您的 Prisma Postgres 实例，并通过 `pg_restore` 导入数据。

3.1. 使用 @prisma/ppg-tunnel 连接到 Prisma Postgres 数据库​

打开一个新终端并设置您的 Prisma Postgres 数据库连接 URL 的环境变量。

export DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key=eyJhbGciOiJIUzI..."

运行隧道

npx @prisma/ppg-tunnel --host 127.0.0.1 --port 5432

您应该看到类似于以下内容的输出

Prisma Postgres auth proxy listening on 127.0.0.1:52604 🚀

Your connection is authenticated using your Prisma Postgres API key.
...

==============================
hostname:  127.0.0.1
port:      52604
username:  <anything>
password:  <none>
==============================
注意

保持此隧道进程运行以维持连接！

3.2. 使用 pg_restore 恢复备份​

使用第 2 步中的备份文件，通过运行此命令，使用 pg_restore 将数据恢复到 Prisma Postgres 数据库中

PGSSLMODE=disable \
pg_restore \
  -h 127.0.0.1 \
  -p 5432 \
  -v \
  -d postgres \
  ./db_dump.bak \
&& echo "-complete-"

命令执行完成后，您将成功地将数据从现有 PostgreSQL 数据库导入到 Prisma Postgres 🎉

要验证导入是否成功，您可以使用Prisma Studio。您可以在您的项目中点击左侧导航栏中的Studio选项卡打开它，或者运行此命令在本地启动 Prisma Studio

npx prisma studio

4. 更新您的应用程序代码以查询 Prisma Postgres​

场景 A：您已在使用 Prisma ORM​

如果您已经在使用 Prisma ORM，您只需执行以下操作：

  • 将 Prisma Accelerate 扩展添加到您的项目
  • 更新数据库连接 URL 并重新生成 Prisma Client

4.A.1. 添加 Prisma Accelerate 扩展​

使用 Prisma Postgres 时，Prisma Accelerate 扩展是必需的。如果您目前尚未将 Prisma Accelerate 与 Prisma ORM 结合使用，请按照以下步骤使 Prisma ORM 与 Prisma Postgres 协同工作。

首先，在您的项目中安装 `@prisma/extension-accelerate` 包

npm install @prisma/extension-accelerate

然后，将此扩展添加到您的 Prisma Client 实例中

import { withAccelerate } from '@prisma/extension-accelerate'

const prisma = new PrismaClient().$extends(withAccelerate())

4.A.2. 更新数据库连接 URL​

数据库连接 URL 是通过 `schema.prisma` 文件中 `datasource` 块的 `url` 配置的。通常，它通过一个名为 `DATABASE_URL` 的环境变量设置

schema.prisma
datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

接下来的步骤假设您使用 `.env` 文件来设置 `DATABASE_URL` 环境变量（如果不是这种情况，您可以按您偏好的方式设置环境变量）。

打开 `.env` 文件并更新 `DATABASE_URL` 环境变量的值，使其与您的 Prisma Postgres 连接 URL 匹配，类似于这样

DATABASE_URL="prisma+postgres://accelerate.prisma-data.net/?api_key=__API_KEY__"

最后一步，您需要重新生成 Prisma Client，以便更新的环境变量生效，并且您的查询将指向 Prisma Postgres

npx prisma generate --no-engine

完成后，您可以运行您的应用程序，它应该像以前一样工作。

场景 B：您尚未开始使用 Prisma ORM​

如果您尚未开始使用 Prisma ORM，您需要执行以下步骤才能从应用程序中使用 Prisma Postgres

  1. 在您的项目中安装 Prisma CLI
  2. 内省数据库以生成 Prisma schema
  3. 生成 Prisma Client
  4. 更新应用程序中的查询以使用 Prisma ORM

您可以在本指南中找到此过程的详细分步说明：将 Prisma ORM 添加到现有项目。

© . All rights reserved.