01 ClickHouse Cloud
บันทึกสำหรับผู้สอนของโมดูล 01 — เวลา, แนวการบรรยาย, ปัญหาที่พบบ่อย และขั้นตอนรีเซ็ต
macOS terminal: Run workshop commands in Terminal using zsh or bash.
คู่มือประกอบของผู้ดำเนินเวิร์กช็อปสำหรับบทเรียนผู้เรียน 01 ClickHouse Cloud
เวลา
ประมาณ 15 นาที ขั้นตอน seed จาก object storage เป็นแบบสั่งแล้วรอ เริ่มมันไว้แล้ว บรรยายต่อระหว่างที่มันโหลด
แนวการบรรยาย
- นี่คือจุด "ว้าว" แรกและเป็นครั้งแรกที่ dashboard แสดงข้อมูลจริง ๆ: dashboard Historical ที่ใช้ตาราง ClickHouse ขนาดราว 3 ล้านแถวที่เพิ่ง seed เสร็จ คืนผล การรวมข้อมูลช่วงกว้างได้ในเวลาต่ำกว่าหนึ่งวินาทีอย่างชัดเจน
- อธิบายว่าทำไม ClickHouse เร็วกับ query รูปแบบนี้ (แบบ columnar, การสแกนที่จัดเรียงตาม
ORDER BY) ในระดับความลึกที่เหมาะกับผู้ฟังในห้อง - TODO: ขยายเพิ่ม
ปัญหาที่พบบ่อย
- ผู้เข้าร่วมไม่ได้คัดลอกรหัสผ่านของ service (แสดงเพียงครั้งเดียว) ต้องรีเซ็ตใน console
CLICKHOUSE_HOSTผิด (เขาวาง URL แบบเต็มพร้อม scheme/port แทนที่จะเป็น hostname เปล่า)CLICKHOUSE_PORT=8443และCLICKHOUSE_SECURE=trueเป็นค่าแยกกัน- การ seed ล้มเหลวที่การเข้าถึง object storage ให้ยืนยัน URL สาธารณะของ TLC
- อ้างอิงจากการซ้อม: schema พร้อม seed หนึ่งเดือนถูกใช้งานในเวลาราว 12 วินาที และได้ 265 zone / ราว 3.17 ล้าน trip ก่อนที่ seed จะรัน แอปจะเรนเดอร์แบบ ว่างเปล่า ไม่ใช่ error (สถานะยังไม่ได้ seed ถูกจัดการไว้) ดังนั้น dashboard ว่างในจุดนี้เป็นเรื่องปกติ ไม่ใช่ปัญหา ยืนยันแล้วในการซ้อมแบบ clean-room เดือน 2026-07
ขั้นตอนรีเซ็ต
- ออกรหัสผ่านของ service ใหม่จาก console แล้วกรอก
.env.workshopใหม่ จากนั้น รีสตาร์ต:docker compose --env-file .env.workshop -f docker-compose.workshop.yml up -d - คัดลอกคำสั่ง schema แบบเต็มใหม่จาก โมดูล 01 ของผู้เรียน, ขั้นที่ 2 ซึ่งเป็นแบบ idempotent