Snowpark Library for Pythonの2025年リリースノート¶

改善¶

• Snowflakeシステムプロシージャを呼び出しても、プロシージャの戻り値タイプをチェックする追加の describe procedure 呼び出しは起動しません。

• ステージURLと FILE データタイプを持つ Session.create_dataframe() に対するサポートが追加されました。

• session.read.option('mode', <mode>), option('rowTag', <tag_name>).xml(<stage_file_path>) を使用してXMLファイルを読み込む際に、破損したXML記録を処理するための異なるモードに対するサポートが追加されました。現在、 PERMISSIVE、 DROPMALFORMED、 FAILFAST がサポート対象になります。

• 指定された ROWTAG がファイル内に見つからない場合のXMLリーダーのエラーメッセージが改善されました。

• Dataframe.drop のクエリ生成が改善されました。 SELECT * EXCLUDE () を使用してドロップされた列を除外できるようになります。この機能を有効にするには、 session.conf.set("use_simplified_query_generation", True) を設定します。

• StructType.from_json に VariantType のサポートを追加しました。

バグ修正¶

• 外部データベース内のユニコードまたは二重引用符で囲まれた列名が正しく引用されないためにエラーが発生していた DataFrameWriter.dbapi （プライベートプレビュー）のバグを修正しました。

• ネストされた OBJECT データの名前付きフィールドにスペースが含まれるとエラーになるバグを修正しました。

Snowparkローカルテストの更新¶

Snowpark pandas API の更新¶

新機能¶

• StoredProcedure.register():code: の execute_as 引数の restricted caller パーミッションに対するサポートを追加しました。

• DataFrame.to_pandas() における非選択ステートメントに対するサポートを追加しました。

• Session.add_packages、 Session.add_requirements、 Session.get_packages、 Session.remove_package、 Session.clear_packages に artifact_repository パラメーターのサポートを追加しました。

• session.read.option('rowTag', <tag_name>).xml(<stage_file_path>) で行タグを使用してXMLファイルを読み込むサポートを追加しました（実験的）。

  • XMLの各記録が個別の行として抽出されます。

  • その記録内の各フィールドが VARIANT タイプの独立した列になり、 col(a.b.c) などのドット記法でさらにクエリを実行できるようになります。

• DataFrameReader.dbapi （PrPr）に更新を追加しました。

  • 取り込んだ複数のデータを1つのParquetファイルにマージしてパフォーマンスを最適化するための fetch_merge_count パラメーターを追加しました。

  • Databricksに対するサポートを追加しました。

  • Snowflake UDTFによるインジェストに対するサポートを追加しました。

• functions.py でのAI対応関数のサポートを追加しました（プライベートプレビュー）。

  • prompt

  • ai_filter （prompt() 関数と画像ファイルに対するサポートを追加し、第2引数名を expr から file に変更）

  • ai_classify

Snowparkローカルテストの更新¶

Snowpark Pandas API の更新¶

新機能¶

• relaxed_ordering パラメーターを採用することで、 Dataframe.to_snowpark_pandas における緩和された一貫性と順序保証のサポートを追加しました。

• DataFrameReader.dbapi （プレビュー）で session_init_statement パラメーターに文字列のリストを指定できるようになり、セッションの初期化中に複数のSQLステートメントを実行できるようになります。

改善¶

• Dataframe.stat.sample_by のクエリ生成を改善しました。 fractions の各キーに対してUNION ALLサブクエリを作成する旧方式と比較して、大規模な fractions ディクショナリで適切なスケーリングを行う単一のフラットクエリを生成するようになります。この機能を有効にするには、 session.conf.set("use_simplified_query_generation", True) を設定します。

• Parquetファイルをテーブルにコピーする際にベクトル化オプションを有効にすることで、 DataFrameReader.dbapi のパフォーマンスが向上しました。

• 次を行うことで DataFrame.random_split のクエリ生成を改善しました。 session.conf.set("use_simplified_query_generation", True) を設定すると有効になります。

  • データフレームの純粋なレイジー動作になる入力データフレームの内部実装での cache_result に対する必要性を削除しました。

  • 引数 seed が複数の呼び出しやセッションにわたって再現性のある結果で期待通りに動作するようになりました。

• include_decimal が True に設定されている場合、 DataFrame.fillna と DataFrame.replace の両方で、 int と float を Decimal 列に入れられるようになります。

