SuperAPI AI 工具集

claimable-postgres

数据与分析

查看项目

更新于 10-16 09:35

技能介绍

用途:Claimable Postgres 由 Neon(pg.new)提供,用于快速获得一个临时 Postgres 数据库,无需登录、注册或信用卡,适合本地开发、演示、原型制作和测试环境。数据库默认是临时的,通常 72 小时,之后可通过 claim URL 认领到 Neon 账户以永久使用。

主要能力与使用方式:

  1. CLI(默认推荐):在项目根目录运行 npx get-db,会创建数据库并把 DATABASE_URL 写入 .env。常用参数:-y/--yes 跳过提示;-e/--env <path> 指定 env 文件路径;-k/--key <name> 自定义环境变量名(默认 DATABASE_URL);-s/--seed <path> 运行 SQL 种子文件;-L/--logical-replication 启用逻辑复制;-r/--ref <id> 设置来源/引用 id。
  2. SDK(get-db/sdk):用于脚本和程序化创建流程,示例:import { instantPostgres } from "get-db/sdk"; const db = await instantPostgres(); console.log(db.connectionString);
  3. REST API:用于非 Node 环境或自定义集成,示例:curl -X POST https://pg.new/api/v1/database -H "Content-Type: application/json" -d '{"ref":"my-app"}'

代理工作流:确认用户需要临时、免注册数据库;询问使用 CLI、SDK 还是 API(默认 CLI);若用 CLI,在项目根目录运行 npx get-db;确认 DATABASE_URL 已写入目标 env 文件;提供快速连接测试(SELECT 1);说明过期时间及如何通过 claim URL 保留。

需向用户返回:连接字符串写入位置(如 .env)、使用的变量名(DATABASE_URL 或自定义)、是否存在 PUBLIC_CLAIM_URL、以及未认领数据库为临时的提醒。

限制与注意事项:不要覆盖已有 env 文件,应就地更新;执行破坏性种子 SQL(DROP、TRUNCATE、批量 DELETE)前需询问;生产工作负载建议使用标准 Neon 配置而非临时可认领数据库;如需长期持久化,应提示用户立即打开 claim URL。