2025年の Snowflake Python APIs リリースノート¶

新機能および更新¶

なし。

バグ修正¶

• ReturnTable タイプで extract オプションを使用すると、 call メソッドが誤った結果を返す原因となっていた ProcedureResource のバグを修正しました。

• CortexInferenceService.complete をPythonワークシートやノートブックから呼び出せるようになりました。

新機能および更新¶

• ServiceResource.get_service_status メソッドが廃止予定になり、 ServiceResource.get_containers メソッドが採用されています。

• procedure.call メソッドに extract オプションを追加しました。このオプションを有効にすると、メソッドは返されたペイロードから結果を抽出します。

  例えば、 extract=False （現在のデフォルト動作）をセットすると、 [{'procedure_name': 42}] のような結果が返されます。この例では、 extract=True をセットすると、値 42 を返します。

  注釈

  extract=False は現在のデフォルト設定のままですが、廃止予定の警告を返すようになります。 extract=True の使用への切り替えを推奨しています。これが次のメジャーリリースでは新しいデフォルトになる予定です。

• ストアドプロシージャ呼び出しにおけるVARIANTタイプのマッピングに対するサポートを追加しました。

バグ修正¶

• ストアドプロシージャでGEOMETRY、GEOGRAPHY、OBJECTの戻りタイプのタイプマッピングを修正しました。

• ストアドプロシージャと関数の __repr__ 実装で、名前に加えて引数のリストが表示されるようになります。

新機能および更新¶

• すべてのコレクション、リソース、モデルクラスに対して __repr__ メソッドを実装しました。

バグ修正¶

• 環境変数 _SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE をデフォルトで有効に変更しました。エラーメッセージが出力され全スタックトレースを表示するようになります。

  この変更は、 SNOWFLAKE_PRINT_VERBOSE_STACK_TRACE がセットされていない場合に発生する、すべての例外に対するスタックトレースが無効にならないよう避けるために行われました。

新機能および更新¶

• オブジェクト識別子を表す snowflake.core.FQN クラスを追加しました。

• drop_finalizer 引数が True にセットされている場合、 DAGOperation.drop メソッドはDAGに関連するファイナライザタスクをドロップします。

  重要

  drop_finalizer 引数は、次のメジャーAPIリリースで削除され、 DAGOperation.drop メソッドが関連するファイナライザタスクをDAGと共に常にドロップするようになります。

バグ修正¶

なし。

新機能および更新¶

• すべての既存エンドポイントで非同期リクエストのサポートを追加しました。

  非同期メソッドは、その名前に _async という接尾辞がついており、操作が完了したかどうかを判断するためにポーリングを使用します。

  並列実行できる呼び出しの数は、CPUsの数に左右されます。スレッドプールのサイズを変更するには、 _SNOWFLAKE_MAX_THREADS 環境変数を使用します。

  使用例については、 snowflake.core.PollingOperation クラスドキュメントをご覧ください。

• StoredProcedureCall 定義を使用してサーバーレスタスクを作成するためのサポートを追加しました。

• Database および Schema リソースに SERVERLESS_TASK_MIN_STATEMENT_SIZE および SERVERLESS_TASK_MAX_STATEMENT_SIZE サーバーレス属性のサポートを追加しました（Snowflakeバージョン9.8に依存）。

• クローニングされたデータベースおよびスキーマのSUSPEND_TASK_AFTER_NUM_FAILURES、USER_TASK_MANAGED_INITIAL_WAREHOUSE_SIZE、USER_TASK_TIMEOUT_MS属性の設定のサポートを追加しました（Snowflakeバージョン9.8に依存）。

• CortexAgentService.Run が廃止予定になり、 CortexAgentService.run を採用しています。

• Cortex SearchサービスAPI内の様々なモデルに新しいオプション属性を追加しました。

  • Function モデルに対する text_boosts と vector_boosts

  • ScoringConfig モデルに対する weights

バグ修正¶

• iter メソッドから返されたタスクオブジェクトで create_or_alter を呼び出せるようになります。

新機能および更新¶

• タスクリソースに TARGET_COMPLETION_INTERVAL、SERVERLESS_TASK_MIN_STATEMENT_SIZE、SERVERLESS_TASK_MAX_STATEMENT_SIZE のサーバーレス属性のサポートを追加しました。

• 以下の新しいリソースのサポートを追加しました。

  • API 統合

  • Icebergテーブル（Snowflakeバージョン9.6に依存）

バグ修正¶

なし。

新機能および更新¶

• snowflake.core から protobuf の依存性を削除しました。

バグ修正¶

なし。

新機能および更新¶

• Cortex Lite Agentリソースのサポートを追加しました。

バグ修正¶

なし。

新機能および更新¶

• Cortex Embedリソースのサポートを追加しました。

バグ修正¶

なし。