• 一般公開に伴い、次に挙げる files.py のストアドプロシージャ関数とUDFに関するドキュメントを追加しました。

  • SnowflakeFile.write

  • SnowflakeFile.writelines

  • SnowflakeFile.writeable

• SnowflakeFile と SnowflakeFile.open() のドキュメントに若干の変更が行われました。

バグ修正¶

• エラーが発生する以下の関数のバグを修正しました。 .cast() が出力に適用されます。

  • from_json

  • size

Snowparkローカルテストの更新¶

Snowpark Pandas API の更新¶

Snowparkローカルテストの更新¶

バグ修正¶

• ストアドプロシージャとSnowbooksでの使用を妨げる DataFrameReader.dbapi （プライベートプレビュー）のバグを修正しました。

新機能¶

• functions.py でのAI対応関数のサポートを追加しました（プライベートプレビュー）。

  • ai_filter

  • ai_agg

  • summarize_agg

• functions.py （プライベートプレビュー）で、以下の関連関数を持つ新しいFILE SQLタイプに対するサポートが追加されました。

  • fl_get_content_type

  • fl_get_etag

  • fl_get_file_type

  • fl_get_last_modified

  • fl_get_relative_path

  • fl_get_scoped_file_url

  • fl_get_size

  • fl_get_stage

  • fl_get_stage_file_url

  • fl_is_audio

  • fl_is_compressed

  • fl_is_document

  • fl_is_image

  • fl_is_video

• Artifact Repository（プライベートプレビュー）を使用したPyPiからのサードパーティパッケージのインポートに対するサポートを追加しました。

  • ストアドプロシージャやユーザー定義関数を登録する際には、キーワード引数 artifact_repository と artifact_repository_packages を使用して、それぞれアーティファクトリポジトリとパッケージを指定します。

  • サポート対象のAPIsは以下の通りです。

    • Session.sproc.register

    • Session.udf.register

    • Session.udaf.register

    • Session.udtf.register

    • functions.sproc

    • functions.udf

    • functions.udaf

    • functions.udtf

    • functions.pandas_udf

    • functions.pandas_udtf

改善¶

• ストアドプロシージャの登録時に、 snowflake-snowpark-python パッケージの互換性に関するバージョン検証警告が改善されました。メジャーバージョンとマイナーバージョンが一致しない場合にのみ警告が発せられ、バグ修正バージョンの違いについては警告を発さなくなります。

• cloudpickleの依存関係を改善し、以前のバージョンに加えて cloudpickle==3.0.0 にも対応するようになります。

バグ修正¶

• スレッドセーフセッションが無効の場合に、多数の値を持つDataframeを作成すると Unsupported feature 'SCOPED_TEMPORARY'. エラーが発生するバグを修正しました。

• DataFrameがステージファイルを読み込んで作成され、CTEの最適化が有効になっている場合に、 df.describe が内部SQL実行エラーを発生させるバグを修正しました。

• session.conf.set("use_simplified_query_generation", True) を使用して簡易クエリ生成を有効にした場合、 df.order_by(A).select(B).distinct() が無効なSQLを生成するバグを修正しました。

  • 簡易クエリ生成をデフォルトで無効にしました。

Snowpark Pandas API の更新¶

Snowparkローカルテストの更新¶

新機能¶

• functions.py で以下の関数のサポートを追加しました。

  • normal

  • randn

• Dataframe.union_by_name と Dataframe.union_all_by_name に allow_missing_columns パラメーターのサポートを追加しました。

改善¶

• 競合を避けるためにオブジェクト名のランダム生成を改善しました。

• Dataframe.distinct のクエリ生成を改善し、SELECTの代わりにSELECT DISTINCTを生成し、GROUP BYの全列を生成するようにしました。この機能を無効にするには、 session.conf.set("use_simplified_query_generation", False) をセットします。

非推奨¶

• Snowpark Python関数 snowflake_cortex_summarize が廃止予定になりました。ユーザーは snowflake-ml-python をインストールし、代わりに snowflake.cortex.summarize 関数を使用することができます。

• Snowpark Python関数 snowflake_cortex_sentiment が廃止予定になりました。ユーザーは snowflake-ml-python をインストールし、代わりに snowflake.cortex.sentiment 関数を使用することができます。

バグ修正¶

• 複数のクエリを生成するDataFramesにおいて、セッションレベルのクエリタグがスタックトレースによって上書きされるバグを修正しました。これで、 session.conf.set("collect_stacktrace_in_query_tag", True) の場合、クエリタグはスタックトレースにのみセットされるようになります。

