コネクション固定時の不要な検証処理を削除

Active Recordのコネクションプールにおいて、コネクション固定（pinning）時に行われていた明示的な検証処理が削除されました。最近使用されたコネクションを再検証しないロジックが導入されたことで、これらの verify! 呼び出しは無駄な処理となっていました。

背景

Active Recordのコネクションプールは、マルチスレッド環境でデータベースコネクションを効率的に管理するため、コネクション固定（connection pinning）という仕組みを提供しています。これは特定のスレッドに同一のコネクションを紐付ける機能で、トランザクション中のコネクション一貫性を保証します。

従来、コネクションを固定する際には必ず verify! を呼び出してデータベース接続の健全性を確認していました。しかし、Active Recordには既に「最近使用されたコネクションは再検証をスキップする」というロジックが実装されており、固定時の明示的な検証は二重の処理となっていました。

技術的な変更

activerecord/lib/active_record/connection_adapters/abstract/connection_pool.rb の pin_connection! メソッドから、コネクション固定時の verify! 呼び出しが削除されました。

変更前:

@pinned_connection.lock_thread = ActiveSupport::IsolatedExecutionState.context if lock_thread
@pinned_connection.pinned = true
@pinned_connection.verify! # eagerly validate the connection
@pinned_connection.begin_transaction joinable: false, _lazy: false

変更後:

@pinned_connection.lock_thread = ActiveSupport::IsolatedExecutionState.context if lock_thread
@pinned_connection.pinned = true
@pinned_connection.begin_transaction joinable: false, _lazy: false

また、checkout メソッド内の固定コネクション取得時には、強制検証の verify! から条件付き検証の verify に変更されています。

変更箇所:

if @pinned_connection
  @pinned_connection.verify  # 変更前: verify!
end

新たに追加された verify メソッドは、activerecord/lib/active_record/connection_adapters/abstract_adapter.rb で実装されています。

追加されたメソッド:

def verify
  return if @verified
  return if (last_activity = seconds_since_last_activity) && last_activity < verify_timeout
  verify!
end

このメソッドは以下の条件で検証をスキップします：

@verified フラグが立っている場合
最終アクティビティからの経過時間が verify_timeout 未満の場合

条件を満たさない場合のみ、実際のデータベース接続確認を行う verify! が呼び出されます。

設計判断

条件付き検証メソッドの導入により、パフォーマンスと信頼性のバランスが取られました。

PRの説明にある「decent logic about not revalidating a connection that has been used recently」は、この verify メソッドの実装を指しています。固定コネクションは通常、トランザクション実行中に継続的に使用されるため、毎回のcheckout時に強制検証を行うのは過剰です。

一方で、pin_connection! での検証を完全に削除できるのは、その直後に begin_transaction が呼び出され、トランザクション開始時にコネクションが使用されるためです。もしコネクションが切断されていれば、その時点でエラーが検出されます。

この設計により、コネクション検証のオーバーヘッドを削減しつつ、実用上の接続健全性チェックは維持されています。

まとめ

本PRは、コネクションプールの検証ロジックを整理し、不要な verify! 呼び出しを削除した変更です。最近のアクティビティに基づく条件付き検証の仕組みを活用することで、データベース接続の健全性確保とパフォーマンスのバランスを改善しています。