由于SQLAlchemy 中文资料比较少,所以根据官网给的tutorial外加其他大佬写的中文资料整合以后准备写一个SQLAlchemy 系列的基础入门教程。本系列可能会夹杂一些个人对于python 、SQLAlchemy 以及ORM的理解,如有出错部分,请指正我。
版本信息:
- SQLAlchemy 1.2.15
- Python 3.6+
- Mac OS 10.14
- DB基于SQLite
前序文章Python SQLAlchemy ORM教程(2)讲了怎么在你的数据库中查询内容,但是有些查询往往不尽然人意,或者效率低下。这个章节,我们主要来讲下,SQLAlchemy为你提供的快捷查询接口和高度自由化的复杂查询
Returning Lists and Saclars
在Query
对象中提供了一些方法帮你快速整理已经被加载的数据。需要明确的知道
>>> query = session.query(User).filter(User.name.like('%ed')).order_by(User.id)
返回的是对象而不是我们平常认知的list
。尽管query
对象可以迭代但是不代表他是list
,list
是一个可迭代对象但是不是迭代器,而query
对象是一个迭代器。关于迭代器和迭代对象的区别,我觉得一张图可以表达清楚,不再细讲
我们看下query
究竟是一个list
还是一个query
对象
>>> query = session.query(User).filter(User.name.like('%ed')).order_by(User.id)
>>> type(query)
<class 'sqlalchemy.orm.query.Query'>
SQLAlchemy提供了一个all()
方法让你可以返回list
>>> all_res=query.all()
>>> type(all_res)
<class 'list'>
>>> all_res
[<User(name='ed', fullname='Ed Jones', password='edspassword'>, <User(name='fred', fullname='Fred Flinstone', password='blah'>]
SQLAlchemy还提供了first()
来把你快速的取出第一个元素
>>> query.first()
<User(name='ed', fullname='Ed Jones', password='f8s7ccs')>
one()
会获取所有的数据,然后看是不是只有一个数据,如果有多于一个数据,将会返回MultipleResultsFound
这个错误:
>>> user = query.one()
Traceback (most recent call last):
...
MultipleResultsFound: Multiple rows were found for one()
如果没有任何数据,则会返回NoResultFound
这个错误:
>>> user = query.filter(User.id == 99).one()
Traceback (most recent call last):
...
NoResultFound: No row was found for one()
这个one()
可以在你设计RESTful的时候提供高效的解决方式,比如当你NoResultFound
的时候你可以直接返回404
当有多个结果被找到的时候你可以返回application error
来防止用户获取他不改获取的数据,比如当用户请求自己主页数据的时候,应该有且仅有一行数据,当返回了多行数据的时候,就可以知道,程序员又写bug了,使用one()
可以有效防止这种情况发生。
题外话:one_or_none()
这个函数跟one()
很像,但是one_or_none()
并不会报错而是直接返回None
,但是当数据多于一行的时候one_or_none()
和one()
一样会报错。
scalar()
会调用one()
,他会返回一行数据
>>> query = session.query(User.id).filter(User.name == 'ed').order_by(User.id)
>>> query
<sqlalchemy.orm.query.Query object at 0x7fcce6caff98>
>>> query.all()
[(1,)]
>>> query.one()
(1,)
>>> query.one()[0]
1
>>> query.scalar()
1
Using Textual SQL
我不准备翻译官方的这个章节,因为我觉得作为新手来说,这个章节的自由度很高,但是操作难度也比较高,需要一定的数据库知识,如果有需要翻译的,麻烦在下面留言哦
Counting
计算数据数量,算是最普遍的需求了吧,SQLAlchemy肯定会提供这个方法的,这个方法叫做count()
它是query
对象中的一个方法
>>> session.query(User).filter(User.name.like('%ed')).count()
2
func
从SQL
角度来说上面的count()
仅仅是进行了最简单的数量统计,等价于SELECT count(*) FROM table
。程序员的要求各种各样,作为一个现代的ORM工具,SQLAlchemy提供了更为精细化的查询,这个查询需要使用 func
对象
>>> from sqlalchemy import func
>>> session.query(func.count(User.name), User.name).group_by(User.name).all()
[(1, u'ed'), (1, u'fred'), (1, u'mary'), (1, u'wendy')]
#我们来分析一下上面的语句,可以看到SQLAlchemy根据你的要求查询了有User.name的数量
>>> session.query(func.count(User.name)).all()
2018-12-16 03:33:54,115 INFO sqlalchemy.engine.base.Engine SELECT count(users.name) AS count_1
FROM users
2018-12-16 03:33:54,115 INFO sqlalchemy.engine.base.Engine ()
[(4,)]
>>> session.query(func.count(User.name)).scalar()
2018-12-16 03:34:01,138 INFO sqlalchemy.engine.base.Engine SELECT count(users.name) AS count_1
FROM users
2018-12-16 03:34:01,139 INFO sqlalchemy.engine.base.Engine ()
4
对于更像SQL
查询的表达方式,如下
>>> session.query(func.count('*')).select_from(User).scalar()
4
下一个章节将会将关于数据库关系的建立