2025年の Snowflake Connector for Python リリースノート

この記事には、 Snowflake Connector for Python のリリースノートが含まれています。また、該当する場合は以下が含まれます。

  • 動作の変更

  • 新機能

  • 顧客向けバグ修正

Snowflake は、 Snowflake Connector for Python の更新にセマンティックバージョニングを使用します。

ドキュメントについては、 Python用Snowflake Connector をご参照ください。

バージョン3.17.2(2025年8月20日)

新機能および更新

  • なし。

バグ修正

  • platform_detection_timeout_seconds を0に設定することで、エンドポイントベースのプラットフォーム検出を無効にする機能が追加されました。

  • platform_detection が存在しないエンドポイントへの警告とともに失敗したリクエストを再試行していたバグを修正しました。

バージョン3.17.1(2025年8月14日)

新機能および更新

  • 渡されたデータに対してスキーマ推論を実行するために、write_pandasinfer_schema パラメータを追加しました。

バグ修正

  • Snowflake 名前空間を非モジュールに戻しました。

バージョン3.17.0(2025年8月13日)

新機能および更新

  • AWS、Azure、Google Cloud、KubernetesプラットフォームでワークロードIDフェデレーションのサポートが追加されました。

    • workload_identity_provider 接続パラメーターを追加しました。

    • Added WORKLOAD_IDENTITY to the values for the authenticator connection parameter.

  • キャッシュと構成でファイルの権限チェックをスキップする:codenowrap:unsafe_skip_file_permissions_check フラグを追加しました。

  • Added basic JSON support for Interval types.

  • 間隔タイプの:codenowrap:ResultMetadata`に:codenowrap:`type_code の入力を追加しました。

  • pyarrowのバージョン制約を緩和しました。バージョン19以上が使用できるようになりました。

  • 接続に:codenowrap:snowflake_versionプロパティ を導入しました。

  • write_pandas 関数に:codenowrap:use_vectorized_scanner パラメーターのサポートが追加されました。

  • 環境変数を出力しない接続パラメーターを使用したプロキシ設定のサポートが追加されました。

バグ修正

  • 固定 OAuth 認証コードの値。

  • `SnowflakeRestful.fetch`で :codenowrap:`external_session_id`が提供されていないとき、外部セッション認証コードを持つ PAT が使用されるバグを修正しました。

  • Oauthおよび:codenowrap:programmatic_access_token 認証コードの値の大文字と小文字の区別を修正しました。

  • 誤った認証コードの値に対する不明確なエラーメッセージを修正しました。

  • エンドポイントにスキームがあることを確認することで、 GCS ステージングを修正しました。

  • pandas.DataFrame または:codenowrap:pyarrow.Table として取得されたタイムゾーン付きスタンプが、不必要な精度のためにオーバーフローするバグを修正しました。オーバーフローを防止できない場合は、明確なエラーが発生するようになりました。

バージョン3.16.0(2025年7月1日)

新機能および更新

  • client_fetch_use_mp 接続パラメーターが追加されました。これにより、結果バッチの複数処理のフェッチが可能になり、通常のフェッチ時間が短縮されます。

  • 外部セッション ID を使用した新しい個人用アクセストークン(PAT)認証メカニズムのサポートが追加されました。

  • write_pandas 関数に:codenowrap:bulk_upload_chunks パラメーターを追加しました。このパラメーターを:codenowrap: True に設定すると、:codenowrap: write_pandas 関数の動作が変更され、最初にすべてのデータチャンクをローカルディスクに書き込み、次にチャンクフォルダーのワイルドカードアップロードをステージに実行します。False に設定した場合(デフォルト)、チャンクは1つずつ保存、アップロード、削除されます。

  • Python 3.13のWindowsサポートを追加しました。

  • codenowrap:`間隔`タイプのに基本的な矢印のサポートを追加しました。

  • ローカルアプリケーション用のSnowflake OAuth のサポートを追加しました。

