ChartDB 1.20.1 介绍与选型指南

ChartDB 1.20.1 介绍与选型指南：开源 Web 数据库图表编辑器，Smart Query 一键导入 schema、AI 导出 DDL、AGPL-3.0 许可，附 DBeaver/DbGate/dbdiagram 量化对比与选型建议

ChartDBChartDBER 图SQL数据库2026/10/18

ChartDB 1.20.1 介绍与选型指南

一、信息基准

  • 查询日期：2026-10-18
  • 版本依据：官方最新版 v1.20.1，GitHub Releases feed 显示发布于 2026-04-07，且仓库 package.json 的 version 字段同为 1.20.1，双源一致。
信息项内容官方来源
最新版本v1.20.1（2026-04-07）github.com/chartdb/chartdb/releases.atom；main 分支 package.json
前序版本v1.20.0（2026-03-04）、v1.19.0（2025-12-09）同上 releases.atom
开源许可AGPL-3.0（仓库 LICENSE 文件正文确认）github.com/chartdb/chartdb/blob/main/LICENSE
GitHub stars约 23k（shields.io 徽章，2026-10-18 查询）shields.io/github/chartdb/chartdb
项目阶段官方 README 明示 "currently in Public Beta"github.com/chartdb/chartdb（README）
运行形态Web 应用（云端版 app.chartdb.io 或自托管）chartdb.io；README

二、软件概述

本文介绍的版本为 ChartDB v1.20.1（2026-10-18 查询时的官方最新版）。

ChartDB 是一个开源的 Web 端数据库图表（ER 图）编辑器，官方 README 的自我定位是 "a powerful, web-based database diagramming editor"。它的核心卖点有三个：其一，通过单条"Smart Query"即可把目标数据库的 schema 取回为 JSON 并即时渲染成可视化图表；其二，全部功能无需注册账号、也无需提供数据库口令（官方原话 "No installations • No Database password required"，只需在库上跑一条只读查询并粘贴结果）；其三，内置 AI 驱动的导出能力，可按目标方言生成 DDL 脚本，辅助跨库迁移（如 MySQL 迁往 PostgreSQL、SQLite 迁往 MariaDB）。项目采用 AGPL-3.0 许可，发布于 GitHub，stars 约 23k（2026-10-18 查询）。

三、核心概念

3.1 Smart Query（智能查询）

每种受支持的数据库都对应一段官方预置的查询语句，执行后返回描述表、列、索引、关系的 JSON。用户把 JSON 粘贴进 Web 界面，图表即生成。这一设计让工具与数据库之间只需要一次只读查询，不需要持久连接，也不需要保存口令。

3.2 图表编辑器

生成的图表以"表卡片 + 关系连线"呈现，支持拖拽布局、编辑列与索引、添加备注与自定义关系，用于数据库文档化与设计评审。

3.3 DBML 与导入导出

图表数据以 DBML（Database Markup Language）为核心表示之一，可在图表与 DBML/SQL 脚本之间双向转换；官方在 1.20.1 中还修复了 DBML 注释转义与混合方言导出等问题（releases 说明）。

3.4 AI 导出

在配置 OpenAI 兼容 API Key（或自定义推理端点 VITE_OPENAI_API_ENDPOINT 与模型名 VITE_LLM_MODEL_NAME）后，可将当前图表导出为目标数据库方言的 DDL 脚本，用于跨库迁移评估。

四、功能特性

4.1 即时 Schema 导入

一条查询取回 schema JSON，秒级生成 ER 图，覆盖表结构、列类型、索引与外键关系。

4.2 可视化编辑与注释

交互式编辑器支持调整布局、改列改索引、加标注，适合做架构评审与文档插图。

4.3 DDL 脚本导出与迁移辅助

图表可导出为 SQL 脚本；借助 AI 导出还能切换目标方言，生成建库脚本。

4.4 广泛的数据库支持

官方 README 列出的受支持数据库：PostgreSQL（含 Supabase、TimescaleDB）、MySQL、SQL Server、MariaDB、SQLite（含 Cloudflare D1）、CockroachDB、ClickHouse。

4.5 云端版与自托管

云端版开箱即用（app.chartdb.io）；本地开发按 README 执行 npm install / npm run dev 即可启动，官方同时发布 ghcr.io/chartdb/chartdb 服务端包供自托管部署。

4.6 模板与社区

