跳到主要内容

工具

您可以使用 Prisma Studio 或第三方数据库编辑器在 Prisma Postgres 中查看和编辑数据。

在 Prisma Studio 中查看和编辑数据

对于 Prisma Postgres,托管版本的 Prisma Studio 在您的项目中可用。在您的项目环境中的中,选择左侧导航栏中的 Studio 选项卡以查看和编辑您的数据

View of Prisma Studio open in the console.

您也可以通过运行以下命令在本地运行 Prisma Studio

npx prisma studio

这应该会在 http://localhost:5555 启动一个实时服务器,您可以在其中访问并与您的数据库交互。

使用第三方数据库编辑器连接到 Prisma Postgres 实例

您可以使用第三方数据库编辑器(如 pgAdmin、TablePlus、Postico 等)通过 @prisma/ppg-tunnel 连接到您的 Prisma Postgres 实例。请参阅下面的示例,了解如何使用 TablePlus 连接。

1. 创建 TCP 隧道以直接访问 Prisma Postgres

如果您在当前目录中已有一个设置了 DATABASE_URL.env 文件,则隧道 CLI 将自动拾取它,无需手动导出。但是,如果您尚未设置 .env 文件,则需要显式设置 DATABASE_URL 环境变量。

在您的终端中,设置 DATABASE_URL 环境变量,指向您要连接的 Prisma Postgres 实例(请务必将 API_KEY 占位符替换为您的 Prisma Postgres 实例的 API 密钥值)

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

如果您在终端中显式设置了 DATABASE_URL,则该值将优先于 .env 文件中的值。

运行以下命令,通过 @prisma/ppg-tunnel 包连接到您的 Prisma Postgres 实例

npx @prisma/ppg-tunnel --host 127.0.0.1 --port 52604
显示CLI结果
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>
==============================

从上面的输出中复制 port,您将在下一步中需要它。

在使用数据库编辑器维护连接时,保持此隧道进程运行。

2a. 使用 TablePlus 连接到 Prisma Postgres

根据您使用的数据库编辑器,您可以使用从 @prisma/ppg-tunnel 包的输出中获得的详细信息连接到您的 Prisma Postgres 实例。要在 TablePlus 中添加连接字符串

  1. 打开 TablePlus 并单击 + 图标以添加新连接。
  2. 选择 PostgreSQL 作为数据库类型。
  3. 输入以下详细信息
    • 名称:您要为连接指定的任何名称。
    • 主机:在本例中为 127.0.0.1
    • 端口:您从 @prisma/ppg-tunnel 包的输出中获得的 port 号码。
    • 用户:由于隧道,这将Ignored,您可以在此处提供任何值。
    • 密码:由于隧道,这将Ignored,您可以在此处提供任何值。
  4. 单击 Connect 以连接到您的 Prisma Postgres 实例。

View of TablePlus connected to Prisma Postgres via tunnel

2b. 使用 DataGrip 连接到 Prisma Postgres

根据您使用的数据库编辑器,您可以使用从 @prisma/ppg-tunnel 包的输出中获得的详细信息连接到您的 Prisma Postgres 实例。要在 DataGrip 中添加连接字符串

  1. 打开 DataGrip 并单击 + 图标,然后选择 “数据源”。
  2. 选择 PostgreSQL 作为数据库类型。
  3. 输入以下详细信息
    • 名称:您要为连接指定的任何名称。
    • 主机:在本例中为 127.0.0.1
    • 端口:您从 @prisma/ppg-tunnel 包的输出中获得的 port 号码。
    • 用户:由于隧道,这将Ignored,您可以将此字段留空。
    • 密码:由于隧道,这将Ignored,您可以将此字段留空。
    • URL:在 URL 中,将以下查询参数 ?sslmode=disable 附加到 URL 的末尾。
  4. 单击 Test Connection 以确保 DataGrip 可以连接到您的 Prisma Postgres 实例。成功后,单击 OK 以保存连接。

View of DataGrip connected to Prisma Postgres via tunnel

2c. 使用 DBeaver 连接到 Prisma Postgres

根据您使用的数据库编辑器,您可以使用从 @prisma/ppg-tunnel 包的输出中获得的详细信息连接到您的 Prisma Postgres 实例。要在 DBeaver 中添加连接字符串

  1. 打开 DBeaver 并单击 新建数据库连接 按钮或 文件 > 新建 以添加新连接。
  2. 选择 PostgreSQL 作为数据库类型。
  3. 在 “连接方式” 部分中选择 URL 选项。
  4. 以此格式输入 URL
    • URL:您的 URL 应采用以下格式:jdbc:postgresql://localhost:52604/postgres?sslmode=disable。在此处,请确保输入您从 @prisma/ppg-tunnel 包的输出中获得的端口号。在本例中,端口号为 52604。无需输入用户名或密码,因为身份验证由隧道管理。
  5. 单击 Test Connection 以确保 DBeaver 可以连接到您的 Prisma Postgres 实例。如果成功,请单击 Finish

View of DBeaver connected to Prisma Postgres via tunnel