01 ClickHouse Cloud
Ghi chú giảng viên cho module 01 — thời lượng, nội dung dẫn giảng, lỗi thường gặp và các bước khôi phục.
macOS terminal: Run workshop commands in Terminal using zsh or bash.
Tài liệu đồng hành của người điều phối cho bài học 01 ClickHouse Cloud.
Thời lượng
Khoảng 15 phút. Bước nạp dữ liệu mồi từ object storage thuộc dạng khởi chạy rồi chờ; hãy bắt đầu nó và tiếp tục nói trong lúc dữ liệu được nạp.
Nội dung dẫn giảng
- Đây là khoảnh khắc "wow" đầu tiên và cũng là lần đầu các dashboard có dữ liệu để hiển thị: dashboard Historical, dựa trên bảng ClickHouse ~3 triệu dòng vừa được nạp mồi, trả về các phép tổng hợp trên khoảng thời gian rộng trong chưa tới một giây.
- Giải thích vì sao ClickHouse nhanh với dạng truy vấn này (dạng cột, các lần quét
khớp với
ORDER BY) ở mức độ phù hợp với trình độ phòng học. - TODO: mở rộng thêm.
Lỗi thường gặp
- Người tham dự không copy mật khẩu service (chỉ hiện một lần); họ phải reset mật khẩu trong console.
CLICKHOUSE_HOSTsai (họ dán cả URL đầy đủ kèm scheme/port thay vì chỉ hostname trần).CLICKHOUSE_PORT=8443vàCLICKHOUSE_SECURE=truelà các giá trị riêng biệt.- Nạp dữ liệu mồi thất bại do không truy cập được object storage; hãy xác nhận URL công khai của TLC.
- Tham chiếu từ buổi tổng duyệt: schema + dữ liệu mồi một tháng được áp trong khoảng 12 giây và tạo ra 265 zone / ~3,17 triệu chuyến. Trước khi dữ liệu mồi được nạp, ứng dụng hiển thị trống, không phải lỗi (trạng thái chưa nạp mồi đã được xử lý), nên một dashboard trống ở bước này là điều dự kiến, không phải lỗi. Đã xác nhận trong buổi tổng duyệt phòng sạch 2026-07.
Các bước khôi phục
- Cấp lại mật khẩu service từ console và điền lại
.env.workshop, rồi khởi động lại:docker compose --env-file .env.workshop -f docker-compose.workshop.yml up -d. - Copy lại toàn bộ lệnh tạo schema từ Module 01 của học viên, Bước 2; lệnh này idempotent.