01 ClickHouse Cloud

학습자 레슨 01 ClickHouse Cloud에 대응하는 진행자용 안내서입니다.

타이밍

약 15분. 오브젝트 스토리지에서 시드 데이터를 넣는 단계는 실행 후 대기입니다. 먼저 시작해두고 로딩되는 동안 계속 설명하세요.

토크 트랙

• 여기가 첫 "와" 순간이자 대시보드에 데이터가 처음으로 나타나는 순간입니다. 갓 시드된 약 300만 행 ClickHouse 테이블을 사용하는 Historical 대시보드가 넓은 범위의 집계를 1초도 안 걸려 반환합니다.
• 이런 형태의 쿼리에서 ClickHouse가 왜 빠른지(컬럼형 저장, ORDER BY에 정렬된 스캔) 강의실 수준에 맞춰 설명하세요.
• TODO: 확장.

흔한 실패 사례

• 참가자가 서비스 비밀번호(한 번만 표시됨)를 복사하지 않은 경우. 콘솔에서 재설정해야 합니다.
• CLICKHOUSE_HOST가 잘못된 경우(호스트명만 넣어야 하는데 스킴/포트가 포함된 전체 URL을 붙여넣음). CLICKHOUSE_PORT=8443과 CLICKHOUSE_SECURE=true는 별도 항목입니다.
• 오브젝트 스토리지 접근 문제로 시드 로딩이 실패. 공개 TLC URL을 확인하세요.
• 리허설 기준값: 스키마 + 한 달치 시드가 약 12초에 적용되어 265개 zone / 약 317만 건의 trip이 생성되었습니다. 시드가 실행되기 전 앱은 오류가 아니라 빈 상태로 렌더링되므로(시드되지 않은 상태를 처리함), 여기서 대시보드가 비어 있는 것은 실패가 아니라 예상된 결과입니다. 2026-07 클린룸 리허설에서 확인됨.

초기화 절차

• 콘솔에서 서비스 비밀번호를 다시 발급하고 .env.workshop을 다시 채운 뒤 재시작하세요: docker compose --env-file .env.workshop -f docker-compose.workshop.yml up -d.
• 학습자 모듈 01, 2단계에서 전체 스키마 명령을 다시 복사하세요. 멱등적입니다.