allow_retry と Arel.sql / allow_retry and Arel.sql

omotesando.rb#113 の登壇資料です。
https://omotesandorb.connpass.com/event/366283/

スライドに掲載したURL：
Rails アプリケーションの設定項目 - Railsガイド
https://railsguides.jp/configuring.html#リトライの振る舞いを設定する

Rails の隠れた堅牢性：SELECTクエリが自動リトライされる仕組み https://blog.smartbank.co.jp/entry/2025/06/05/110000

Add retryable option to Arel.sql with bind parameter support - rails/rails#55586
https://github.com/rails/rails/pull/55586

Transcript

1. 2025/09/04　omotesando.rb #113 株式会社タイミー　新谷哲平 allow_retry と Arel.sql — Rails 8の自動リトライを使いこなすために @euglena1215
2. 自己紹介 Shintani Teppei（@euglena1215） • 株式会社タイミー • バックエンド テックリード • 最近モノリスRailsが8に上がったので Rails8カンパニーになりました
3. 2025/09/04　omotesando.rb #113 株式会社タイミー　新谷哲平 allow_retry と Arel.sql — Rails 8の自動リトライを使いこなすために @euglena1215
4. 早速ですがみなさん たまに起きるDBエラー、 気になりますよね？
5. たまに起きるDBエラー、気になりますよね？ DBが不調だったり、DBマイグレーション実行時に該当テーブルにクエリが 投げられていた瞬間など、一時的に接続に失敗することがある 全体としては微々たる数でも、開発者としてはエラーは気になる
6. Rails8から導入された allow_retry Rails8から再実行可能だと判断されたクエリは自動的に再実行されるように 🎉 https://railsguides.jp/configuring.html#リトライの振る舞いを設定する
7. Rails8から導入された allow_retry Rails8から再実行可能だと判断されたクエリは自動的に再実行されるように 🎉 もっと詳しく知りたい方は SmartBank さんの記事がおすすめ Rails の隠れた堅牢性：SELECTクエリが自動リトライされる仕組み https://blog.smartbank.co.jp/entry/2025/06/05/110000
8. Rails8に上げる前の自分 「これはもう勝ちましたわ」
9. Rails8に上げる前の自分 「これはもう勝ちましたわ」 アップグレードして数日後...
10. Rails8に上げる前の自分 「これはもう勝ちましたわ」 \ﾏｯﾃﾀﾖ / DBマイグレーション時に再発 😱
11. 原因を調べる エラーになったクエリを調べてみると、リトライ不能判定されていた なぜリトライできないクエリと判定されたのかを調べてみると、以下のような scope を使っていることが判明
12. なぜ自動リトライされなかった？ 文字列で組み立てられたクエリが混じっていると、そのクエリはリトライ不能と 判定されてしまう → 文字列がリトライ可能かどうかの判定をしていないので安全側に倒している
13. なぜ自動リトライされなかった？ 文字列で組み立てられたクエリが混じっていると、そのクエリはリトライ不能と 判定されてしまう → 文字列がリトライ可能かどうかの判定をしていないので安全側に倒している LIKE 演算子を題材に「このクエリはリトライしても安全」と Rails に伝えるため にはどうしたらいいかを調べてみたのでご紹介
14. １. Arel で組み立てる • 文字列で組み立てず、Arel を使って組み立てる • 最新バージョン（Rails 8.0.2.1）で利用可能。正直な話、安定版バージョン を使って LIKE で自動リトライさせるにはこの方法しかない
15. ２. Arel.sql で retryable フラグをつける（プレースホルダ無） • Arel.sql で囲って retryable オプションを渡し、リトライ可能であることを 明示する • 最新バージョン（8.0.2.1）では使えず、Rails Edge（rails/rails の main ブランチ）で利用可能 • ただしプレースホルダは使えないので要注意。プレースホルダを使うと リトライされません
16. ３. Arel.sql で retryable フラグをつける（プレースホルダ有） • Arel.sql で囲って retryable オプションを渡し、リトライ可能であることを 明示する • https://github.com/rails/rails/pull/55586 がマージされれば Rails Edge で 利用可能 ◦ omotesando.rb 登壇駆動でパッチを作りました！ • プレースホルダは使いたいので個人的にはこれがマージされてほしい
17. まとめ：Rails で LIKE 演算子を自動リトライさせるには 1. Arel を使って組み立てる a. 今自動リトライさせるならこれしかない 2. Arel.sql で retryable フラグをつける（プレースホルダ無） a. 最新バージョンでは使えないが、次のバージョンから利用可能に 3. Arel.sql で retryable フラグをつける（プレースホルダ有） a. パッチが取り込まれればいつか利用可能に、取り込まれるかどうかはわからない 個人的には最新バージョンでは LIKE を使ったクエリの自動リトライを諦めて、 次バージョン以降の Arel.sql を使った書き方で対応するのが現実的 Arel ジャンキーの方は今のバージョンが Arel を布教するチャンスですよ