00 セットアップ

学習者向けレッスン 00 セットアップ に対応するファシリテーター向けの手引きです。

所要時間

合計で約 30 分。これは当日のコンテンツではなく事前課題です。セッション前にパートナーへ配布し、 当日の朝ではなく前日までに完了を確認してください。「実行して放置する」意味で無人になる作業は ここには一つもありません。ツールのインストール 5 件、アカウント登録 2 件、クローン 1 回、 virtualenv のビルド 2 件で、どれも終始パートナーがキーボードに手を置いている必要があります。 これを飛ばして現れたパートナーをライブで復旧させると、セッション時間をおよそ 30 分消費し、 その枠でカバーするはずだったモジュール 01 の内容を犠牲にすることになります。

トークトラック

• このモジュールはコンテンツではなく配管作業だと位置づけてください。2 つのクラウド （ソースとしての Snowflake、ターゲットとしての ClickHouse Cloud）、クラウドごとに 1 つずつの dbt アダプター 2 つ、そして両方のアダプターが共有する厳格な Python の下限バージョンです。
• 一度ではなく繰り返し口に出して伝える価値のある事実が 1 つあります。dbt-snowflake と dbt-clickhouse はどちらも Python 3.11、3.12、3.13 のいずれかを必要とします。Python 3.14 以降は、両方のアダプターが共有する推移的依存関係 mashumaro を壊します。
• 2 つの別々の virtualenv — workshop_public/snowflake_migration_lab/01-setup-snowflake/.venv と workshop_public/snowflake_migration_lab/03-migrate-to-clickhouse/.venv — を指し示し、なぜ 1 つにまとめられないのかを説明してください。2 つのアダプターが競合する依存関係の範囲を 固定しているためです。
• 両方のクラウドのサインアップは当日ではなく今のうちに促してください。モジュール 01 が 始まった時点で、Snowflake トライアルも ClickHouse Cloud トライアルもブロッカーになっては いけません。

よくある失敗

• Python 3.14 以降は mashumaro 経由で dbt-snowflake と dbt-clickhouse を壊します。 これはこのモジュールの代表的な失敗であり、最も危険なものです。インタープリターの固定を 誤っても、ここでは失敗しないからです。2 つ先のモジュールで、Python バージョンとは一見 無関係な、分かりにくい dbt の import エラーとして表面化します。パートナーにこのモジュールの 完了を認める前に、システムのデフォルトではなく、各 virtualenv — workshop_public/snowflake_migration_lab/01-setup-snowflake/.venv と workshop_public/snowflake_migration_lab/03-migrate-to-clickhouse/.venv — の実際の インタープリターについて、python3 --version が 3.11、3.12、3.13 のいずれかを報告することを 確認してください。
• TODO: このモジュールについては、ラボ自身の README に他の失敗パターンが記載されていません。 リハーサルで観察したことがあればここに記録してください（企業プロキシやファイアウォールが pip install や terraform init をブロックする、初回起動時の Docker Desktop の ライセンス確認、トライアル登録の承認遅延など）。

リセット手順

• venv の背後にある Python バージョンが誤っている場合: 誤っている側のモジュールの virtualenv — workshop_public/snowflake_migration_lab/01-setup-snowflake/ または workshop_public/snowflake_migration_lab/03-migrate-to-clickhouse/ — に cd し、削除して 固定されたインタープリターで作り直します。例えば rm -rf .venv && python3.13 -m venv .venv && source .venv/bin/activate を実行し、学習者向けページの Step 4 に示された とおりにその venv のアダプターを再インストールします。
• このモジュールに適用できるティアダウンスクリプトはありません。どちらのクラウドにも、まだ 何もプロビジョニングされていません。パートナーが手順をやり直す必要がある場合は、何かを リセットするより単に再実行するほうが安価です。
• TODO: Wi-Fi が不安定な会場では、当日に 5 つのツールと 2 つの venv をライブでインストール する代わりに、事前にビルド済みの venv を配布するのが有効かどうか、リハーサルで確認して ください。