瞬间克隆 PostgreSQL 数据库，无需黑魔法
内容提要
Pigsty v1.5 推出 pig 命令行工具，新增数据库瞬间克隆功能：执行 pig pg clone 即可秒级克隆数据库，基于 XFS 等 CoW 文件系统，几乎不占额外空间，仅写脏块才占用。还支持实例级 fork 与 PITR 恢复。命令支持 JSON/YAML 输出，便于 AI Agent 使用，被称为 Agent Native CLI。
延伸解读
为什么克隆能“瞬间”完成
文章指出，瞬间克隆依赖文件系统 CoW 机制（如 XFS）和 PostgreSQL 18 的 file_copy_method = clone 参数。克隆时并不真正复制数据文件，因此耗时基本恒定，通常几百毫秒，且初始不占额外空间；只有后续写入脏块时，才会逐渐占用新空间。这意味着克隆大库的成本极低，但前提是底层文件系统支持 CoW，否则命令会警告并退化为普通克隆。
对 DBA 与 AI Agent 的实用价值
pig pg clone 把原本需要定义模板库再创建的 IaC 流程简化为一条命令，并支持 --plan 预览计划、-o json/yaml 输出结构化结果。文章强调这是为 DBA 和 DBA Agent 设计的 Agent Native CLI，便于 AI Agent 以探索方式获取帮助信息。对读者而言，这意味着数据库克隆可以更自然地嵌入自动化运维和 Agent 工作流，降低人工操作与误判风险。
实例级 fork 与 PITR 的配合场景
除数据库克隆外，pig pg fork 可从当前实例快速创建新实例并随机分配端口。文章提到该功能在误删处理时很实用：先临时分支一个实例（不占额外存储），用增量 PITR 回滚验证，确认无误后再在主实例执行。同时，pig 也把 PITR 操作封装成一条龙命令，降低了时间点恢复的门槛。这为高风险恢复操作提供了一种先验证后执行的思路。
Q&A
pig pg clone 命令怎么用？能实现什么效果？
pig pg clone 是 Pigsty v1.5 新增的命令，用于瞬间克隆 PostgreSQL 数据库。例如执行 pig pg clone meta 即可自动生成一个克隆。它支持指定分支名，不指定则按下划线加数字自动命名。命令会自动检测是否支持瞬间克隆（需 Pigsty + XFS 等 CoW 文件系统），满足则执行瞬间克隆，否则警告并等待确认后执行普通克隆，加 -y 可跳过确认。
瞬间克隆数据库为什么能秒级完成且几乎不占额外空间？
因为瞬间克隆基于 XFS 等支持 CoW（写时复制）的文件系统。克隆一个数据库基本是常数时间耗时，通常几百毫秒，且占用空间不会变大；只有后续真实写脏的数据块，才会真正开始占用新的空间。
pig pg fork 是什么？在误删处理中怎么用？
pig pg fork 是实例级瞬间克隆功能，执行 pig pg fork dev 就能从当前实例创建一个名为 dev 的实例，并随机分配新端口号。在误删处理时，可以先临时分支一个实例（不占用额外存储），然后快速用增量 PITR 回滚验证；验证无误后，再在主实例上执行。
pig 命令行工具为什么被称为 Agent Native CLI？
因为 pig 是专门给 DBA 和 DBA Agent 设计的。它支持 --plan 打印计划，告知会做什么、有什么风险；支持 -o json 和 -o yaml 输出 JSON/YAML 格式结果；命令本体和 Help 输出也可使用 text、JSON、YAML 格式，方便 Agent 以探索式方式获取结构化帮助信息。pig 里所有命令都有这个功能。
使用 pig 做 PITR 恢复方便吗？
非常方便。现在使用 pig 做 PITR 可以一条龙傻瓜式执行时间点恢复到特定时间点，把时间点恢复的门槛压到了地板。当然，也可以使用 pig pgbackrest 精准控制每一个操作。
Pigsty v1.5 的 pig 命令行工具新增了哪些管理功能？
pig 命令行工具新增了很多管理功能，包括对 PostgreSQL、Patroni、pgBackRest 组件的各种管理。这些功能都封装成类似 pg clone 与 pg fork 的 Agent Native CLI，同时方便人类 DBA 与 AI Agent 使用。
