SuperAPI AI 工具集

peach-db-extract-schema

通用与其它

查看项目

更新于 10-15 21:39

技能介绍

用途:在不执行迁移的前提下,将数据库当前状态重新提取为表级 DDL 文件,并与已有 schema 文件同步。db:up-dev / db:down-dev 执行时已自动链式调用 extract-schema,因此该技能仅在需要手动提取时使用。

工作流:第一步在 api 目录执行 cd api && bun run db:extract-schema;第二步汇总结果,展示 Created、Updated、Unchanged、Deleted 四项数量;第三步若有 Created 或 Updated 文件,列出变更文件并归纳主要变更(如列增删、索引变化)。

输出位置:api/db/schema/{域}/{表名}.sql。域按表名第一个下划线前的部分自动分类,例如 order_item.sql → schema/order/order_item.sql,common_file.sql → schema/common/common_file.sql,member.sql → schema/member/member.sql。

提取内容:CREATE TABLE DDL(列、类型、默认值、NOT NULL)、COMMENT ON TABLE / COLUMN(含韩文注释)、CREATE INDEX(含 Partial Index 的 WHERE 子句)、PRIMARY KEY 约束。

适用场景:其他开发者直接改动数据库后同步 schema 文件;怀疑 schema 文件与实际数据库不一致;只想查看数据库结构而不做迁移;新项目环境首次生成 schema 文件。

限制:资料未提供支持的具体数据库类型、安装方式、权限要求及失败处理说明。