由于SQLAlchemy 中文資料比較少,所以根據(jù)官網(wǎng)給的tutorial外加其他大佬寫的中文資料整合以后準(zhǔn)備寫一個SQLAlchemy 系列的基礎(chǔ)入門教程效床。本系列可能會夾雜一些個人對于python 、SQLAlchemy 以及ORM的理解横媚,如有出錯部分底循,請指正我。
版本信息:
- SQLAlchemy 1.2.15
- Python 3.6+
- Mac OS 10.14
- DB基于SQLite
前序文章Python SQLAlchemy ORM教程(2)講了怎么在你的數(shù)據(jù)庫中查詢內(nèi)容廊驼,但是有些查詢往往不盡然人意,或者效率低下惋砂。這個章節(jié)蔬充,我們主要來講下,SQLAlchemy為你提供的快捷查詢接口和高度自由化的復(fù)雜查詢
Returning Lists and Saclars
在Query
對象中提供了一些方法幫你快速整理已經(jīng)被加載的數(shù)據(jù)班利。需要明確的知道
>>> query = session.query(User).filter(User.name.like('%ed')).order_by(User.id)
返回的是對象而不是我們平常認(rèn)知的list
饥漫。盡管query
對象可以迭代但是不代表他是list
,list
是一個可迭代對象但是不是迭代器罗标,而query
對象是一個迭代器庸队。關(guān)于迭代器和迭代對象的區(qū)別,我覺得一張圖可以表達(dá)清楚闯割,不再細(xì)講
我們看下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()
會獲取所有的數(shù)據(jù)彻消,然后看是不是只有一個數(shù)據(jù),如果有多于一個數(shù)據(jù)宙拉,將會返回MultipleResultsFound
這個錯誤:
>>> user = query.one()
Traceback (most recent call last):
...
MultipleResultsFound: Multiple rows were found for one()
如果沒有任何數(shù)據(jù)宾尚,則會返回NoResultFound
這個錯誤:
>>> user = query.filter(User.id == 99).one()
Traceback (most recent call last):
...
NoResultFound: No row was found for one()
這個one()
可以在你設(shè)計RESTful的時候提供高效的解決方式,比如當(dāng)你NoResultFound
的時候你可以直接返回404
當(dāng)有多個結(jié)果被找到的時候你可以返回application error
來防止用戶獲取他不改獲取的數(shù)據(jù),比如當(dāng)用戶請求自己主頁數(shù)據(jù)的時候煌贴,應(yīng)該有且僅有一行數(shù)據(jù)御板,當(dāng)返回了多行數(shù)據(jù)的時候,就可以知道牛郑,程序員又寫bug了怠肋,使用one()
可以有效防止這種情況發(fā)生。
題外話:one_or_none()
這個函數(shù)跟one()
很像淹朋,但是one_or_none()
并不會報錯而是直接返回None
笙各,但是當(dāng)數(shù)據(jù)多于一行的時候one_or_none()
和one()
一樣會報錯。
scalar()
會調(diào)用one()
础芍,他會返回一行數(shù)據(jù)
>>> 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
我不準(zhǔn)備翻譯官方的這個章節(jié)杈抢,因為我覺得作為新手來說,這個章節(jié)的自由度很高仑性,但是操作難度也比較高春感,需要一定的數(shù)據(jù)庫知識,如果有需要翻譯的虏缸,麻煩在下面留言哦
Counting
計算數(shù)據(jù)數(shù)量,算是最普遍的需求了吧嫩实,SQLAlchemy肯定會提供這個方法的刽辙,這個方法叫做count()
它是query
對象中的一個方法
>>> session.query(User).filter(User.name.like('%ed')).count()
2
func
從SQL
角度來說上面的count()
僅僅是進(jìn)行了最簡單的數(shù)量統(tǒng)計,等價于SELECT count(*) FROM table
甲献。程序員的要求各種各樣宰缤,作為一個現(xiàn)代的ORM工具,SQLAlchemy提供了更為精細(xì)化的查詢晃洒,這個查詢需要使用 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根據(jù)你的要求查詢了有User.name的數(shù)量
>>> 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
查詢的表達(dá)方式,如下
>>> session.query(func.count('*')).select_from(User).scalar()
4
下一個章節(jié)將會將關(guān)于數(shù)據(jù)庫關(guān)系的建立