SQLAlchemy

SQLAlchemy

Тип	Об'єктно-реляційне відображення
Автор	Майкл Байєр
Перший випуск	Лютий, 2006
Стабільний випуск	1.0.8 (23 липня, 2015 (2015-07-23))
Операційна система	Кросплатформний
Мова програмування	Python
Стан розробки	Активний
Ліцензія	Ліцензія MIT
Репозиторій	github.com/sqlalchemy/sqlalchemy
Вебсайт	sqlalchemy.org

SQLAlchemy — інструментарій SQL та об'єктно-реляційне відображення для мови програмування Python випущене під ліцензією MIT.

SQLAlchemy надає «повний набір добре відомих шаблонів корпоративного рівня стабільності, сконструйованих для високопродуктивного доступу до бази даних, написаних простою мовою Python». Філософія SQLAlchemy стверджує що бази даних SQL поводяться тим менш подібно на колекції об'єктів чим більше починають важити розмір та продуктивність, і навпаки, колекції об'єктів починають поводитись тим менш подібно на таблиці і записи чим більш починає важити рівень абстракції. Тому, було впроваджено шаблон Data mapper (подібний на Hibernate для Java) замість шаблону active Record який використовується в багатьох інших об'єктно-реляційних відображеннях. Проте, додаткові плагіни, такі як Elixir [Архівовано 16 червня 2017 у Wayback Machine.] та declarative дозволяють користувачам розробку з декларативним синтаксисом.

SQLAlchemy була вперше випущена в лютому 2006-го, і швидко стала однією з найширше використовуваних в спільноті Python бібліотек для об'єктно-реляційного відображення.

Приклад

Наступний приклад демонструє відношення n-до-1 між фільмами та їх режисерами. Показано, як описані користувачем класи Python створюють відповідні таблиці бази даних, як елементи відношення створюються на кожній стороні відношення, і як можна робити запити до даних.

Опис схеми

Створенням двох класів, і відповідних таблиць в СКБД:

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("Star Trek", 2009)
m1.director = Director("JJ Abrams")

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 передає до СКБД наступний запит:

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('Star Trek', 2009L, Director('JJ Abrams'))
Movie('Star Wars', 1977L, Director('George Lucas'))
Movie('THX 1138', 1971L, Director('George Lucas'))

Якщо встановити опцію lazy=True, SQLAlchemy спочатку виконає запит для отримання тільки списку фільмів, і лише за потребою виконає запит для кожного режисера, щоб отримати його ім'я:

SELECT movies.id, movies.title, movies.year, movies.directed_by 
FROM movies

SELECT directors.id, directors.name
FROM directors 
WHERE directors.id = %s

Див. також

• SQLObject
• Storm
• Pylons
• TurboGears
• Django

Посилання

• SQLAlchemy home page [Архівовано 7 грудня 2012 у Wayback Machine.]
• SQLAlchemy на SourceForge.net
• Gift, Noah. Using SQLAlchemy. Developerworks. IBM. Архів оригіналу за 2 квітня 2012. Процитовано 6 серпня 2011.
• Rick Copeland, Essential SQLAlchemy [Архівовано 6 вересня 2011 у Wayback Machine.], O'Reilly, 2008, ISBN 0-596-51614-2
• Bayer, Michael. The Architecture of Open Source Applications (Volume 2): SQLAlchemy. Архів оригіналу за 29 вересня 2018. Процитовано 2 жовтня 2018.