トップ / 実行・アクション・IO

to_pandas

結果をpandas DataFrameに変換します。

df.to_pandas()

ldf.collect().to_pandas()

挙動・設計の違い

Snowparkは結果をPyArrowのバッチストリームとして受け取り、pandas DataFrameへ変換します。Polarsは内部的にすでにApache Arrow形式でデータを保持しているため、ほぼコピーなしで高速にpandasへ変換できます。どちらも実行して確認したところ、to_pandas()という同じメソッド名で呼び出せます。

移行時の落とし穴

SnowflakeのNUMBER(38, 0)のような大きな精度の数値型は、pandasへ変換する際にobject型やdouble精度のint64に変換されることがあり、桁数によっては精度が落ちる可能性があります。Polars側は列の型がそのままpandasの対応する型にマッピングされるだけなので、この種の精度の懸念は基本的に発生しません。移行元がSnowparkの大きな数値列だった場合は変換後の値を確認します。

実行・アクション・IOの他のメソッド

• collect ── それまで積み上げた変換を実際に評価し、結果を手元に取得します。最も基本的なアクション。
• show ── 結果の先頭数行を、確認用に画面へ表示します。
• first ── 先頭の1行だけを取得します。
• take ── 指定した件数の行を取得します。
• to_local_iterator ── 結果を全件メモリに載せず、1行（またはチャンク）ずつ順番に処理します。
• cache_result ── それまでの計算結果を1度だけ確定させ、以降はその結果を使い回します。
• createOrReplaceView（create_or_replace_view） ── 今のDataFrameの定義を、他のSQLセッションからも参照できるビューとして登録します。
• createOrReplaceTempView（create_or_replace_temp_view） ── 今のセッション限定で有効な、一時的なビューを作ります。
• write.save_as_table ── 結果をテーブル（またはファイル）として書き出します。
• explain ── その時点までの変換が、実際にどう実行される予定かを表示します。

関連する基礎知識

• Snowpark と Polars の違い（総論）
• Snowpark pandas API（pandas on Snowflake）の位置づけ

出典・検証情報

• Snowpark 公式リファレンス（to_pandas）
• Polars 公式リファレンス（to_pandas）

Polars 1.43.2 で実行確認 / Snowpark Python SDK 1.54.0 で静的検証（2026-08-26）