SQLAlchemy

ウィキペディアから無料の百科事典

SQLAlchemy
作者 Michael Bayer[1][2]
初版 2006年2月14日 (19年前) (2006-02-14)[3]
最新版
2.0.41[4] ウィキデータを編集 / 2025年5月14日 (18日前)[5]
リポジトリ ウィキデータを編集
プログラミング
言語
Python
対応OS クロスプラットフォーム
サポート状況 開発中
種別 オブジェクト関係マッピング
ライセンス MIT License[6]
公式サイト www.sqlalchemy.org
テンプレートを表示
SQLAlchemyについて講演するMike Bayer (PyCon 2012)

SQLAlchemyは、Pythonプログラミング言語のためのオープンソースのSQLツールキットおよびオブジェクト関係マッピングライブラリ(ORM)で、MIT Licenseの下で公開されている[6]

概要

[編集]

SQLAlchemyの哲学は、リレーショナルデータベースは規模が大きくなりパフォーマンスが懸念されるようになるにつれて、オブジェクトコレクションのように振る舞わなくなり、一方、オブジェクトコレクションは、抽象化が進むとテーブルや行のように振る舞わなくなる、という2つの原則に対応することである。このため、SQLAlchemyでは、他の多くのオブジェクトリレーショナルマッパーが採用しているアクティブレコードパターンではなく、データマッパーパターン英語版を採用している(Java言語のHibernateと類似)[7]

歴史

[編集]

SQLAlchemyは2006年2月に最初にリリースされた[3]

[編集]

次の例は、映画とその監督との間の 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 

脚注

[編集]
  1. ^ Mike Bayer is the creator of SQLAlchemy and Mako Templates for Python.
  2. ^ Interview Mike Bayer SQLAlchemy #pydata #python
  3. ^ a b Download - SQLAlchemy”. SQLAlchemy. 2015年2月21日閲覧。
  4. ^ "Release 2.0.41". 14 May 2025. 2025年6月1日閲覧
  5. ^ Releases - sqlalchemy/sqlalchemy”. 2022年8月8日閲覧。
  6. ^ a b zzzeek / sqlalchemy / source / LICENSE”. BitBucket. 2015年2月21日閲覧。
  7. ^ in The architecture of open source applications
ノート

関連項目

[編集]
  • ORMライブラリ
    • SQLObject英語版 - SQLデータベースとPythonオブジェクト間のPythonオブジェクトリレーショナルマッパー
    • Storm (ソフトウェア)英語版 - SQLデータベースとPythonオブジェクト間のオブジェクトリレーショナルマッピング用のプログラミングライブラリ
  • Python言語で記述されたWebアプリケーションフレームワーク
    • Pylons - ORMライブラリとしてSQLAlchemyを使用できる
    • TurboGears - バージョン2.0以降でORMライブラリとしてSQLAlchemyを採用
  • Cubes (OLAPサーバ)英語版 - Python言語で記述された軽量なオープンソースの多次元モデリングおよびOLAPツール

外部リンク

[編集]