読み方のヒント

矢印ボタン(または ← → キー)でページを移動できます。

第2節 SQLとSQLAlchemy

2.1 エンジンとSession

データベースに接続する部品を作ります。db.py に書きます。

from collections.abc import Iterator

from sqlalchemy import create_engine
from sqlalchemy.orm import Session

from settings import settings

engine = create_engine(settings.database_url)


def get_session() -> Iterator[Session]:
    with Session(engine) as session:
        yield session
名前役割
engineデータベースへの接続を管理する。プログラムに1つだけ作る
Session1回分の作業のまとまり。SQLの実行と、変更の確定・取り消しを行う

create_engine を実行しただけでは、まだ接続しません。最初にSQLを実行するときに接続します。

Session は、psql で接続してから終了するまでの作業に近い単位です。with を使うと、字下げが終わったところで、作業のまとまりが閉じられます。get_session は、第4節でAPIから使います。

6 / 20