01 ClickHouse Cloud
模块 01 的讲师笔记，时间安排、讲解要点、常见故障与重置步骤。
macOS terminal: Run workshop commands in Terminal using zsh or bash.
学员课程 01 ClickHouse Cloud 的讲师配套材料。
时间安排
约 15 分钟。从对象存储导入种子数据这一步属于"启动后等待"；启动它，然后在加载期间继续讲。
讲解要点
- 这是第一个"惊叹时刻"，也是仪表板第一次真正显示出数据：Historical 仪表板背后是刚刚导入的 约 3M 行的 ClickHouse 表，大范围聚合查询能在远低于一秒的时间内返回。
- 按会场的水平，解释为什么 ClickHouse 在这种查询形态上很快（列式存储、与
ORDER BY对齐的扫描）。 - TODO：扩充。
常见故障
- 参会者没有复制服务密码（只显示一次）；他们必须在控制台里重置密码。
CLICKHOUSE_HOST填错了（他们粘贴了带协议和端口的完整 URL，而不是纯主机名）。CLICKHOUSE_PORT=8443和CLICKHOUSE_SECURE=true是分开的两项。- 种子数据加载因对象存储访问失败；确认公共 TLC URL 可用。
- 预演参考数据：schema 加一个月的种子数据在约 12 秒内完成，产生 265 个 zone / 约 3.17M 条行程。在种子数据导入之前，应用渲染的是空数据，而不是报错（未导入种子数据的 状态已被处理），所以这里出现空仪表板是预期行为，不是故障。已在 2026-07 的净室预演中确认。
重置步骤
- 从控制台重新签发服务密码并重新填写
.env.workshop，然后重启：docker compose --env-file .env.workshop -f docker-compose.workshop.yml up -d。 - 从 学员模块 01 步骤 2 重新复制完整的 schema 命令；它是幂等的。