SQLAlchemyのStaticPoolって何？
エージェントが書いたコードを読みながら、処理内容を理解しています。SQLAlchemyのStaticPoolとは何か、を調べる機会がありましたので、記録しておきます。
前提として、SQLAlchemyには、接続管理の機能が内包されています。sqlalchemy.pool モジュールにその機能があります。コネクションプーリングを想像しますね。
というか公式ドキュメントを見ると、「Connection Pooling」と明記されています。
https://docs.sqlalchemy.org/en/20/core/pooling.html
その中に次のようなクラスがあります。
QueuePool- 決まった数の接続をキューで管理し、貸し出し・返却する。
- 本番で利用されることを想定したクラスです。
NullPool- 接続をプールせず、毎回開いて毎回閉じます。
- コネクションプーリングを無効化するためのクラスです。
StaticPool- プロセス全体で1本の接続を共有するためのクラスです。
- マルチスレッドで動く場合でも、同じ接続が共有されます。
SingletonThreadPool- スレッドごとに1本の接続を保持します。
- SQLAlchemyでSQLiteを選択すると、デフォルトはこちらが利用されます。
AssertionPool- デバッグ用のクラスです。
- 同時に2つ以上checkoutされたらエラーが発生します。
実際のコードはこの辺にあります。 ConnectionFairy という概念が登場するのが印象的です。
https://github.com/sqlalchemy/sqlalchemy/blob/main/lib/sqlalchemy/pool/impl.py
StaticPoolingは、SQLiteのインメモリDBを使う場面でよく使われます。
