SQLAlchemyとは

SQLAlchemyの概要

SQLAlchemyは、Python向けのORM(Object Relational Mapper)およびSQLツールキットです。データベース操作をオブジェクト指向的に記述でき、SQL文を直接書くことも可能です。

主な特徴

  • ORMとコアの2層構造:高レベルのORMと低レベルのSQL Expression Language(コア)を併用できる。
  • データベース抽象化:MySQL、PostgreSQL、SQLite、Oracle など多数のDBを同一コードで扱える。
  • 自動マイグレーションとの連携:Alembic などと組み合わせてスキーマ管理ができる。

簡単な使用例

ORMを使ったテーブル定義

from sqlalchemy import Column, Integer, String, create_engine
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy.orm import sessionmaker

Base = declarative_base()

class User(Base):
    __tablename__ = 'users'
    id = Column(Integer, primary_key=True)
    name = Column(String(50))
    age = Column(Integer)

engine = create_engine('sqlite:///example.db')
Base.metadata.create_all(engine)

Session = sessionmaker(bind=engine)
session = Session()

new_user = User(name='Alice', age=30)
session.add(new_user)
session.commit()

SQL Expression Language(コア)を使ったクエリ

from sqlalchemy import select, Table, MetaData

metadata = MetaData()
users = Table('users', metadata, autoload_with=engine)

stmt = select([users.c.name, users.c.age]).where(users.c.age > 25)
for row in engine.execute(stmt):
    print(row)

まとめ

SQLAlchemyは、シンプルなスクリプトから大規模なエンタープライズアプリケーションまで幅広く対応できる柔軟なデータベースツールです。ORMの生産性とSQLコアの制御性を両立させたい場合に特に有効です。