バグ修正

  • 場所名における:codenowrap:write_pandas 特殊文字の使用を修正しました。

  • Google Cloud Storage(GCS)クライアントの場所を構築する際の:codenowrap:use_virtual_url の使用を修正しました。

バージョン3.15.0(2025年4月28日)

プライベートプレビュー(PrPr)の特長

AWS、Azure、 GCP およびKubernetesプラットフォームでワークロードIDフェデレーションのサポートが追加されました。

免責事項:

  • この機能にアクセスするには、環境変数 SF_ENABLE_EXPERIMENTAL_AUTHENTICATIONtrue に設定する必要があります。

  • この機能は本番用以外のデータでのみ使用してください。

  • このPrPr機能はサポート対象外です。ただし、PrPrの段階での製品チームとエンジニアリングチームによる対応は可能です。

  • 参加方法およびドキュメントについては、担当のアカウントチームまでご連絡ください。

新機能および更新

  • OAuth 2.0認証コードフロー、OAuth 2.0クライアント認証情報フロー、OAuthトークンのキャッシュに対する新しい認証方法のサポートを追加しました。

    • OAuth 2.0 認証コードのフロー:

      • codenowrap:oauth_client_idoauth_client_secretoauth_authorization_urloauth_token_request_urloauth_redirect_urioauth_scopeoauth_disable_pkceoauth_enable_refresh_tokensoauth_enable_single_use_refresh_tokens のパラメーターを追加しました。

      • パラメーター認証方式の OAUTH_AUTHORIZATION_CODE 値を追加しました。

    • OAuth 2.0クライアント認証フロー:

      • codenowrap:oauth_client_idoauth_client_secretoauth_token_request_urloauth_scope パラメーターを追加しました。

      • パラメーター認証方式の OAUTH_CLIENT_CREDENTIALS 値を追加しました。

    • OAuthトークンキャッシュの場合: ドライバー構成にユーザー名を渡す必要があり、 client_store_temporary_credentialプロパティtrue にセットする必要があります。

バグ修正

  • codenowrap:boto および botocore の最低必要バージョンを1.24に引き上げました。

  • 信頼できる証明書にすでに到達している場合、証明書のチェーントラバースを終了することにより、OSCPの問題を修正しました。

バージョン3.14.1(2025年4月21日)

プライベートプレビュー(PrPr)の特長

  • codenowrap:client_fetch_threads の実験的パラメーターを追加しました。クエリ結果の取り込みでスレッドをより効率的に利用できるようになります。

  • 新しい実験的な認証方法を追加しました。

    • OAuth認証コードとクライアントの認証情報フロー。

    • AWS、Azure、 GCP およびKubernetesプラットフォーム向けのワークロードIDフェデレーション。

免責事項:

  • これらの機能には、環境変数 SF_ENABLE_EXPERIMENTAL_AUTHENTICATIONtrue に設定しないとアクセスできません。

  • これらの機能の使用は、本番以外のデータに制限してください。

  • これらのPrPr機能はサポート対象外です。ただし、PrPrの段階での製品チームとエンジニアリングチームによる対応は可能です。

  • 参加方法およびドキュメントについては、担当のアカウントチームまでご連絡ください。

新機能および更新

  • Python 3.13のサポートを追加しました。

    注釈

    Windows 64のサポートはまだ実験的なものであり、本番環境ではまだ使用しないでください。

  • Python 3.8のサポートを終了しました。

  • 基本10進数の floating-point タイプのサポートを追加しました。

  • codenowrap:password フィールドでのPATの入力に対するサポートを追加しました。

  • GCSリージョナルエンドポイントのサポートを追加しました。

  • GCS仮想URLsのサポートを追加しました。詳しくは エンドポイントのリクエスト をご覧ください。

  • HTTPリクエストIDに使用するUUID4を自動的に生成する代わりに、アップストリームで生成されたUUID4をステートメントパラメーターでコネクタが継承できるようサポートが追加されました(フィールド: requestId)。

  • urllib3、boto3、botocoreの各ライブラリのログ記録を改善しました。将来的に外部所有のライブラリに移行した後でもデータのマスキングを可能にします。

  • 一部のメッセージのログレベルを info`から :codenowrap:`debug に下げました。出力が追いやすくなります。

  • 認証情報の仮キャッシュストレージのセキュリティと堅牢性を向上しました。

  • codenowrap:insecure_mode 接続プロパティが廃止予定になり、以前のプロパティと同じ動作の disable_ocsp_checks に置き換えています。

  • Linux用のファイルベースの認証情報キャッシュを実装および改善しました。これには、トークンキャッシュの強化が含まれます。

