SuperAPI AI 工具集

neon-postgres-branches

数据与分析

查看项目

更新于 10-16 01:35

技能介绍

用途:为测试与开发选择并创建正确的 Neon 分支类型,覆盖迁移测试、隔离开发环境与敏感数据场景。

主要能力:区分普通分支与仅结构(Schema-only,Beta)分支。普通分支适合用接近生产的数据做迁移、性能与行为测试;仅结构分支只复制结构、不复制数据行,适合敏感数据合规场景。若需求不明确,先问一句:需要真实数据测试,还是因数据敏感只需结构?

使用方式:默认用 Neon CLI,仅在 CLI 不可用、被阻止、无法认证或用户明确要求时改用 MCP,两者都不可用则用 REST API。先运行 neon --version 确认安装,再运行 neon projects list 确认认证与上下文。创建普通分支:neon branches create --name <branch-name> --parent <parent-branch-id-or-name> --expires-at 2026-12-15T18:02:16Z,随后可用 neon connection-string <branch-name> 获取连接串。创建仅结构分支需加 --schema-only,多项目时加 --project-id。

重置:子分支落后时可用 neon branches reset <id|name> --parent --preserve-under-name <backup-branch-name> 从父分支刷新,会覆盖子分支数据且不合并;仅子分支可重置,存在子分支时被阻止,父分支快照恢复后 24 小时内可能不可用。

适用场景:每个 PR 一个分支、每次测试运行一个分支、每位开发者一个分支、PII 感知分支、临时分支生命周期管理。还可用 neon.ts 声明式配置分支的 parent、ttl、protected 与计算设置。

限制:仅结构分支为 Beta,异常时可通过 Neon Console 反馈或 Discord 求助;它是独立根分支,不适用从父分支重置;根分支配额与存储上限会限制创建数量。创建后如需更新 .env 的 DATABASE_URL,须先征得确认,不得擅自覆盖已有键。