跳到主要内容

工具

您可以使用 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 环境变量。

在您的终端中，设置引用您要连接的 Prisma Postgres 实例的 DATABASE_URL 环境变量（请务必将 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 号。
    • 用户：由于隧道，此项将被忽略，您可以在此处提供任何值。
    • 密码：由于隧道，此项将被忽略，您可以在此处提供任何值。
  4. 点击 连接 以连接到您的 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 号。
    • 用户：由于隧道，此项将被忽略，您可以将此字段留空。
    • 密码：由于隧道，此项将被忽略，您可以将此字段留空。
    • URL：在 URL 的末尾添加以下查询参数 ?sslmode=disable。
  4. 点击 测试连接 以确保 DataGrip 可以连接到您的 Prisma Postgres 实例。成功后，点击 确定 保存连接。

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. 点击 测试连接 以确保 DBeaver 可以连接到您的 Prisma Postgres 实例。如果成功，点击 完成。

View of DBeaver connected to Prisma Postgres via tunnel

2d. 使用 Postico 连接到 Prisma Postgres​

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

  1. 打开 Postico 并点击 新建服务器 按钮以添加新连接。
  2. 输入以下详细信息
    • 名称：您希望为连接指定的任何名称。
    • 主机：在本例中为 127.0.0.1。
    • 端口：您从 @prisma/ppg-tunnel 软件包输出中获得的 port 号。
    • 用户：由于隧道，此项将被忽略，您可以将此字段留空。
    • 密码：由于隧道，此项将被忽略，您可以将此字段留空。
  3. 勾选“预连接 Shell 脚本”并输入 
    cat <<eof
    {
    "sslmode":"disable",
    }
    eof
  4. 点击 测试连接 以确保 Postico 可以连接到您的 Prisma Postgres 实例。如果成功，点击 连接。

View of Postico connected to Prisma Postgres via tunnel