Xem trước dữ liệu từ snapshot cũ

Bản xem trước hiển thị các dòng của bảng như lúc có snapshot cũ, không thay đổi bảng. Dùng bản xem trước để xem dữ liệu ngay trước một lần ghi sai, hoặc để chứng minh dữ liệu của một ngày cụ thể.

Điều kiện cần

• Role của bạn có quyền time_machine:read. Các role portal_admin, data_engineer và data_analyst có quyền này.
• Bạn đọc được bảng trong Data Security.
• Bảng có ít nhất 1 snapshot. Xem Xem dòng thời gian snapshot của bảng.

Xem trước dữ liệu

1. Mở tab Time Machine của bảng.
2. Chọn thời điểm theo một trong hai cách:
   • Chọn một snapshot từ dòng thời gian.
   • Nhập ngày và giờ. Time Machine dùng snapshot cuối cùng được ghi vào hoặc trước thời điểm đó.
3. Tùy chọn: nhập câu lệnh SELECT để chọn cột hoặc lọc dòng. Xem Viết SELECT tùy chỉnh.
4. Chọn Preview.

Nếu không có SELECT, bản xem trước hiển thị mọi cột. Mặc định hiển thị tối đa 1.000 dòng. Nếu bảng có nhiều dòng hơn, bạn sẽ thấy thông báo kết quả đã bị cắt bớt. Đây không phải lỗi. Thêm bộ lọc WHERE để xem các dòng bạn cần.

Viết SELECT tùy chỉnh

SELECT tùy chỉnh cho phép bạn chọn cột và lọc dòng của snapshot cũ. Câu lệnh luôn đọc từ một nguồn duy nhất tên target_table, đại diện cho bảng tại snapshot bạn đã chọn.

SELECT order_id, customer_id, amount
FROM target_table
WHERE order_date = DATE '2026-09-30'

Được dùng	Không được dùng
Một câu lệnh SELECT	Nhiều hơn một câu lệnh
FROM target_table	Bảng khác, JOIN, UNION
Danh sách cột, hoặc *	Subquery, WITH (CTE)
Bộ lọc WHERE	GROUP BY, COUNT, SUM và các hàm tổng hợp khác
	Window function, ORDER BY, LIMIT, OFFSET
	Hàm cho giá trị mới ở mỗi lần chạy, như rand(), uuid(), current_timestamp
	INSERT, UPDATE, DELETE hoặc bất kỳ thao tác ghi nào

Các quy tắc này đảm bảo cùng một SELECT luôn cho cùng một kết quả, nên bạn có thể dùng lại để so sánh dữ liệu. Để chạy SQL khác, dùng Query Editor.

Nếu câu lệnh vi phạm quy tắc, lỗi hiện bên cạnh ô SELECT. Sửa câu lệnh và chọn Preview lại.

Khi gặp sự cố

Tình huống	Ý nghĩa	Cách xử lý
Truy vấn không được phép	SELECT vi phạm một trong các quy tắc ở trên.	Viết lại, chỉ dùng các phần được phép.
Không tìm thấy snapshot	Ngày giờ sớm hơn snapshot đầu tiên của bảng, hoặc snapshot ID không tồn tại.	Chọn thời điểm muộn hơn, hoặc chọn snapshot từ dòng thời gian.
Truy cập bị từ chối	Role hoặc quyền truy cập dữ liệu của bạn không cho phép.	Liên hệ Admin để được cấp time_machine:read hoặc quyền truy cập bảng.
Yêu cầu hết thời gian chờ	Bản xem trước chạy quá giới hạn thời gian, mặc định 5 phút.	Thêm bộ lọc WHERE hoặc chọn ít cột hơn.

Bước tiếp theo

• So sánh cấu trúc của hai snapshot.
• So sánh dữ liệu của hai snapshot.