flask-SQLAlchemy简介

flask-SQLAlchemy 是一个为您的flask应用增加SQLAlchemy支持的扩展。

在python扩展库中其实包含了SQLAlchemy。在版本的不断叠加后，已经被整合到flask架构中，flask-SQLAlchemy简化在Flask中SQLAlchemy的使用，提供了有用的默认值和额外的助手来更简单地完成常见任务。

笔者认为SQLAlchemy比较精髓的是使用ORM(对象关系映射)，相对于传统连接数据库使用select，update，insert，delete操作数据表来说具有以下特点：

  • 简单——以最基本的形式建模数据

  • 传达性——数据库结构被任何人都能理解的语言文档化

  • 精确性——基于数据模型创建正确标准化的结构

完事无绝对，ORM有明显的优势，就会想伴随有缺点。

  • 隐蔽性——相对于传统使用select,update,insert,delete来说，隐藏了操作数据表的具体操作，不利于SQL的学习

  • 数据表结构修改难——在设计中有时会忽略了一些字段的定义，在ORM模式中只能更新映射表更新字段，而且效果远不如alter table [表名] add 字段名更新字段来的容易理解，常常会忽略一些细节

但不得不说，ORM模式的确打开了新世界的大门，大大减少了学习及使用数据库的过程与难度。

一、常用方法

  • 常用的SQLAlchemy查询过滤器
过滤器 说明
filter( ) 把过滤器添加到原查询上，返回一个新查询
filter_by( ) 把等值过滤器添加到原查询上，返回一个新查询
limit 使用指定的值限定原查询返回的结果
offset( ) 偏移原查询返回的结果，返回一个新查询
order_by( ) 根据指定条件对原查询结果进行排序，返回一个新查询
group_by( ) 根据指定条件对原查询结果进行分组，返回一个新查询
  • 常用的SQLAlchemy查询执行器
方法 说明
all( ) 以列表形式返回查询的所有结果
first( ) 返回查询的第一个结果，如果未查到，返回None
first_or_404( ) 返回查询的第一个结果，如果未查到，返回404
get( ) 返回指定主键对应的行，如不存在，返回None
get_or_404( ) 返回指定主键对应的行，如不存在，返回404
count( ) 返回查询结果的数量
paginate( ) 返回一个Paginate对象，它包含指定范围内的结果

二、实例

创建表

db.create_all()

删除表

db.drop_all()

插入一条数据

ro1 = Role(name='admin')
db.session.add(ro1)
db.session.commit()

再次插入一条数据

ro2 = Role(name='user')
db.session.add(ro2)
db.session.commit()

一次插入多条数据

us1 = User(name='wang',email='wang@163.com',pswd='123456',role_id=ro1.id)
us2 = User(name='zhang',email='zhang@189.com',pswd='201512',role_id=ro2.id)
us3 = User(name='chen',email='chen@126.com',pswd='987654',role_id=ro2.id)
us4 = User(name='zhou',email='zhou@163.com',pswd='456789',role_id=ro1.id)
db.session.add_all([us1,us2,us3,us4])
db.session.commit()

查询

filter_by

精确查询，返回名字等于wang的所有人

User.query.filter_by(name='wang').all()

first()

返回查询到的第一个对象

User.query.first()

all()

返回查询到的所有对象 User.query.all()

filter

模糊查询，返回名字结尾字符为g的所有数据。

User.query.filter(User.name.endswith('g')).all()

get()

参数为主键，如果主键不存在没有返回内容

User.query.get()

逻辑非

返回名字不等于wang的所有数据。

User.query.filter(User.name!='wang').all()

逻辑与

需要导入and，返回and()条件满足的所有数据。

from sqlalchemy import and_
User.query.filter(and_(User.name!='wang',User.email.endswith('163.com'))).all()

逻辑或

需要导入or_

from sqlalchemy import or_
User.query.filter(or_(User.name!='wang',User.email.endswith('163.com'))).all()

not_

相当于取反

from sqlalchemy import not_
User.query.filter(not_(User.name=='chen')).all()

in

User.query.filter(User.id.in_((1, 2, 3))).order_by(desc(User.datetime)).all()

null

数据库中的null对应python中的None，可参考以下操作示例

User.query.filter(not_(User.name.isnot(None)))

参考 [http://docs.sqlalchemy.org/en/rel_1_0/core/sqlelement.html]

查询数据后删除

user = User.query.first()
db.session.delete(user)
db.session.commit()
User.query.all()

更新数据

user = User.query.first()
user.name = 'dong'
db.session.commit()
User.query.first()

使用update

User.query.filter_by(name='zhang').update({'name':'li'})