Lịch sử Truy vấn
TablePro tự động lưu mọi query bạn thực thi, giúp dễ dàng tìm, chạy lại hoặc chỉnh sửa các query trước đó. Lịch sử query được lưu trữ qua các phiên và có thể tìm kiếm với full-text search.
Truy Cập Lịch Sử
Panel Lịch Sử
Mở panel lịch sử:
- Click View > Query History
- Hoặc sử dụng phím tắt
Cmd+Y
- Hoặc click biểu tượng History trong toolbar
Các query gần đây cũng xuất hiện trong sidebar dưới kết nối đang hoạt động.
Tính Năng Lịch Sử
Danh Sách Query
Panel lịch sử hiển thị:
| Cột | Mô tả |
|---|
| Query | Văn bản SQL (được cắt ngắn nếu dài) |
| Time | Khi query được thực thi |
| Duration | Thời gian thực thi |
| Status | Thành công hoặc lỗi |
| Database | Database/kết nối được sử dụng |
Sắp Xếp
Sắp xếp lịch sử theo:
- Time: Gần nhất trước (mặc định)
- Duration: Query chậm nhất trước
- Query text: Theo thứ tự abc
Click header cột để thay đổi thứ tự sắp xếp.
Lọc
Lọc query theo:
- Connection: Chỉ hiển thị query từ kết nối cụ thể
- Status: Chỉ hiển thị query thành công hoặc thất bại
- Time range: Hôm nay, tuần này, tháng này, tất cả
Tìm Kiếm Lịch Sử
Full-Text Search
Gõ vào ô tìm kiếm để tìm query chứa văn bản cụ thể:
SELECT users -- Tìm tất cả query chứa "SELECT" và "users"
Mẹo Tìm Kiếm
- Tìm kiếm không phân biệt chữ hoa chữ thường
- Khớp một phần được bao gồm
- Tìm kiếm xem xét toàn bộ văn bản query
Ví dụ tìm kiếm:
| Tìm kiếm | Tìm thấy |
|---|
users | Query đề cập đến “users” |
JOIN orders | Query join bảng orders |
WHERE created | Query lọc theo created |
UPDATE users SET | Câu lệnh update trên users |
Sử Dụng Lịch Sử
Chạy Lại Query
Để chạy lại query từ lịch sử:
- Tìm query trong danh sách lịch sử
- Double-click vào query
- Nó được tải vào SQL editor
- Nhấn
Cmd+Enter để thực thi
Hoặc click chuột phải và chọn Run Query.
Sao Chép Query
Để sao chép query:
- Chọn query trong danh sách
- Click chuột phải > Copy Query
- Hoặc nhấn
Cmd+C
Toàn bộ văn bản query được sao chép vào clipboard.
Chỉnh Sửa Trước Khi Chạy
Để sửa đổi query lịch sử:
- Double-click để tải vào editor
- Thực hiện thay đổi
- Thực thi query đã sửa đổi
Entry lịch sử gốc được bảo tồn; một entry mới được tạo cho query đã sửa đổi.
Lưu Trữ Lịch Sử
Lịch Sử Được Lưu Ở Đâu
Lịch sử query được lưu trữ trong:
~/Library/Application Support/TablePro/query_history.db
- Văn bản query
- Timestamp thực thi
- Thời lượng
- Thông tin kết nối/database
- Trạng thái thành công/thất bại
- Thông báo lỗi (nếu thất bại)
Giữ Lại Lịch Sử
Cấu hình giữ lại lịch sử trong Settings > History:
| Thiết lập | Mặc định | Mô tả |
|---|
| Max Entries | 10,000 | Số query tối đa để lưu trữ |
| Max Days | 90 | Xóa query cũ hơn số ngày này |
| Auto Cleanup | Bật | Tự động xóa entry cũ |
Đặt Max Entries thành 0 cho lịch sử không giới hạn (có thể ảnh hưởng hiệu suất với lịch sử rất lớn).
Xóa Lịch Sử
Để xóa tất cả lịch sử:
- Mở Settings > History
- Click Clear All History
- Xác nhận hành động
Xóa lịch sử không thể hoàn tác. Cân nhắc export các query quan trọng trước.
- Click chuột phải vào kết nối trong sidebar
- Chọn Clear History
Chi Tiết Query
Xem Query Đầy Đủ
Đối với query dài, click để mở rộng và xem toàn bộ văn bản:
Chi Tiết Thực Thi
Mỗi entry lịch sử bao gồm:
| Chi tiết | Mô tả |
|---|
| Started | Timestamp khi bắt đầu thực thi |
| Duration | Thời gian query mất bao lâu |
| Rows affected | Số hàng trả về/sửa đổi |
| Error | Thông báo lỗi nếu query thất bại |
Query Thất Bại
Query thất bại hiển thị:
- Thông báo lỗi
- Query gây ra lỗi
- Timestamp của lỗi
Điều này giúp debug vấn đề:
- Tìm query thất bại
- Đọc thông báo lỗi
- Tải vào editor
- Sửa và chạy lại
Thực Hành Tốt Nhất
Chú Thích Query
Thêm comment vào các query quan trọng để tìm kiếm dễ dàng hơn:
-- Báo cáo doanh thu tháng 2024
SELECT
DATE_FORMAT(created_at, '%Y-%m') as month,
SUM(total) as revenue
FROM orders
WHERE created_at >= '2024-01-01'
GROUP BY month;
-- [REPORT] Tăng trưởng người dùng
-- [DEBUG] Vấn đề hiệu suất
-- [ADMIN] Dọn dẹp dữ liệu
-- [TEMP] Query thử nghiệm
Export Query Quan Trọng
Đối với query bạn muốn giữ vĩnh viễn:
- Tìm query trong lịch sử
- Sao chép vào file SQL
- Lưu trong version control
Phím Tắt
| Hành động | Phím tắt |
|---|
| Mở lịch sử | Cmd+Y |
| Tìm kiếm lịch sử | Cmd+F (khi lịch sử đang mở) |
| Tải query đã chọn | Enter hoặc double-click |
| Sao chép query | Cmd+C |
Khắc Phục Sự Cố
Lịch Sử Không Lưu
- Kiểm tra dung lượng ổ đĩa - lịch sử cần không gian lưu trữ
- Xác minh TablePro có quyền ghi
- Kiểm tra xem lịch sử có bị tắt trong cài đặt không
Tìm Kiếm Lịch Sử Chậm
Đối với lịch sử rất lớn:
- Giảm Max Entries trong cài đặt
- Xóa lịch sử cũ
- Sử dụng từ khóa tìm kiếm cụ thể hơn
Thiếu Query Cũ
Kiểm tra cài đặt Max Days - query cũ hơn giới hạn này tự động bị xóa.
Để ngăn xóa tự động:
- Mở Settings > History
- Đặt Max Days thành 0 (không giới hạn)
Entry Trùng Lặp
Mỗi lần thực thi tạo một entry lịch sử mới, ngay cả với query giống hệt nhau. Điều này là có chủ ý để theo dõi khi query được chạy.
Các Bước Tiếp Theo
