Snowflake CLI v3.25.0でApp Runtime運用とデプロイ制御を強化

従来のApp Runtimeデプロイは、環境別設定やupload・build・deployの個別実行を標準化しにくい場合がありました。今回の変更により、targetsでデプロイ先を選択し、必要なフェーズだけを実行できます。また、Workspaceのlive状態をビルド対象にすることで、保存済みの最新作業内容がデプロイされます。

• Snowflake App Runtimeを開発・運用するアプリケーションチーム
• 複数環境へのリリースを管理するDevOps・Platform Engineeringチーム
• dbtプロジェクトをSnowflake CLIからデプロイするデータエンジニア
• Snowflake CLIの認証・接続設定を管理する基盤管理者

• Snowflake CLI v3.25.0として2026年8月24日に公開
• 提供ステータス全体はリリースノートに記載なし
• エディションおよびリージョンの記載なし
• app.yml version 2、--target、段階デプロイはSnowflake App Runtime向け。Native Appのフローは変更なし
• dbt_projects_profiles.ymlのsnow dbt deploy対応はGenerally Available。DCMのpreview、refresh、testはGenerally Availableではない

• 開発・ステージング・本番をtargetsに定義し、snow app deploy --targetで対象環境を明示してデプロイする。
• コードを先にアップロードして内容を確認し、その後にビルドまたは昇格を行う。snow app deploy --upload-only、--build-only、--promote-onlyを使い分ける。
• App Runtimeを水平スケールしている環境で、特定インスタンスの挙動を調査する。snow app events --instance <N>で対象インスタンスのライブコンテナログを取得する。
• Workspace上で編集中のアプリをデプロイする。デプロイ時には最後にコミットした版ではなく、versions/live/の現在の作業状態がビルドされる。
• dbtプロジェクトでdbt_projects_profiles.ymlを採用し、デプロイ対象プロジェクト内へ同じ名前でプロファイルをステージングする。

App Runtimeプロジェクトでは、app.yml version 2が存在するとsnow appコマンドはsnowflake.ymlではなくapp.ymlを基準に動作します。app.ymlのtargetsブロックに名前付きの環境別デプロイを定義し、deploy、open、events、teardown、validateに--targetを指定します。

主な実行例:

snow app deploy --target staging
snow app deploy --target staging --upload-only
snow app deploy --target staging --build-only
snow app deploy --target production --promote-only
snow app events --instance 2

接続追加時に一時認証情報のクライアント保存設定をconfig.tomlへ書き込む場合:

snow connection add --client-store-temporary-credential

snow sql --local-onlyの既定値を環境変数で設定する場合:

SNOWFLAKE_CLI_SQL_LOCAL_ONLY=true snow sql

なお、dbt_projects_profiles.ymlは--profiles-dirで指定したディレクトリ、または指定がなければプロジェクトルートに置きます。同じディレクトリにprofiles.ymlと両方がある場合はdbt_projects_profiles.ymlが優先され、警告が表示されます。

1. Snowflake CLIをv3.25.0へ更新し、snow --versionなどで実行バージョンを確認する。
2. App Runtimeプロジェクトでapp.yml version 2とtargetsの設計を確認し、既存のNative Appプロジェクトとは分離して扱う。
3. 非本番環境で--targetを指定したvalidate、upload-only、build-onlyを実行し、対象環境と各フェーズの結果を確認する。
4. Workspace利用時は、デプロイ直前のlive状態が意図した内容であることを確認してからpromote-onlyを実行する。
5. dbtプロジェクトではprofilesディレクトリ内のファイル名と優先順位を確認し、テスト環境へsnow dbt deployを実行する。
6. 認証情報保存やsnow sqlの既定値を変更する場合は、config.tomlまたは環境変数を適用した接続で動作を検証する。

• app.yml version 2の新しいフローはSnowflake App Runtime向けで、Native Appのフローは変更されません。App Runtime以外への適用可否はリリースノートに記載なし。
• snow app events --instanceはSnowflake App Runtimeのみ対応します。
• snow dcm preview、snow dcm refresh、snow dcm testはGenerally Availableではありません。--helpへの表示にはenable_dcm_preview_featuresの有効化が必要です。
• Snowflake CLI v3.25.0のエディション別提供条件、リージョン制限、必要権限の詳細はリリースノートに記載なし。
• 各コマンドのapp.yml version 2におけるtargetsの詳細なスキーマや設定例は、リリースノート本文だけでは網羅されていません。

• 公式のSnowflake CLIおよびApp Runtimeのapp.yml version 2ドキュメントで、targetsのスキーマ、必須項目、必要権限を確認する。
• 検証用App Runtime環境でvalidateからupload-only、build-only、promote-onlyまでを実行し、既存CI/CDの手順との差分を確認する。
• 公式の接続設定ドキュメントでclient_store_temporary_credentialの保存対象、保護要件、環境変数との優先順位を確認する。
• dbt_projects_profiles.ymlの公式仕様を確認し、profiles.ymlとの共存時に本番デプロイへ影響がないかをテストする。

仕様・提供条件は更新される可能性があります。導入前に必ず公式リリースノートを確認してください。

https://docs.snowflake.com/release-notes/clients-drivers/snowflake-cli-2026