バグ修正

  • タイムアウトによるクライアント側のクエリキャンセルのエラーメッセージを改善しました。

  • codenowrap:TO_DATE 矢印からPythonへの変換で、無効な日付の後に正しい日付が続くと、ドライバーがサイレントに失敗するバグを修正しました。

  • check_arrow_conversion_error_on_every_column 接続プロパティを追加しました。False にセットして、最後の列でエラーが発生するまでドライバーがエラーを無視する以前の動作を復元できるようになります。このオプションを使用すると、バグ修正によって影響を受ける可能性のあるワークフローを解除できます。今後のリリースでは削除される予定です。

  • 期限切れのS3認証情報の更新に関する問題を修正し、期限切れの認証情報が見つかった場合の再試行数を増やしました。

バージョン3.14.0(2025年3月3日)

新機能および更新

  • pyOpenSSLの依存関係の上限を25.0.0から26.0.0に変更しました。

  • ディストリビューションパッケージの検索を最適化し、インポート速度を向上しました。

  • codenowrap:write_pandas にicebergテーブルのサポートを追加しました。

  • codenowrap:File タイプのサポートを追加しました。

バグ修正

  • Azureバッチに影響するバグの回避策として、<19.0.0ピンを pyarrow に追加しました。

  • プライベートキーのアカウント名が大文字で指定された場合、プライベートキーOCSPキャッシュのurlが決定できないバグを修正しました。

  • Base64エンコードされたプライベートキーのテストを修正しました。

  • Windowsでのファイルアクセス権チェックのバグを修正しました。

  • GETでダウンロードしたファイルを644パーミッションで保存する以前の動作を復元する unsafe_file_write 接続パラメーターを追加しました。

バージョン3.13.2(2025年1月30日)

新機能および更新

  • コネクタはスコープされた仮オブジェクトを使用しなくなりました。

バグ修正

  • なし。

バージョン3.13.1(2025年1月29日)

新機能および更新

  • なし。

バグ修正

  • Snowflake.connector.pandas_tools モジュールを SQL インジェクションに対して強化しました。詳細については、 CVE-2025-24793 をご参照ください。

  • ローカルの OCSP キャッシュが更新され、内容をシリアライズするためにpickleの代わりにjsonモジュールを使用するようになりました。詳細については、 CVE-2025-24794 をご参照ださい。

  • Linuxの認証情報キャッシュのファイルアクセス権が明示的に更新され、所有者のみ読み取り可能になりました。詳細については、 CVE-2025-24795 をご参照ください。

  • GET でダウンロードしたファイルのファイルアクセス権を更新し、ファイル所有者のみが読めるようにしました。

バージョン3.13.0(2025年1月23日)

新機能および更新

  • IO-bound ThreadPoolExecutors のサイズを PUT および GET コマンド中に制限するための iobound_tpe_limit 接続パラメーターが追加されました。デフォルトでは、サイズはファイル数と CPU コア数のうち小さいほうに計算されます。

  • Connection.is_valid() メソッドを追加しました。このメソッドは、接続がクエリを受信するのに十分安定しているかどうかを検証します。

  • カーソルのチャンク rowcount のログレベルを INFO から DEBUG に更新しました。

  • private_key 認証タイプで、base64エンコードされた DER 秘密キー文字列のサポートを追加しました。

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

バグ修正

  • なし。