quickdbd-cli：从文本与 dbt

14次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 quickdbd-cli

30秒速读

dbt 项目的表越建越多，新人面对几十个模型两眼一抹黑；PR 里改了模型结构，评审人只能靠肉眼猜影响面。本篇介绍 quickdbd-cli：把 QuickDBD 兼容文本或 dbt 的 manifest.json 转成可交互 ER 图的命令行工具。quickdbd-cli 自带搜索、筛选、折叠与分支差异审查，还能导出自包含 HTML、PNG、SVG 与 draw.io 文件，适合把”模型即代码”的团队直接管进仓库。

软件信息一览

项目名称	quickdbd-cli
软件类型	数据库 ER 图生成命令行工具
开发语言	JavaScript
运行平台	跨平台（Node.js 命令行；另有 VS Code 扩展、GitHub Action）
输入格式	QuickDBD 兼容文本 · dbt manifest.json
输出格式	自包含 HTML · PNG · SVG · draw.io · 分享链接
特别声明	与 QuickDBD 无隶属关系
项目地址	见文末”开源地址”

三种使用方式怎么选：结论先行

结论先行：画一次图用 CLI，天天改模型装 VS Code 扩展，团队协作把 GitHub Action 接进 PR 流程。三者不是互斥的，是同一套能力在不同环节的形态。

使用方式	适合谁	关键能力	推荐度
命令行工具	偶尔出图、写文档	文本校验、自动布局、多格式导出	先跑通
VS Code 扩展	天天写 dbt 模型的工程师	语法高亮、即时报错、文件大纲、跨文件 F12、编辑器旁图表	高频必装
GitHub Action	团队 Code Review	分支差异报告，以 PR 评论形式发布	协作刚需

明确推荐：个人先用 CLI 跑通”文本到 HTML”的最小闭环；如果每周都要改模型，VS Code 扩展的即时报错能省下大量返工；三人以上的 dbt 团队建议直接上 GitHub Action，让每次 PR 的模型变更自动生成差异评论，评审效率提升最明显。

安装与上手的三个关键卡点

先定输入格式，二选一。QuickDBD 兼容文本和 dbt 的 manifest.json 走不同的解析路径；手里是 dbt 项目就直接用 manifest.json，别再手写一份文本做二次维护。
大模型图先想好浏览策略。表一多默认全展开会看花眼，自动布局之后用搜索、筛选、折叠视图与缩略图导航定位，先圈定范围再细看关系。
PR 差异报告要在仓库里配好 Action。差异审查不是本地功能，需要在仓库中配置 GitHub Action，分支差异才会以 PR 评论形式自动发布；配之前先确认仓库有添加 Action 的权限。

上手必看的 3 个关键设置

VS Code 扩展一次配齐（入口：VS Code 插件市场搜索安装）。体感差别：语法高亮加即时报错让你在写模型时就发现外键写错，文件大纲与跨文件 F12 让几十个模型文件的跳转像在 IDE 里看代码，编辑器旁的实时图表更是”写一行看一行”。
dbt 选择器圈定范围（入口：配合 dbt 选择器语法使用）。体感差别：大项目只渲染你关心的模型子集，图从”一团乱麻”变成”一张能看的图”，这是大 schema 下的必备操作。
导出格式按受众选（入口：导出命令的格式参数）。体感差别：自包含 HTML 发给不懂技术的产品经理直接双击能看；draw.io 格式适合架构师继续编辑；分享链接适合贴到文档里长期引用。

注意事项与常见问题

不需要注册 QuickDBD 账号。解析在本地完成，不依赖 QuickDBD 官网服务；项目也已明确声明与 QuickDBD 无隶属关系，法务层面干净。
直连数据库反向生成是否支持，以 README 为准。源稿把”直接连接数据库反向生成模式”列为待确认项，动手前先看项目文档，别按”应该有”去规划流程。
图太大看不清是浏览方式问题。先用搜索定位表，再用筛选与折叠收起无关分支，缩略图负责全局导航——这四个能力就是为大规模 schema 准备的。
校验报错先看解析器提示。工具提供与 QuickDBD 语法及错误信息相近的解析体验，报错信息通常直接指出哪一行哪一列，先读报错再改文本。

适合谁：与同类工具的边界

适合：把 dbt 模型当代码管的团队、维护大型 dbt 项目的数据工程师、需要在 PR 里评审模型变更的人。不适合：只想快速看一眼某张表的结构——DBeaver、Navicat 这类数据库客户端自带的 ER 视图更快；要做全库血缘、字段级追踪的深度治理，则该看专业的数据血缘与 catalog 工具，quickdbd-cli 的地盘是”模型文本到可交互 ER 图”这一段。