成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

Neon 数据库分支(Branching)简报

按 copy-on-write 克隆、根分支 main、开发/测试/临时 TTL 与 schema-only,整理数据分支简报;不代删生产分支、不代持连接串。

场景说明

面向独立开发者:把「像切代码分支一样切生产数据副本」写成可对账步骤,区别于 PlanetScale 连接串与 Cloudflare D1 托管 SQLite。

案例叙事

01他们做了什么

要在预览环境或 CI 里测迁移,却不敢动生产库,或每次手工灌库耗掉半天——Neon 分支正是为此设计的工作流。

Neon Docs《Branching》(Last updated / dateModified 可核)说明:可像分支代码一样快速分支数据,用于开发、测试与 CI/CD;也可把数据回拨到历史点以恢复误操作或分析过去状态。分支是数据的 copy-on-write 克隆,可从当前或过去状态创建;支持 schema-only 分支以处理敏感数据。分支与来源隔离,可随意改/删;父子可共享创建点前数据,写入存为 delta。创建分支不会增加父分支负载或影响其性能。每个项目有根分支 main;首个分支从根分出,后续可从根或已有分支再分。工作流包括:开发(默认带父分支截至创建时的全部数据,可用 CLI/API/GitHub Actions,或 Neon 托管的 Vercel 集成按预览部署建分支)、测试(并行分支各有专用计算,测 schema/查询/破坏性操作)、临时环境(设过期日 TTL 自动删)。还可用于数据恢复:在历史窗口内回到过去时间点。本场景据此输出数据库分支简报。禁止声称「生产分支已切好」或回显数据库密码。

02实际效果

  • 源未披露量化「预览环境搭建耗时下降」;公开文只描述 CoW、隔离、工作流与恢复能力。
  • 能把「误改生产 / 与 PlanetScale 连接串或 D1 混淆」拆开。
  • 为开发/CI 数据副本提供可落地的提问清单。

03值得知道

  • 历史窗口、分支数量与存储计量以计划与专页为准;旧分支会锁住数据增加存储。
  • Console 创建对话框的「当前/过去/schema-only/脱敏」选项细节见 Manage branches 专页。
  • 上面写的是产品机制,不是你项目下现有分支列表或连接串。

04可复制提示词

Neon Branching 工作流简报

你是 Neon Branching 助手。只给数据分支核对简报,不要编造已创建成功。

用途:{{purpose}}
是否含敏感生产数据:{{sensitive}}
是否需要 TTL/预览联动:{{ttl_or_preview}}
现有根分支认知:{{root_branch}}

输出 Markdown:
1. CoW/隔离/对父分支影响
2. 开发 vs 测试 vs 临时 TTL 选型提问
3. schema-only 是否更合适
4. Console/CLI/API 验收步骤
禁止索要或回显连接串密码;禁止代删生产根分支。

误操作恢复/分支堆积提纲

误删数据或分支越积越多导致存储上涨,请写处理提纲。

症状:{{symptom}}
历史窗口认知:{{history_window}}
可删分支候选(名称即可):{{branch_names}}

输出:
1. 是否可用过去时间点分支做恢复
2. 哪些临时分支应设过期或删除
3. 是否误把实验写回了默认分支
4. 人工验证顺序
不要伪造「数据已恢复」;不要索要密码。

05一手来源

Neon Documentation · Branching ↗

文档更新

怎么做

  1. 粘贴是否已有 Neon 项目、用途(本地开发/并行测试/预览环境)、是否含敏感数据需 schema-only,以及是否要自动过期
  2. Agent 按官方 Branching 要点输出:CoW 隔离→根分支→开发/测试/临时 TTL→CLI/API/Actions/Vercel 提问清单
  3. 人工在 Console/CLI/API 创建或清理分支;Agent 不代删生产根分支、不回显连接串密码

实用提示

  • 创建分支不增加父分支负载;写入以 delta 保存,父子在创建点后独立演进
  • 与 planetscale-connection-strings-brief / cloudflare-d1-sqlite-workers-brief 不同:本条是 Neon Postgres 数据分支工作流,不是 Vitess 连接串,也不是 Workers SQLite 绑定
#Neon#Branching#Postgres#CI/CD#独立开发者