SQLAlchemy Object Relational Tutorial

主要参考官方文档，看不懂的地方上网查的

The SQLAlchemy Object Relational Mapper presents a method of associating user-defined Python classes with database tables, and instances of those classes (objects) with rows in their corresponding tables.

用户定义类 <—> 数据库表格
类的实例 < —–> 表格中的行

engine是连接数据库的核心接口

from sqlalchemy import create_engine
engine = create_engine('mysql+mysqldb://{0}:{1}@{2}:{3}/{4}?charset={5}'.format(
    config_database['alarm']['username'],
    config_database['alarm']['password'],
    config_database['alarm']['host'],
    config_database['alarm']['port'],
    config_database['alarm']['database'],
    config_database['alarm']['charset']
    ), pool_recycle=3600)

Base 是 declarative_base类的实例，也是一个类。自己定义的与数据库表格对应的类继承Base类。

from sqlalchemy.ext.declarative import declarative_base

Base = declarative_base()

可以用mymetadata.tables[tablename]取得继承Base的Table类。

from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy import MetaData

mymetadata = MetaData()
Base = declarative_base(metadata = mymetadata)

User是自己定义的类， users是数据库中表格的名字。__tablename__ 必不可少。

from sqlalchemy import Column, Integer, String
class User(Base):
    __tablename__ = 'users'
    id = Column(Integer, primary_key=True)
    name = Column(String)
    fullname = Column(String)
    password = Column(String)

可以用__table__查看类的定义

>>> User.__table__ 

# 打印出来的结果
Table('users', MetaData(bind=None),
            Column('id', Integer(), table=<users>, primary_key=True, nullable=False),
            Column('name', String(), table=<users>),
            Column('fullname', String(), table=<users>),
            Column('password', String(), table=<users>), schema=None)

用session来处理数据库的增删改查

from sqlalchemy.orm import sessionmaker
Session = sessionmaker(bind = engine)
session = Session()

因为实例与table的行相对应，所以要操作table的行在sqlalchemy中就是直接操作实例

# 增一行
session.add(User(name = 'ed', fullname = 'Ed Jones', password = 'password'))

#增多行 -> 用list传递多个实例
session.add_all([User(...), User(...)])

query()中写的是类名或类名的属性名，可多选
filter()中写的是表达式，用于过滤

# 返回的是一个迭代器
out = session.query(User).filter_by(name='ed')

# 返回一个list
out.all()

# 返回第一个实例, 不存在返回None
out.first()

# 返回所有的行，如果不是正好一行就raise an error
out.one()

# 正好一行返回这一行，没有返回None, 多于一行raise an error
out.one_or_none()

# 如果有记录，返回第一条记录
out.scalar()

用text即可用字符串处理, from_statement()可以用sql语句处理

from sqlalchemy import text

for user in session.query(User).\
filter(text("id<224")).\
order_by(text("id")).all()

session.query(User).from_statement(text("SELECT * FROM users where name=:name")).\
params(name='ed').all()

慢慢补吧，不想写了