Thử làm công cụ tự động tạo tài liệu định nghĩa bảng và sơ đồ ER để AI trả lời về cấu trúc bảng

Chuyện gì đã xảy ra

Tác giả làm công cụ dbxray. Công cụ kết nối với cơ sở dữ liệu và xuất ra tài liệu dạng Markdown. Tài liệu gồm danh sách bảng, định nghĩa từng bảng và sơ đồ ER. Sơ đồ ER là hình vẽ thể hiện các bảng liên kết với nhau. Công cụ cũng có máy chủ MCP, nên AI như Claude Code có thể đọc dữ liệu này và trả lời câu hỏi về bảng.

Số liệu và thông tin chính

• Phiên bản được mô tả trong bài là v0.4.2.
• Hỗ trợ PostgreSQL (khuyến nghị từ bản 13) và Oracle (khuyến nghị từ bản 12c).
• Cần Java 21. File zip đã có sẵn Java nên người dùng không cần cài thêm.
• Mật khẩu được đưa vào qua biến môi trường DBXRAY_DB_PASSWORD, không lưu trong file cấu hình.

Vì sao tác giả làm công cụ này

Trong công việc, tác giả cần hiểu cấu trúc bảng của một hệ thống con mà mình không rành. Hệ thống lớn thường không có tài liệu đầy đủ. Vì vậy tác giả nâng cấp một công cụ xuất tài liệu cũ, và thêm phần để AI cũng đọc được cấu trúc bảng.

Vì sao điều này quan trọng

Với hệ thống lớn không có tài liệu, người mới rất khó hiểu dữ liệu. Công cụ này giúp tạo tài liệu tự động và cho AI đọc cấu trúc bảng. Nhờ vậy, khi viết code bằng AI, AI hiểu bảng đang nói về cái gì. Ví dụ, AI có thể tìm bảng liên quan đến nhân viên, hay cho biết sửa một bảng sẽ ảnh hưởng đến đâu.

Điều cần theo dõi

• Các phiên bản mới của dbxray và các tính năng được bổ sung.
• Mức độ chính xác của câu trả lời AI khi đọc tài liệu bảng.
• Việc công cụ hoạt động tốt với các hệ thống lớn và nhiều schema hay không.