• Session._write_pandas で、Snowpark pandasオブジェクトを書き込む際に Session._write_modin_pandas_helper に use_logical_type のパラメーターを誤って渡していたバグを修正しました。

• SQLオプション生成において、複数の値が正しくフォーマットされないバグを修正しました。

• Session.catalog で、データベースまたはスキーマの空文字列が正しく処理されず、誤ったSQLステートメントを生成していたバグを修正しました。

実験的機能¶

• Snowflakeテーブルへのpyarrowテーブルの書き込みに対するサポートを追加しました。

Snowpark Pandas API の更新¶

バグ修正¶

• apply で、kwargsが正しく適用関数に渡されないバグを修正しました。

Snowparkローカルテストの更新¶

バグ修正¶

• DataFrame.join で、列のタイプに誤りがあったバグを修正しました。

• when ステートメントで、 otherwise 句の結果が不正になるバグを修正しました。

新機能¶

functions.py で以下の関数のサポートを追加しました。

• array_reverse

• divnull

• map_cat

• map_contains_key

• map_keys

• nullifzero

• snowflake_cortex_sentiment

• acosh

• asinh

• atanh

• bit_length

• bitmap_bit_position

• bitmap_bucket_number

• bitmap_construct_agg

• cbrt

• equal_null

• from_json

• ifnull

• localtimestamp

• max_by

• min_by

• nth_value

• nvl

• octet_length

• position

• regr_avgx

• regr_avgy

• regr_count

• regr_intercept

• regr_r2

• regr_slope

• regr_sxx

• regr_sxy

• regr_syy

• try_to_binary

• base64

• base64_decode_string

• base64_encode

• editdistance

• hex

• hex_encode

• instr

• log1p

• log2

• log10

• percentile_approx

• unbase64

• DataFrame.create_dataframe を呼び出す際にスキーマ文字列（暗黙の構造体構文を含む）を指定できるようになりました。

• DataFrameWriter.insert_into/insertInto のサポートを追加しました。この方法はローカルテストモードもサポートしています。

• DataFrame.create_temp_view で仮ビューを作成できるようになりました。ビューが既に存在する場合は失敗します。

• 関数 map_cat および map_concat において、複数列のサポートを追加しました。

• DataFrame.with_column と DataFrame.with_columns で元の列の並び順を維持するためのオプション keep_column_order を追加しました。

• StructType 列でのフィールドの名前変更や追加を可能にするオプションを列キャストに追加しました。

• ArrayType に contains_null parameter のサポートを追加しました。

• ステージからファイルを読み込んで作成された DataFrame から DataFrame.create_or_replace_temp_view 経由で仮ビューを作成する機能を追加しました。

• MapType への value_contains_null パラメーターのサポートを追加しました。

• 現在の環境がインタラクティブなものであるかどうかを示すテレメトリーにインタラクティブを追加しました。

• 現在のバージョンから/で始まるファイルパスを読み込めるように、Native Appsで session.file.get を許可します。

• DataFrame.pivot 以降、複数の集計関数をサポートするようになりました。

実験的機能¶

• Snowflakeオブジェクトを管理する Session.catalog クラスを追加しました。 Session.catalog からアクセスできます。

  • snowflake.core はこの機能に必要な依存関係です。

• ステージ上でJSONファイルを読み込む際に、ユーザー入力のスキーマ（複数可）を許可しています。

• DataFrame.create_dataframe を呼び出す際にスキーマ文字列（暗黙の構造体構文を含む）を指定できるようになりました。

改善¶

• README.md を更新し、 cosign を使用したパッケージ署名の検証方法の説明を追加しました。

バグ修正¶

• ローカルテストモードで、列に0が含まれる必要がある場合にNoneが含まれるバグを修正しました。

• StructField.from_json で tzinfo を含む TimestampTypes が正しく解析されないバグを修正しました。

• function date_format で入力列が日付タイプまたはタイムスタンプタイプの場合にエラーとなるバグを修正しました。

• DataFrameで、NULL値が挿入できない列にNULL値が挿入されてしまうバグを修正しました。

• 関数 replace および lit において、列式オブジェクトを渡すとタイプヒントアサーションエラーが発生するバグを修正しました。

• pandas_udf および pandas_udtf において、セッションパラメーターが誤って無視されていたバグを修正しました。

• session.call を通して呼び出されたシステム関数で、タイプ変換エラーが発生するバグを修正しました。

Snowpark Pandas API の更新¶