SNOWFLAKE NEW FEATURE / PRACTICAL BRIEF

Snowflake Python APIs 1.13.1でCode BundleとDynamic Table管理を型安全に拡張

Snowflake Python API (v1.13.1)

日付不明機能アップデート

Python開発者はCode Bundle実行結果を反復処理し、Dynamic Tableの初期化・更新・データメトリクス設定をAPIで扱える

Snowflake Python APIs v1.13.1は、Code BundleとDynamic Tableの管理機能を拡張するリリースです。Code Bundleでは、BundleSpecとCodeBundleSpecificationのtyped modelが追加され、実行結果に対するiter()も利用できます。DynamicTableには初期化用warehouse、バックフィル、ログレベル、クラスタリングなどのフィールドが追加されました。さらに、データメトリクスのスケジュールモデルと、refresh_modeのADAPTIVEおよびCUSTOM_INCREMENTALが追加されています。Previewであるとの記載はありません。

CHANGE TYPE
機能アップデート
PRIMARY AUDIENCE
SnowflakeのPython自動化・運用基盤を担当するデータエンジニア
AVAILABILITY
Version 1.13.1の公開日は2026年8月12日です。
01

なぜ重要か

従来は、Code Bundleの仕様を型付きモデルとして扱ったり、実行結果をiter()で処理したりする機能がリリースノート上で示されていませんでした。今回の変更により、PythonコードからCode Bundle実行やDynamic Tableの設定を、追加されたモデルやフィールドを通じて表現できます。ただし、サーバー側の対応条件や実際の利用可否は、このリリースノートだけでは判断できません。

02

対象となるチーム

  • SnowflakeのPython自動化・運用基盤を担当するデータエンジニア
  • Code Bundleの配布・実行基盤を設計するアプリケーション開発チーム
  • Dynamic Tableとデータ品質メトリクスを管理するデータプラットフォームチーム
  • Snowflake Python APIsの依存バージョンを管理する開発者・SRE
03

提供条件

  • Version 1.13.1の公開日は2026年8月12日です。
  • 提供ステータスはリリースノートに記載なし。
  • 必要なSnowflakeエディションはリリースノートに記載なし。
  • 対応リージョンはリリースノートに記載なし。
  • サーバー側の具体的な前提バージョンや有効化条件はリリースノートに記載なし。
04

ユースケース

  • Code Bundleの仕様をBundleSpecやCodeBundleSpecificationとして保持し、Pythonアプリケーション内で入力・実行情報を型付きデータとして扱う。
  • Code Bundle executionの結果をiter()で順次処理し、実行状況の収集や後続処理を実装する。
  • Dynamic Tableのinitialization_warehouse、backfill_from、start_at、row_timestampなどをPython APIから設定し、作成・更新処理を自動化する。
  • Dynamic Tableのlog_level、default_ddl_collation、cluster_by_raw、frozen_whereを環境別の構成として管理する。
  • DataMetricCronSchedule、DataMetricMinutesSchedule、DataMetricTriggerOnChangesScheduleを使い、データメトリクスの実行スケジュールをコードで定義する。
05

仕組みと使い方

Snowflake Python APIsの対象リソースに追加されたtyped model、フィールド、列挙値を使って設定を構成します。Code Bundleでは、既存のcode_bundles管理機能やcode_bundle_executionの実行・状態取得・キャンセル機能と組み合わせて、BundleSpecおよびCodeBundleSpecificationを利用し、executionの結果をiter()で処理します。Dynamic Tableでは、DynamicTableに追加された各フィールドと、データメトリクス用のスケジュールモデルを設定します。refresh_modeにはADAPTIVEまたはCUSTOM_INCREMENTALを指定できるようになりました。具体的なimport文、コンストラクタ、メソッドシグネチャ、SQL例はリリースノート本文に記載されていないため、公式の「Snowflake Python APIs: Managing Snowflake objects with Python」で確認してください。

06

導入ステップ

  1. Snowflake Python APIsの依存バージョンを1.13.1に更新できる検証環境を用意する。
  2. 公式ドキュメントでBundleSpec、CodeBundleSpecification、Code Bundle executionのiter()の正式なAPIシグネチャを確認する。
  3. DynamicTableの追加フィールドとDataMetricSchedule系モデルを使う最小構成を、非本番リソースで作成・取得して確認する。
  4. refresh_modeのADAPTIVEおよびCUSTOM_INCREMENTALが対象アカウントで受け付けられるか検証する。
  5. 権限、サーバー側の対応条件、既存コードへの影響を確認したうえで、段階的に本番へ適用する。
07

運用上の注意

  • v1.13.1にはBug fixesの記載がなく、今回の変更は主に新しいモデル、フィールド、列挙値の追加です。
  • リリースノートには、追加フィールドごとのデフォルト値、相互依存関係、入力制約が記載されていません。実装前にAPIリファレンスで確認してください。
  • Dynamic Tableやデータメトリクスの設定が、利用中のSnowflake環境でサーバー側に対応しているかを確認する必要があります。
  • typed modelの導入に伴い、既存の辞書ベースの設定やシリアライズ処理がある場合は、型やフィールド名の差異を回帰テストしてください。
08

制約事項

  • エディション、リージョン、PreviewまたはGenerally Availableの別は、このリリースノートに記載されていません。
  • 追加されたフィールドやスケジュールモデルの詳細な使用例、SQL構文、権限要件は、このリリースノート本文だけでは確認できません。
  • Code Bundle executionのiter()が返す具体的な要素型、反復終了条件、実行状態との関係は、リリースノートに記載されていません。
  • ADAPTIVEおよびCUSTOM_INCREMENTALの動作条件や既存のrefresh_modeとの互換性は、リリースノートに記載されていません。
09

次に確認すること

  • Snowflake Python APIs: Managing Snowflake objects with Pythonで、v1.13.1に対応する正式なクラス、メソッド、フィールド定義を確認する。
  • 対象アカウントでDynamic Table、Data Metric、Code Bundleに必要なサーバー機能と権限を確認する。
  • Code Bundle executionのiter()、DynamicTableの追加設定、refresh_modeの新しい値を非本番環境で検証する。
  • 依存関係とリリース履歴を確認し、既存のPython API利用コードに対する回帰テスト項目を作成する。
→

公式情報

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

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