官方站点提供示例模板（chartdb.io/templates），社区通过 Discord 与 GitHub 讨论。

五、快速上手

以下流程引自官方 README（github.com/chartdb/chartdb）：

  1. 使用云端版（最快路径）：访问 https://app.chartdb.io ，选择数据库类型（如 PostgreSQL）。
  2. 在你的数据库上执行 Smart Query：界面会给出与所选数据库匹配的一条查询语句，执行后得到 schema JSON。
  3. 粘贴 JSON 生成图表：把 JSON 粘贴回页面，ER 图即渲染完成，可编辑、加注释。
  4. 导出：将图表导出为 SQL/DBML，或配置 AI 后导出目标方言的 DDL。

本地开发运行（README 原文命令）：

npm install
npm run dev

构建带 AI 导出能力的版本（README 原文）：

npm install
VITE_OPENAI_API_KEY=<YOUR_OPEN_AI_KEY> npm run build

以上均为官方文档所述流程，本文不做本地实测。

六、适用场景与限制

6.1 适用场景

  • 数据库文档化：为现存库快速生成 ER 图与架构图，纳入团队文档。
  • 设计评审与沟通：表结构评审、教学讲解、面试题图示等轻量场景。
  • 跨库迁移评估：借助 AI 导出生成目标方言 DDL，评估 MySQL→PostgreSQL 等迁移工作量。
  • 无侵入摸底：无法暴露口令或安装客户端的环境，用一条只读查询即可取回结构。

6.2 限制

  • 仍处 Public Beta：官方明示项目处于公测阶段，功能与格式可能变化，升级依赖时留意 Release Notes（如 1.20.1 修复 DBML 转义类缺陷）。
  • AGPL-3.0 传染性：若对源码修改后以网络服务形式对外提供，需按 AGPL 开放修改后的源码，商用集成前需评估合规。
  • 仅面向 SQL 类结构化数据：不支持文档型/键值型等非关系数据库的建模展示。
  • AI 依赖外部服务：AI 导出需自备 OpenAI 兼容 Key 或自建推理端点，未配置时该能力不可用。

七、同类选型对比

对比对象：DBeaver（全功能数据库客户端，含 ER 图）、DbGate（Web/桌面数据库客户端）、dbdiagram.io（在线 ER 图 SaaS，DBML 官方发源服务，闭源商业产品，官方未公布 stars）。数据查询日期均为 2026-10-18，stars 取自 shields.io 徽章，最近发版取自 GitHub Releases feed。

维度ChartDB 1.20.1DBeaver 26.2.2DbGate v7.3.3-beta.13dbdiagram.io
开源许可AGPL-3.0Apache-2.0（仓库标注）GPL-3.0（仓库标注）闭源商业
GitHub stars / 最近发版约 23k / v1.20.1（2026-04-07）约 52k / 26.2.2（2026-10-04）约 7.3k / v7.3.3-beta.13（2026-10-15）官方未公布
版本节奏数月一版（1.19.0 于 2025-12，1.20.0 于 2026-03，1.20.1 于 2026-04）月度节奏，版本号按年月演进beta 通道高频发版托管服务持续更新
兼容矩阵7 类 SQL 数据库，Web 优先，免账号免口令数十种数据库，桌面客户端为主，重运维功能多种 SQL/NoSQL，Web + 桌面仅 DBML 在线绘制，导入 schema 需连接或手写
典型角色快速出 ER 图 + 迁移脚本日常数据库开发运维全家桶轻量多库客户端产品经理/架构师在线画图

选型建议：想最快把现有数据库画成 ER 图并保留自托管能力，选 ChartDB；要一个能做日常开发、数据编辑、元数据管理的全功能客户端，选 DBeaver；需要跨 SQL/NoSQL 的轻量客户端可看 DbGate；团队只求在线协作绘制且接受 SaaS，可用 dbdiagram.io。

八、参考链接

  1. 官方网站：https://chartdb.io/
  2. GitHub 仓库：https://github.com/chartdb/chartdb
  3. Releases feed（版本与日期）：https://github.com/chartdb/chartdb/releases.atom
  4. 许可证全文：https://github.com/chartdb/chartdb/blob/main/LICENSE
  5. 云端版入口：https://app.chartdb.io/
  6. 示例模板：https://chartdb.io/templates
  7. stars 数据徽章：https://img.shields.io/github/stars/chartdb/chartdb.svg