SQLAlchemy

SQLAlchemyは、Pythonプログラミング言語のためのオープンソースのSQLツールキットおよびオブジェクト関係マッピングライブラリ（ORM）で、MIT Licenseの下で公開されている。 SQLAlchemyの哲学は、リレーショナルデータベースは規模が大きくなりパフォーマンスが懸念されるようになるにつれて、オブジェクトコレクションのように振る舞わなくなり、一方、オブジェクトコレクションは、抽象化が進むとテーブルや行のように振る舞わなくなる、という2つの原則に対応することである。このため、SQLAlchemyでは、他の多くのオブジェクトリレーショナルマッパーが採用しているアクティブレコードパターンではなく、データマッパーパターン（英語版）を採用している（Java言語のHibernateと類似）。 SQLAlchemyは2006年2月に最初にリリースされた。 次の例は、映画とその監督との間の n対1 の関係を表している。ユーザー定義のPythonクラスに対応するデータベーステーブルを作成する方法、リレーションシップを持つインスタンスをリレーションの両側から作成する方法、最後にデータを検索する方法について、遅延読み込みと一括読み込みの両方で自動生成されたSQLクエリを説明する。 2つのPythonクラスとそれに対応するデータベーステーブルをDBMSに作成する。 from sqlalchemy import * from sqlalchemy.ext.declarative import declarative_base from sqlalchemy.orm import relation, sessionmaker Base = declarative_base() class Movie(Base): __tablename__ = "movies" id = Column(Integer, primary_key=True) title = Column(String(255), nullable=False) year = Column(Integer) directed_by = Column(Integer, ForeignKey("directors.id")) director = relation("Director", backref="movies", lazy=False) def __init__(self, title=None, year=None): self.title = title self.year = year def __repr__(self): return "Movie(%r, %r, %r)" % (self.title, self.year, self.director) class Director(Base): __tablename__ = "directors" id = Column(Integer, primary_key=True) name = Column(String(50), nullable=False, unique=True) def __init__(self, name=None): self.name = name def __repr__(self): return "Director(%r)" % (self.name) engine = create_engine("dbms://user:pwd@host/dbname") Base.metadata.create_all(engine) 監督と映画の関係は、どちらかのエンティティを介して挿入することができる。 Session = sessionmaker(bind=engine) session = Session() m1 = Movie("Robocop", 1987) m1.director = Director("Paul Verhoeven") d2 = Director("George Lucas") d2.movies = [Movie("Star Wars", 1977), Movie("THX 1138", 1971)] try: session.add(m1) session.add(d2) session.commit() except: session.rollback() alldata = session.query(Movie).all() for somedata in alldata: print(somedata) SQLAlchemyは、DBMSに次のクエリを発行する（エイリアスは省略）。 SELECT movies.id, movies.title, movies.year, movies.directed_by, directors.id, directors.name FROM movies LEFT OUTER JOIN directors ON directors.id = movies.directed_by この出力は次のようになる。 Movie('Robocop', 1987L, Director('Paul Verhoeven')) Movie('Star Wars', 1977L, Director('George Lucas')) Movie('THX 1138', 1971L, Director('George Lucas')) 代わりに lazy=True （default）を指定すると、SQLAlchemyは、はじめに映画のリストを取得し、必要な場合のみ（遅延、lazy）それぞれの監督に対応する監督 の名前を取得するクエリを発行する。 SELECT movies.id, movies.title, movies.year, movies.directed_by FROM movies SELECT directors.id, directors.name FROM directors WHERE directors.id = %s [脚注の使い方] ^ Mike Bayer is the creator of SQLAlchemy and Mako Templates for Python. ^ Interview Mike Bayer SQLAlchemy #pydata #python ^ a b “Download - SQLAlchemy”. SQLAlchemy. 21 February 2015閲覧。 ^ “Release 2.0.35” (16 9月 2024). 26 9月 2024閲覧。 ^ “Releases - sqlalchemy/sqlalchemy”. 8 August 2022閲覧。 ^ a b “zzzeek / sqlalchemy / source / LICENSE”. BitBucket. 21 February 2015閲覧。 ^ in The architecture of open source applications ノート Gift, Noah (12 Aug 2008). “Using SQLAlchemy”. Developerworks. IBM. 8 Feb 2011閲覧。 Rick Copeland, Essential SQLAlchemy, O'Reilly, 2008, ISBN 0-596-51614-2 ポータル Free and open-source software ORMライブラリ SQLObject（英語版） - SQLデータベースとPythonオブジェクト間のPythonオブジェクトリレーショナルマッパー Storm (ソフトウェア)（英語版） - SQLデータベースとPythonオブジェクト間のオブジェクトリレーショナルマッピング用のプログラミングライブラリ Python言語で記述されたWebアプリケーションフレームワーク Pylons - ORMライブラリとしてSQLAlchemyを使用できる TurboGears - バージョン2.0以降でORMライブラリとしてSQLAlchemyを採用 Cubes (OLAPサーバ)（英語版） - Python言語で記述された軽量なオープンソースの多次元モデリングおよびOLAPツール 公式ウェブサイト SQLAlchemy Tutorial