なぜ重要か
従来は、擬似端末のリークによってアプリを再起動するまで新しいterminalコマンドを実行できなくなる場合がありました。このリリースではその問題が修正され、dbtの実行、ログ確認、Lineage操作をCoCo Desktop内で扱いやすくなります。また、ローカルおよびクラウドの自動化を特定の日付で月次実行できるようになります。
対象となるチーム
- dbt開発者・分析エンジニア
- SnowflakeおよびCortex Codeの運用担当者
- データ基盤・データガバナンスチーム
- 自動化ジョブを管理する開発・運用チーム
提供条件
- 提供ステータスはリリースノートに記載なし
- 必要なCoCo Desktopのバージョンはv1.21.1
- エディションの記載はリリースノートに記載なし
- リージョンの記載はリリースノートに記載なし
- Preview段階であるとの記載はリリースノートに記載なし
ユースケース
- dbt開発者がProject Action Barに完全なCLIコマンドを入力し、ローカル実行をRunおよびStopで操作する。
- Snowflake-managed dbt実行でProfile、Environment、--selectを指定し、対象を絞って実行する。
- OUTPUTパネルに保持されたプロジェクト単位のdbt transcriptをコピーして、レビューや障害調査に利用する。
- Lineageタブで選択中のプロジェクトのdbt DAGを確認し、Lineageの選択内容をchatへ送る。
- ローカルおよびcloud automationを毎月1〜31日の指定日で実行する。
仕組みと使い方
dbtプロジェクトを選択すると、Project Action Barからローカル実行用の完全なCLIコマンドを編集してRunまたはStopを実行できます。Snowflake-managed runではProfile、Environment、--selectの各コントロールを設定します。実行結果は下部のOUTPUTパネルにcopy-paste-friendlyなtranscriptとして表示され、プロジェクトごとに保持されます。dbt DAGは下部パネルのLineageタブに移動し、選択中のプロジェクトに追従します。Snowflake-managed dbt runにはdbt.snowflakeManaged.executionTimeout設定があり、既定値は4時間です。
導入ステップ
- CoCo Desktopをv1.21.1へ更新し、対象のdbtプロジェクトを開く。
- Project Action Barでローカル実行またはSnowflake-managed runを選択する。
- 必要に応じてCLIコマンド、Profile、Environment、--selectを設定して実行する。
- OUTPUTパネルでtranscriptを確認し、Lineageタブでdbt DAGと選択内容を確認する。
- 自動化を使う場合は、対象のlocalまたはcloud automationに月次の日付を設定する。
- 長時間実行のSnowflake-managed dbt runでは
dbt.snowflakeManaged.executionTimeoutを確認する。
運用上の注意
- Snowflake-managed commandのラベルはサニタイズされ、環境変数の値がログに書き込まれないようになっています。ログ上で元の値を確認できることを前提にしないでください。
- Snowflake-managed dbt runは
dbt.snowflakeManaged.executionTimeoutの既定値が4時間です。終了しない実行はこの設定による制限を受けます。 - restricted session scopeのダイアログは処理中もキャンセル可能ですが、ロール一覧や読み込み状態を確認してから操作してください。
- 月次スケジュールでは日付を1〜31から指定します。実際のカレンダー上の実行挙動は公式ドキュメントで確認してください。
制約事項
- エディション、リージョン、提供ステータス、必要な権限の詳細はリリースノートに記載なしです。
- dbtの実行方式ごとに利用できる設定が異なり、Profile、Environment、--selectはSnowflake-managed runs向けとして記載されています。
- Lineageタブが追従する対象は選択中のプロジェクトです。複数プロジェクトを同時に表示できるかはリリースノートに記載なしです。
- Preview段階の機能であるとの記載はリリースノートにありません。一般提供状況は公式のCortex Code Desktop v1.21.1リリースノートで確認が必要です。
次に確認すること
- 公式のCortex Code Desktop v1.21.1リリースノートで、提供ステータス、エディション、リージョン、必要権限を確認する。
- テスト用dbtプロジェクトで、ローカル実行、Snowflake-managed run、OUTPUT保持、Lineageからchatへの送信を検証する。
dbt.snowflakeManaged.executionTimeoutの設定方法と、タイムアウト時の実行状態・再実行手順を公式ドキュメントで確認する。- 月次自動化を非本番ジョブで試し、指定日が各月でどのように扱われるかを確認する。
公式情報
仕様・提供条件は更新される可能性があります。導入前に必ず公式リリースノートを確認してください。
https://docs.snowflake.com/release-notes/2026/other/2026-08-24-coco-desktop-v1-21-1