01 ClickHouse Cloud

学習者向けレッスン 01 ClickHouse Cloud に対応するファシリテーター用の手引きです。

タイミング

約15分。オブジェクトストレージからのシード投入は待ち時間の発生する手順です。開始したら、 ロード中も話し続けてください。

トークトラック

• ここが最初の「おおっ」で、ダッシュボードにデータが表示される最初の瞬間でもある。シード投入したばかりの 約300万行の ClickHouse テーブルを裏に持つ Historical ダッシュボードが、広い範囲の集計を 1秒を大きく下回る時間で返す。
• この形のクエリで ClickHouse が速い理由（カラムナ、ORDER BY に沿ったスキャン）を、 会場のレベルに合わせて説明する。
• TODO: 拡充する。

よくある失敗

• 参加者がサービスのパスワード（1度だけ表示される）をコピーしていない。コンソールでリセットする必要がある。
• CLICKHOUSE_HOST が誤っている（ホスト名のみではなく、スキームやポートを含む完全な URL を貼っている）。 CLICKHOUSE_PORT=8443 と CLICKHOUSE_SECURE=true は別々の設定。
• オブジェクトストレージへのアクセスでシードのロードが失敗する。公開されている TLC の URL を確認する。
• ドライランの参考値: スキーマと1か月分のシードが約12秒で適用され、265 ゾーン / 約317万件の乗車データが 生成された。シードを実行する前は、アプリは エラーではなく空 として描画される（シード未投入の状態は ハンドリングされている）。したがって、ここでダッシュボードが空なのは想定どおりで、障害ではない。2026-07 のクリーンルームでのドライランで確認済み。

リセット手順

• コンソールからサービスのパスワードを再発行して .env.workshop を埋め直し、再起動する: docker compose --env-file .env.workshop -f docker-compose.workshop.yml up -d。
• 学習者向けモジュール 01、ステップ 2 から 完全なスキーマコマンドを再度コピーする。冪等なコマンドである。