AI SREClickHouse Workshops

01 ClickHouse Cloud

บันทึกสำหรับผู้สอนของโมดูล 01 — เวลา, แนวการบรรยาย, ปัญหาที่พบบ่อย และขั้นตอนรีเซ็ต

Your computer
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

ในหน้านี้

TH