Snowflake SQLAlchemy 1.10.1、正規表現 flags の SQL 生成を修正

Snowflake は SQLAlchemy 1.10.1 のリリースノートで、regexp_match と regexp_replace の flags が誤った SQL として生成される問題を修正したと案内しました。

要点

• ColumnElement.regexp_match(..., flags=...) と ColumnElement.regexp_replace(..., flags=...) の flags が対象です。
• flags が標準のパラメータ処理に流れ、バインドパラメータとして扱われることで Snowflake で期待される SQL にならない問題が修正されました。
• 修正後は REGEXP_LIKE(col, pattern, 'i') や REGEXP_REPLACE(col, pattern, replacement, 'i') のように、flags がインラインの文字列リテラルとして出力されます。
• Snowflake SQLAlchemy を使う Python アプリ、Airflow ジョブ、分析ノートブック、社内データツールの回帰確認に関係します。

今回の更新で変わること

今回の Snowflake SQLAlchemy 1.10.1 は、大きな新機能ではなく、正規表現関数の SQL 生成に関する具体的な不具合修正です。公式リリースノートでは、regexp_match と regexp_replace の flags が、Snowflake の SQL で期待される文字列リテラルではなく、通常のバインドパラメータとして処理されていたと説明されています。たとえば大文字小文字を無視するための i のような flags は、Snowflake 側では REGEXP_LIKE(col, pattern, 'i') や REGEXP_REPLACE(col, pattern, replacement, 'i') のように、関数呼び出しの引数として直接渡される必要があります。ここがパラメータ化されると、SQLAlchemy から見れば通常の値渡しでも、Snowflake の正規表現関数としては意図した構文にならず、検索や置換の条件が正しく働かない可能性があります。

実務で重要なのは、この修正が「接続できるかどうか」ではなく「生成された SQL の意味が変わるか」に関係する点です。Snowflake SQLAlchemy を使っている環境では、アプリケーションコードに明示的な SQL が書かれていなくても、ORM やクエリビルダーが正規表現条件を生成している場合があります。ログ抽出、データクレンジング、メールアドレスや ID の形式判定、文字列置換、品質チェックなどで flags 付きの正規表現を使っている場合、1.10.1 への更新によって、これまで失敗していた処理や回避コードが変わる可能性があります。

そのため、今回の更新は小さく見えても、依存関係の固定と代表クエリの確認が必要です。特に Airflow、dbt 周辺の Python 処理、社内バッチ、ノートブック、データアプリで Snowflake SQLAlchemy を共有している場合、どの環境が 1.10.1 を取り込むのかを揃えておく必要があります。正規表現 flags を使う箇所が少ないなら影響は限定的ですが、SQL 生成の修正はテストで見落としやすいため、該当クエリのコンパイル結果と実行結果を両方確認しておきたいです。

対象になりそうなユーザー・チーム

Snowflake SQLAlchemy を使って Python から Snowflake に接続している開発者、デーデータエンジニア、分析基盤チームに関係します。特に、SQLAlchemy の式 API で正規表現検索や置換を組み立てているアプリケーションは確認対象です。

実務で確認したいポイント

• regexp_match、regexp_replace、REGEXP_LIKE、REGEXP_REPLACE を使う Python 経路があるか
• flags 付きの正規表現条件について、生成 SQL と Snowflake 上の実行結果が意図どおりか
• Airflow、ノートブック、社内アプリなどで Snowflake SQLAlchemy のバージョンが揃っているか
• 旧バージョンで入れていた回避処理が 1.10.1 適用後も必要か

今すぐ対応が必要か

Snowflake SQLAlchemy 経由で正規表現 flags を使っていない場合、緊急度は高くなさそうです。一方で、文字列抽出や置換を SQLAlchemy で組み立てているチームは、1.10.1 をテスト環境で適用し、該当クエリの SQL と結果を確認してください。

結局、この更新をどう見るべきか

Snowflake SQLAlchemy 1.10.1 は、Python 接続層の小さな保守更新に見えますが、正規表現 flags の扱いという実行結果に直結する修正です。Snowflake に投げられる SQL の形が正しくなる更新として、依存関係更新だけで終わらせず、該当する文字列処理の回帰確認まで見るのがよさそうです。