SQLAlchemy - SQLAlchemy

SQLAlchemy
Автор (ы) оригинала Майкл Байер
Первый выпуск 14 февраля 2006 г . ; 15 лет назад  ( 14 февраля 2006 г. )
Стабильный выпуск
1.4.15 / 11 мая 2021 г . ; 6 дней назад  ( 2021-05-11 )
Репозиторий Отредактируйте это в Викиданных
Написано в Python
Операционная система Кроссплатформенность
Тип Объектно-реляционное отображение
Лицензия Лицензия MIT
Веб-сайт www .sqlalchemy .org  Отредактируйте это в Викиданных
Майк Байер рассказывает о SQLAlchemy на PyCon 2012

SQLAlchemy - это набор инструментов SQL с открытым исходным кодом и объектно-реляционный преобразователь (ORM) для языка программирования Python, выпущенный по лицензии MIT .

Описание

Философия SQLAlchemy заключается в том, что реляционные базы данных ведут себя не так, как коллекции объектов, по мере увеличения масштаба и производительности, в то время как коллекции объектов ведут себя меньше как таблицы и строки, поскольку в них создается больше абстракции. По этой причине он принял шаблон сопоставления данных (аналогичный Hibernate для Java ), а не шаблон активной записи, используемый рядом других объектно-реляционных сопоставителей. Однако дополнительные плагины позволяют пользователям разрабатывать с использованием декларативного синтаксиса.

История

SQLAlchemy был впервые выпущен в феврале 2006 года и быстро стал одним из наиболее широко используемых инструментов объектно-реляционного сопоставления в сообществе Python наряду с ORM Django .

Пример

В следующем примере представлены отношения n-к-1 между фильмами и их режиссерами. Показано, как определенные пользователем классы Python создают соответствующие таблицы базы данных, как экземпляры со связями создаются с обеих сторон связи и, наконец, как можно запрашивать данные, демонстрируя автоматически сгенерированные SQL- запросы как для отложенной, так и для активной загрузки.

Определение схемы

Создание двух классов 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("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 выдает следующий запрос к СУБД (без псевдонимов): 

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 Вместо этого при установке (по умолчанию) SQLAlchemy сначала будет выдавать запрос для получения списка фильмов и только при необходимости (ленивый) для каждого режиссера запрос, чтобы получить имя соответствующего режиссера: 

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

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

Смотрите также

Рекомендации

Заметки

Внешние ссылки