Zenn
🤖

ActiveRecordでの`IN`句の空エラー対策

に公開
Rails
Ruby
tech

問題点

RailsアプリケーションでRansackを使って検索機能を実装している際に、特定の検索パラメーターが空の場合、SQLのIN句が空になり、エラーが発生することがありました。

例：

... WHERE column_name IN ()

このような問題は、検索メソッドが条件に一致するレコードのIDの配列を返すような場面で特に発生しやすいです。

原因

この問題は、検索条件が一致するレコードがない場合、Ransackが生成するSQLクエリのIN句の中が空になってしまうことが原因です。

解決策

1. 存在しないIDを返す

一番簡単な方法は、検索メソッドが空の配列を返す場合、代わりに存在しないIDを返すようにすることです。

def find_matching_ids(model, attribute, value)
  ids = model.where("#{attribute} LIKE ?", "%#{value}%").pluck(:id)

  ids.presence || [-1]
end

この方法で、IN句が空になることを避け、SQLクエリが正常に実行されるようになります。

2. 事前に条件をチェック

もう一つの方法は、IN句を使用する前に配列が空かどうかを確認し、空の場合はその条件をクエリに含めないようにすることです。

def find_matching_ids(model, attribute, value)
  ids = model.where("#{attribute} LIKE ?", "%#{value}%").pluck(:id)

  return if ids.empty?

  ids
end

この方法では、条件が空の場合、その条件を完全にスキップします。

まとめ

Ransackを使った複雑な検索ロジックを実装する際には、このようなエッジケースに注意することが重要です。今回のような問題を回避するための対策を取り入れることで、より堅牢な検索機能を実装することができます。

こちらの内容でzennの記事として公開しても問題ないように成形しました。必要に応じて、内容の追加や修正を行い、記事として公開してください。

Discussion