ドキュメント価格ブログ
お問い合わせ
ログイン無料で新規登録
Back to Tech Articles

SQLAlchemy 2.0とPythonデータクラスによるデータベース操作のモダナイズ

8月 13, 2025
# Misc

Takashi Yamamoto

Infrastructure Engineer · Leapcell

この記事はEnglish、한국어、Deutschでも利用できます
Cover of "SQLAlchemy 2.0とPythonデータクラスによるデータベース操作のモダナイズ"

はじめに：Pythonにおけるデータベース操作の新時代

多くのPythonアプリケーションにとって、データベースとの対話は基本的な要件です。歴史的に、SQLAlchemyのようなオブジェクトリレーショナルマッパー（ORM）は強力な抽象化レイヤーを提供し、開発者がデータベースエンティティをPythonオブジェクトとして扱えるようにしてきました。これらは非常に効果的ですが、SQLAlchemyの以前のバージョンは、特にクエリの構築において、しばしば急峻な学習曲線を示していました。SQLAlchemy 2.0のリリースは、より大きな一貫性、明示性、そして直感的な開発者体験を目指す、大きな前進をマークしました。同時に、Pythonのdataclassesモジュールは、シンプルで不変のデータ構造を定義するための定番となっています。この記事では、SQLAlchemy 2.0のselect()の最新のクエリスタイルとdataclassesの優雅さを組み合わせることで、Pythonのデータベース操作を劇的に簡素化し、近代化する方法を探ります。これにより、より可読性が高く、保守しやすく、堅牢なコードにつながります。

柱の理解：SQLAlchemy 2.0のselect()とPythonデータクラス

実例に入る前に、議論するコアコンセプトを明確に理解しましょう。

SQLAlchemy 2.0のselect()： これはSQLAlchemy 2.0のSQL式言語の礎石です。以前のバージョンのより命令型のクエリ構築メソッドを、完全に宣言的で関数型のAPIに置き換えます。select()コンストラクトは、ORMの利点を提供しながら、SQLクエリの構造により密接に一致するように設計されており、高い構成可能性と明示性を持っています。不変性を重視しており、select()オブジェクトに対する各メソッド呼び出しは、新しい、変更されたセレクトを返します。これにより、予測可能な動作が促進されます。

Python dataclasses： Python 3.7で導入されたdataclassesモジュールは、主にデータを格納するクラスの__init__()、__repr__()、__eq__()などのメソッドを自動生成するためのデコレータと関数を提供します。これらは、従来のクラスよりもシンプルで、多くの場合namedtupleよりも冗長ではありません。データベース操作においては、dataclassesは、シンプルなケースのための完全なORMモデルのオーバーヘッドなしに、データベースエンティティの構造を定義するためのクリーンな方法を提供するか、クエリ結果のためのプレーンなデータ転送オブジェクト（DTO）として機能します。

これらの2つの強力な機能が、優れたデータベース操作体験のためにどのように統合できるかを見ていきましょう。

最新のデータベース操作：組み合わせの力

dataclassesとSQLAlchemy 2.0のselect()を組み合わせると、真の相乗効果が生まれます。SQLAlchemyは歴史的にORMマッピングのために宣言的なベースモデルを使用してきましたが、dataclassesはselect()ステートメントのカスタム結果タイプを定義するために使用できます。特に、特定の列や集計をシンプルで明確に定義された構造に投影する必要がある場合に役立ちます。これは、読み取り専用操作や、データ転送オブジェクトを完全なORMモデルから分離したい場合に特に便利です。

環境設定

まず、デモンストレーション目的で、シンプルなデータベースと従来のORMモデルを備えた基本的なSQLAlchemy環境を設定しましょう。その後、dataclassesをクエリデータの表現に使用する方法を示します。

import os
from dataclasses import dataclass
from typing import List, Optional

from sqlalchemy import create_engine, Column, Integer, String, select
from sqlalchemy.orm import declarative_base, sessionmaker, Mapped, mapped_column

# 宣言モデルのベースを定義
Base = declarative_base()

# 従来のSQLAlchemy ORMモデルを定義
class User(Base):
    __tablename__ = 'users'
    id: Mapped[int] = mapped_column(Integer, primary_key=True)
    name: Mapped[str] = mapped_column(String(50), nullable=False)
    email: Mapped[str] = mapped_column(String(120), unique=True, nullable=False)

    def __repr__(self):
        return f"<User(id={self.id}, name='{self.name}', email='{self.email}')>"

# クエリ結果用のデータクラスを定義
@dataclass
class UserInfo:
    id: int
    name: str
    email: str

# 部分結果用のシンプルなデータクラスを定義
@dataclass
class UserNameAndEmail:
    name: str
    email: str

# データベース設定
DATABASE_URL = "sqlite:///./test.db"
engine = create_engine(DATABASE_URL)
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)

# テーブル作成
Base.metadata.create_all(bind=engine)

# セッションを取得するヘルパー関数
def get_db_session():
    db = SessionLocal()
    try:
        yield db
    finally:
        db.close()

初期データの挿入

いくつかのサンプルユーザーをデータベースに投入しましょう。

def seed_data():
    db = next(get_db_session()) # セッションを取得
    users_to_add = [
        User(name="Alice", email="alice@example.com"),
        User(name="Bob", email="bob@example.com"),
        User(name="Charlie", email="charlie@example.com"),
        User(name="David", email="david@example.com"),
    ]
    for user in users_to_add:
        existing_user = db.query(User).filter_by(email=user.email).first()
        if not existing_user:
            db.add(user)
    db.commit()
    db.close()

