Skip to main content

ChartDB – Xem sơ đồ database nhanh và chạy bằng Docker

ChartDB là gì​

ChartDB là một công cụ mã nguồn mở giúp bạn trực quan hóa schema database và tạo sơ đồ dễ hiểu chỉ trong vài giây. Bạn có thể:

  • Nhập schema từ nhiều hệ quản trị CSDL (PostgreSQL, MySQL, SQLite, SQL Server, MariaDB, ClickHouse, CockroachDB).
  • Tạo sơ đồ rõ ràng để thảo luận, review thiết kế và viết tài liệu.
  • Xuất sơ đồ ra nhiều định dạng để chia sẻ với team.

Nói ngắn gọn: từ database → sơ đồ → export chỉ trong vài bước.

Chạy ChartDB với Docker (nhanh)​

Yêu cầu:

  • Đã cài Docker trên máy.
  • Có OpenAI API key hoặc một endpoint inference tương thích OpenAI (nếu muốn dùng tính năng AI).

Cách 1: Dùng image có sẵn​

Nếu bạn chỉ cần tính năng AI dựa trên OpenAI, có thể chạy nhanh bằng:

docker run \
  -e OPENAI_API_KEY=<YOUR_OPEN_AI_KEY> \
  -p 8080:80 \
  ghcr.io/chartdb/chartdb:latest

Sau khi container chạy, mở trình duyệt tại:

http://localhost:808090

Cách 2: Tự build image ChartDB​

Clone repo ChartDB và build image:

git clone https://github.com/chartdb/chartdb.git
cd chartdb
docker build -t chartdb .

Chạy container:

docker run \
  -e OPENAI_API_KEY=<YOUR_OPEN_AI_KEY> \
  -p 8080:80 \
  chartdb

Nếu bạn dùng server inference riêng thay vì OpenAI, có thể build với endpoint tùy chỉnh:

docker build \
  --build-arg VITE_OPENAI_API_ENDPOINT=<YOUR_ENDPOINT> \
  --build-arg VITE_LLM_MODEL_NAME=<YOUR_MODEL_NAME> \
  -t chartdb .

Và chạy:

docker run \
  -e OPENAI_API_ENDPOINT=<YOUR_ENDPOINT> \
  -e LLM_MODEL_NAME=<YOUR_MODEL_NAME> \
  -p 8080:80 \
  chartdb

Tùy chọn: nếu muốn tắt analytics, thêm:

-e DISABLE_ANALYTICS=true

Luồng sử dụng cực ngắn​

Sau khi ChartDB chạy ở http://localhost:8080:

  • Chọn loại database bạn đang dùng.
  • Lấy “magic query”/“Smart Query” do ChartDB gợi ý.
  • Chạy query đó trong database để lấy JSON schema.
  • Dán JSON vào ChartDB để tạo sơ đồ.

Từ đây bạn có thể chỉnh sửa sơ đồ, đổi layout, màu sắc và export để dùng trong tài liệu hoặc review thiết kế database với team.