Câu hỏi thường gặp (FAQ) — Data Visualization

Sử dụng

Biểu đồ không hiển thị dữ liệu?

Kiểm tra theo thứ tự:

Collection có dữ liệu không? Mở collection trong danh sách để xác nhận
Measures cấu hình đúng chưa? Phải chọn trường số và hàm aggregation
Dimensions cấu hình đúng chưa? Cần ít nhất một dimension cho hầu hết loại biểu đồ
Filter có quá chặt không? Thử bỏ filter để xem dữ liệu
User có quyền đọc collection không? Kiểm tra ACL

Có thể tạo dashboard với nhiều biểu đồ không?

Có. Thêm nhiều Chart block trên cùng một trang. Mỗi block có cấu hình riêng (collection, measures, dimensions). Kết hợp với Filter block để tạo bộ lọc dùng chung cho tất cả biểu đồ.

Làm sao lọc dữ liệu biểu đồ theo ngày?

Thêm dimension với trường ngày (ví dụ createdAt) và chọn Format phù hợp:

YYYY — Theo năm
YYYY-MM — Theo tháng
YYYY-Q — Theo quý
YYYY-Wo — Theo tuần
YYYY-MM-DD — Theo ngày

Biểu đồ hiển thị tối đa bao nhiêu bản ghi?

Mặc định 2000 bản ghi. Giới hạn này áp dụng khi có dimension hoặc không sử dụng aggregation. Khi chỉ có aggregation (không dimension), không có giới hạn vì kết quả chỉ là một dòng.

Sự khác nhau giữa G2Plot và ECharts?

Tiêu chí	G2Plot	ECharts
Độ phức tạp	Đơn giản, dễ dùng	Tùy biến cao
Loại biểu đồ	Cơ bản (bar, line, pie, area)	Phong phú hơn
Hiệu năng	Tốt với dữ liệu vừa	Tốt hơn với dữ liệu lớn
Tùy chỉnh giao diện	Có giới hạn	Rất linh hoạt

Cache

Cache hoạt động như thế nào?

Plugin sử dụng memory cache với:

TTL mặc định: 30 giây
Tối đa 1000 entries
Mỗi biểu đồ có uid riêng — khi cache được bật, request trùng uid sẽ trả kết quả từ cache

Khi nào nên bật cache?

Tình huống	Bật cache?
Biểu đồ tổng quan doanh thu (ít thay đổi)	Có, TTL 60-300s
Dashboard realtime (cần dữ liệu mới nhất)	Không
Biểu đồ query nặng (nhiều aggregation)	Có, TTL 30-60s
Biểu đồ đơn giản (ít dữ liệu)	Không cần thiết

Làm sao xóa cache thủ công?

Nhấn nút Refresh trên biểu đồ. Plugin sẽ gửi request với flag refresh: true, bỏ qua cache và query lại dữ liệu mới.

Lỗi thường gặp

Biểu đồ tải chậm?

Nguyên nhân và cách khắc phục:

Dữ liệu quá lớn: Thêm filter để giới hạn phạm vi dữ liệu
Thiếu index: Tạo index trên database cho các trường thường filter/sort
Aggregation phức tạp: Giảm số lượng measures hoặc dimensions
Nhiều biểu đồ trên một trang: Bật cache cho các biểu đồ không cần real-time

Lỗi "Invalid aggregation function"?

Plugin chỉ hỗ trợ 5 hàm aggregation: sum, count, avg, min, max. Kiểm tra lại cấu hình measures.

Lỗi HTTP 403 khi xem biểu đồ?

User không có quyền đọc collection mà biểu đồ truy vấn. Kiểm tra:

User đã đăng nhập chưa (plugin yêu cầu loggedIn)
Role của user có quyền đọc collection tương ứng không (kiểm tra ACL)

Date format không hoạt động với SQLite?

SQLite có hỗ trợ hạn chế cho date formatting. Plugin sử dụng strftime thay vì TO_CHAR/DATE_FORMAT. Một số format phức tạp có thể không hoạt động. Khuyến nghị sử dụng PostgreSQL hoặc MySQL cho production.

Nâng cao

Plugin cơ bản và Pro khác nhau như thế nào?

Tính năng	Cơ bản (data-visualization)	Pro (data-visualization-pro)
Bar, Line, Pie, Area	Có	Có
Funnel, Radar, Heatmap	Không	Có
SQL Mode	Không	Có
Custom chart types	Không	Có
Tùy chỉnh JSON config	Có giới hạn	Đầy đủ

Có thể truy vấn dữ liệu từ data source bên ngoài không?

Có. Chọn data source tương ứng trong phần cấu hình biểu đồ. Plugin hỗ trợ truy vấn từ bất kỳ data source nào đã được đăng ký trong hệ thống (PostgreSQL, MySQL, REST API, v.v.).