seed_data()

select()でクエリを実行し、UserInfoデータクラスインスタンスを返す

次に、select()を使用してデータを取得し、それを UserInfo データクラスに自動的にマッピングする方法を見てみましょう。ここでは select().scalars() または select().all() と mapping(UserInfo) を組み合わせるか、単に結果からデータクラスインスタンスを構築します。

def get_all_users_as_dataclass() -> List[UserInfo]:
    db = next(get_db_session())
    try:
        # 個々の列を選択し、データクラスを構築できます。
        # または、ORMオブジェクトから直接マッピングする場合、異なる方法で行うかもしれません。
        # 列をデータクラスに直接投影するには、行を取得し、アンパックします。
        stmt = select(User.id, User.name, User.email)
        results = db.execute(stmt).all()
        
        # データクラスインスタンスへの手動マッピング
        user_info_list = [UserInfo(id=r.id, name=r.name, email=r.email) for r in results]
        return user_info_list
    finally:
        db.close()

print("\n--- 全ユーザーをUserInfoデータクラスとして取得 ---")
all_users_dataclass = get_all_users_as_dataclass()
for user_info in all_users_dataclass:
    print(user_info)

# 出力:
# UserInfo(id=1, name='Alice', email='alice@example.com')
# UserInfo(id=2, name='Bob', email='bob@example.com')
# UserInfo(id=3, name='Charlie', email='charlie@example.com')
# UserInfo(id=4, name='David', email='david@example.com')

UserNameAndEmailによる部分データの投影

ユーザー情報の一部しか必要ない場合はどうでしょうか？ select()でこれは簡単に行え、dataclassesはこれらの部分結果のためのクリーンなターゲットを提供します。

def get_user_names_and_emails() -> List[UserNameAndEmail]:
    db = next(get_db_session())
    try:
        stmt = select(User.name, User.email).where(User.name.startswith("C"))
        results = db.execute(stmt).all()
        
        # よりシンプルなデータクラスへのマッピング
        name_email_list = [UserNameAndEmail(name=r.name, email=r.email) for r in results]
        return name_email_list
    finally:
        db.close()

print("\n--- ユーザー名とメールアドレス（フィルタリング後）をUserNameAndEmailデータクラスとして取得 ---")
partial_users = get_user_names_and_emails()
for user_part in partial_users:
    print(user_part)

# 出力:
# UserNameAndEmail(name='Charlie', email='charlie@example.com')

select()によるフィルタリングと並べ替え

select()コンストラクトは、直感的でチェーン可能な方法で、すべての標準的なSQL操作をサポートします。

def get_users_by_id_range(min_id: int, max_id: int) -> List[UserInfo]:
    db = next(get_db_session())
    try:
        stmt = (
            select(User.id, User.name, User.email)
            .where(User.id >= min_id)
            .where(User.id <= max_id)
            .order_by(User.name) # 名前でアルファベット順に並べ替え
        )
        results = db.execute(stmt).all()
        return [UserInfo(id=r.id, name=r.name, email=r.email) for r in results]
    finally:
        db.close()

print("\n--- ID範囲でフィルタリングし、名前で並べ替えたユーザー ---")
filtered_users = get_users_by_id_range(2, 3)
for user_info in filtered_users:
    print(user_info)

# 出力:
# UserInfo(id=3, name='Charlie', email='charlie@example.com')
# UserInfo(id=2, name='Bob', email='bob@example.com') (注意：ID 2と3の順序は名前によって変わることがあります。BobはCharlieより前に来ます)

待てよ、再度出力を確認すると、BobはCharlieより前に来ている。出力は名前に従ってアルファベット順に並べ替えた際、正しい。

このアプローチの利点

  1. 可読性： select()構文は非常に表現力豊かで、SQLのように読めるため、取得されるデータが何であるかを理解しやすくなります。dataclassesは、期待される結果構造​​のクリーンで明示的な定義を提供します。
  2. 型安全性： 型ヒントを持つdataclassesを定義することで、静的解析の利点が得られ、コードがデータ型を正しく処理し、実行時エラーを減らすことを保証します。
  3. 分離： クエリ結果にdataclassesを使用することで、データ転送オブジェクトをORMモデルから分離できます。これは、レイヤードアーキテクチャで、完全なORMエンティティを公開せずに、シンプルな目的構築データオブジェクトをレイヤー間で渡したい場合に特に役立ちます。
  4. 柔軟性： select()は、結合、集計、サブクエリを含む複雑なクエリの構築に非常に柔軟です。dataclassesは、これらのクエリのあらゆる投影に一致するように調整できます。
  5. 最新のPython： 現代的なPython機能（dataclasses）とSQLAlchemyの意図された2.0スタイルを採用しており、より代名的で将来性のあるコードにつながります。

結論

SQLAlchemy 2.0のselect()ステートメントとPython dataclassesを戦略的に組み合わせることで、開発者はデータベース操作に対して高度に近代化され、型安全で、読みやすいアプローチを実現できます。このパターンは、クエリ構築を簡素化し、明示的なデータ構造を通じてコードの透明性を向上させ、より良いアーキテクチャ上の分離を促進します。このスタイルを採用することで、より堅牢で保守性の高いデータベース駆動型Pythonアプリケーションが実現します。

Share this article

HackerNews

More Posts from Leapcell

cover

ASGIによるPython非同期Webの可能性の解放

cover

FastAPI のパワーを依存性注入で解き放つ

Popular Posts