Dependsパターンによるセッション管理

FastAPIにはDepends(依存性注入)という仕組みがあります。Dependsを使うと、エンドポイントの関数が呼ばれるたびに、必要なオブジェクト(この場合はデータベースセッション)を自動的に生成し、処理後に自動的にクリーンアップすることができます。

基本的な構文は以下のとおりです。

from fastapi import Depends
from sqlmodel import Session
from database import get_session

@app.get("/パス")
def 関数名(session: Session = Depends(get_session)):
    # sessionを使ってデータベース操作

Depends(get_session)を指定すると、FastAPIがリクエストのたびにget_session()を呼び出し、生成されたSessionを関数の引数sessionに自動的に渡します。レスポンスが返された後、セッションは自動的に閉じられます。

💡 ポイント
Dependsを使わない場合、各エンドポイントでセッションの作成とクローズを手動で行う必要があります。Dependsを使うことで、セッション管理のコードを一箇所(get_session())にまとめられるため、各エンドポイントのコードがシンプルになります。