sql to sqlalchemy 實例教程

在Python項目中，常常須要操做數據庫，而 sqlalchemy 提供了 SQL 工具包及對象關係映射(ORM)工具，大大提升了編程開發的效率。爲了更好的提高本身的 sql 以及使用 sqlachemy 水平，可使用 MySQL 自帶的示範數據庫 employees 進行練習。

搭建基於 MySQL 實例數據庫 employees 的 sqlalchemy 開發環境

請參閱下面的連接內容：

搭建基於 MySQL 實例數據庫 employees 的 sqlalchemy 開發環境

基本實例

如下九個例子全是以代碼加註釋的形式來展現給你們。

# -*- coding:utf-8 -*-
__author__ = '東方鶚'
__blog__ = 'http://www.os373.cn'

from models import session, Employee, Department, DeptEmp, DeptManager, Salary, Title
import operator


'''----------------------------------------------第一例-----------------------------------------------
    功能說明：
    使用主鍵對 employees 表進行查詢，結果是： 返回該主鍵對應的單條數據！
'''

'''使用 sql 語句方式進行查詢'''
sql = "select * from employees where emp_no = 10006"
sql_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date) for d in session.execute(sql)]

'''使用 sqlalchemy 方式進行查詢'''
d = session.query(Employee).get(10006)
alchemy_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date)]

'''比較兩個結果，應該是True'''
for d in zip(sql_data, alchemy_data):
    print(d)
print('第一例結果是：{}'.format(operator.eq(sql_data, alchemy_data)))

'''-------------------------------------------------------------------------------------------------'''

'''-------------------------------------------第二例--------------------------------------------------
    功能說明：
    對 employees 表進行查詢，結果是：從第 4 行開始查詢，返回以後的 10 行數據！值爲一個列表。
'''

'''使用 sql 語句方式進行查詢'''
sql = "select * from employees limit 10 offset 4"
sql_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date) for d in session.execute(sql)]

'''使用 sqlalchemy 方式進行查詢'''
alchemy_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date)
                for d in session.query(Employee).limit(10).offset(4).all()]

'''比較兩個結果，應該是True'''
for d in zip(sql_data, alchemy_data):
    print(d)
print('第二例結果是：{}'.format(operator.eq(sql_data, alchemy_data)))

'''-------------------------------------------------------------------------------------------------'''

'''-------------------------------------------第三例--------------------------------------------------
    功能說明：
    使用一個精確參數對 employees 表進行查詢(搜索字段 last_name 爲 'Nooteboom' 的內容)，
    結果是： 返回該參數對應的第一條數據！僅僅是第一條數據！
'''

'''使用 sql 語句方式進行查詢'''
sql = "select * from employees where last_name = 'Nooteboom' limit 1"
sql_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date) for d in session.execute(sql)]

'''使用 sqlalchemy 方式進行查詢'''
d = session.query(Employee).filter_by(last_name='Nooteboom').first()
alchemy_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date)]

'''比較兩個結果，應該是True'''
for d in zip(sql_data, alchemy_data):
    print(d)
print('第三例結果是：{}'.format(operator.eq(sql_data, alchemy_data)))

'''-------------------------------------------------------------------------------------------------'''

'''-------------------------------------------第四例--------------------------------------------------
    功能說明：
    使用一個精確參數對 employees 表進行查詢(搜索字段 last_name 爲 'Nooteboom' 的內容)，
    結果是： 返回該參數對應的全部數據！全部數據！值爲一個列表。
'''

'''使用 sql 語句方式進行查詢'''
sql = "select * from employees where last_name = 'Nooteboom'"
sql_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date) for d in session.execute(sql)]

'''使用 sqlalchemy 方式進行查詢'''

'''方法一
alchemy_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date)
                for d in session.query(Employee).filter_by(last_name='Nooteboom').all()]
'''

'''方法二以下'''
alchemy_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date)
                for d in session.query(Employee.emp_no, Employee.birth_date, Employee.first_name,
                Employee.last_name, Employee.gender, Employee.hire_date
                ).filter_by(last_name='Nooteboom').all()]


'''比較兩個結果，應該是True'''
for d in zip(sql_data, alchemy_data):
    print(d)
print('第四例結果是：{}'.format(operator.eq(sql_data, alchemy_data)))

'''-------------------------------------------------------------------------------------------------'''

'''-------------------------------------------第五例--------------------------------------------------
    功能說明：
    使用兩個及以上的精確參數對 employees 表進行查詢(搜索字段 last_name 爲 'Nooteboom' 
    而且字段 first_name 爲 'Pohua' 的內容)，
    結果是： 返回參數對應的全部數據！全部數據！值爲一個列表。
'''

'''使用 sql 語句方式進行查詢'''
sql = "select * from employees where last_name = 'Nooteboom' and first_name = 'Pohua'"
sql_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date) for d in session.execute(sql)]

'''使用 sqlalchemy 方式進行查詢'''

'''方法一
alchemy_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date)
                for d in session.query(Employee).
                    filter_by(last_name='Nooteboom', first_name='Pohua').all()]
'''
'''方法二以下'''
alchemy_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date)
                for d in session.query(Employee).filter(Employee.last_name=='Nooteboom').
                    filter(Employee.first_name=='Pohua').all()]

'''比較兩個結果，應該是True'''
for d in zip(sql_data, alchemy_data):
    print(d)
print('第五例結果是：{}'.format(operator.eq(sql_data, alchemy_data)))

'''-------------------------------------------------------------------------------------------------'''

'''-------------------------------------------第六例--------------------------------------------------
    功能說明：
    使用一個模糊參數對 employees 表進行查詢，結果是： 返回該參數對應的全部數據！全部數據！值爲一個列表。
    提示：
        一、sqlalchemy 提供了 like, endswith, startswith 函數結合通配符來進行模糊查詢。
           對於 like, endswith, startswith ，見字如面，請按照英文字面意思理解。
        二、本例的重點是使用且僅一個模糊參數, 主要是爲了展現 like 函數。
'''

'''使用 sql 語句方式進行查詢'''
sql = "select * from employees where last_name like 'N%te_%'"
sql_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date) for d in session.execute(sql)]

'''使用 sqlalchemy 方式進行查詢'''

alchemy_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date)
                for d in session.query(Employee).filter(Employee.last_name.like('N%te_%')).all()]

'''比較兩個結果，應該是True'''
for d in zip(sql_data, alchemy_data):
    print(d)
print('第六例結果是：{}'.format(operator.eq(sql_data, alchemy_data)))

'''-------------------------------------------------------------------------------------------------'''

'''-------------------------------------------第七例--------------------------------------------------
    功能說明：
    使用兩個及以上模糊參數對 employees 表進行查詢，查詢字段 last_name 近似於 'N%te_%'，
    而且字段 first_name 在 ('Jaewon', 'os373.cn') 裏，同時，
    字段 birth_date 是以 1955 開頭，且字段 hire_date 是以 05-30 結束的員工信息。
    結果是： 返回參數對應的全部數據！全部數據！值爲一個列表。
    提示：
        一、sqlalchemy 提供了 like, endswith, startswith 函數結合通配符來進行模糊查詢。
           對於 like, endswith, startswith ，見字如面，請按照英文字面意思理解。
        二、本例的重點是展現 like, endswith, startswith 函數以及 and_, or_, in_ 邏輯運算符函數的用法。
    彩蛋：思考一下 not in， not equal，is NULL，is not NULL 的用法。
'''

'''使用 sql 語句方式進行查詢'''
sql = """
        SELECT
            *
        FROM
            employees
        WHERE
            last_name LIKE 'N%te_%'
        AND first_name IN ('Jaewon', 'os373.cn')
        AND birth_date LIKE '1955%'
        AND hire_date LIKE '%05-30'
"""
sql_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date) for d in session.execute(sql)]

'''使用 sqlalchemy 方式進行查詢'''
from sqlalchemy import and_, or_
alchemy_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date)
                for d in session.query(Employee).filter(and_(Employee.last_name.like('N%te_%'),
                                                             Employee.first_name.in_(['Jaewon','os373.cn']),
                                                             Employee.birth_date.startswith('1955'),
                                                             Employee.hire_date.endswith('05-30'))).all()]

'''比較兩個結果，應該是True'''
for d in zip(sql_data, alchemy_data):
    print(d)
print('第七例結果是：{}'.format(operator.eq(sql_data, alchemy_data)))

'''-------------------------------------------------------------------------------------------------'''

'''-------------------------------------------第八例--------------------------------------------------
    功能說明：
    使用兩個及以上模糊參數對 employees 表進行查詢，查詢字段 last_name 近似於 'N%te_%'，
    而且字段 first_name 在 ('Jaewon', 'os373.cn') 裏的員工信息，或者是，
    字段 birth_date 是以 1955 開頭，且字段 hire_date 是以 05-30 結束的員工信息的個數。
    結果是： 返回一個數字。
    提示：
        一、sqlalchemy 提供了 like, endswith, startswith 函數結合通配符來進行模糊查詢。
           對於 like, endswith, startswith ，見字如面，請按照英文字面意思理解。
        二、本例的重點是展現 like, endswith, startswith 函數以及 and_, or_, in_ 邏輯運算符函數的用法。
        三、func 函數能夠執行數據庫所支持的函數，本例中是爲了執行 MySQL 的 count 函數。
        四、scalar() 函數是爲了返回單項數據，與 first(), one() 函數相似，
           可是前者返回的是單項數據，後二者返回的是 tuple。
'''

'''使用 sql 語句方式進行查詢'''
sql = """
        SELECT
            count(*)
        FROM
            employees
        WHERE
            (
                last_name LIKE 'N%te_%'
                AND first_name IN ('Jaewon', 'os373.cn')
            )
        OR (
            birth_date LIKE '1955%'
            AND hire_date LIKE '%05-30'
        )
"""
sql_data = [d for d in session.execute(sql)][0][0]

'''使用 sqlalchemy 方式進行查詢'''
from sqlalchemy import and_, or_

'''方法一
alchemy_data = session.query(Employee).filter(or_(and_(Employee.last_name.like('N%te_%'),
                                                       Employee.first_name.in_(['Jaewon','os373.cn'])),
                                                  and_(Employee.birth_date.startswith('1955'),
                                                       Employee.hire_date.endswith('05-30')))).count()
                                                       '''

'''方法二'''
from sqlalchemy import func
alchemy_data = session.query(func.count("*")).filter(or_(and_(Employee.last_name.like('N%te_%'),
                                                       Employee.first_name.in_(['Jaewon','os373.cn'])),
                                                  and_(Employee.birth_date.startswith('1955'),
                                                       Employee.hire_date.endswith('05-30')))).scalar()

'''比較兩個結果，應該是True'''
print(sql_data, alchemy_data)
print('第八例結果是：{}'.format(operator.eq(sql_data, alchemy_data)))

'''-------------------------------------------------------------------------------------------------'''

'''-------------------------------------------第九例--------------------------------------------------
    功能說明：
    使用兩個及以上模糊參數對 employees 表進行查詢，查詢字段 last_name 近似於 'N%te_%'，
    而且字段 first_name 在 ('Jaewon', 'os373.cn') 裏的員工信息，或者是，
    字段 birth_date 是以 1955 開頭，且字段 hire_date 是以 05-30 結束的員工信息，
    並按照字段 last_name 進行排序。
    結果是： 返回參數對應的全部數據！全部數據！值爲一個列表。
    提示：
        一、因爲 MySQL 5.7 中的 sql_mode 設置有 only_full_group_by，所以要求 group by 的使用方法像 oracle 
        同樣，必須得把要查詢出的字段都羅列在 group by 語句以後，聚合函數除外。按照最靠前的字段來進行排序。
'''

'''使用 sql 語句方式進行查詢'''
sql = """
        SELECT
            *
        FROM
            employees
        WHERE
            (
                last_name LIKE 'N%te_%'
                AND first_name IN ('Jaewon', 'os373.cn')
            )
        OR (
            birth_date LIKE '1955%'
            AND hire_date LIKE '%05-30'
        )
        GROUP BY
            last_name,
            gender,
            hire_date,
            emp_no,
            birth_date,
            first_name 
"""
sql_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date) for d in session.execute(sql)]

'''使用 sqlalchemy 方式進行查詢'''
from sqlalchemy import and_, or_
alchemy_data = [(d.emp_no, d.birth_date, d.first_name, d.last_name, d.gender, d.hire_date)
                for d in session.query(Employee).filter(or_(and_(Employee.last_name.like('N%te_%'),
                                                             Employee.first_name.in_(['Jaewon','os373.cn'])),
                                                            and_(Employee.birth_date.startswith('1955'),
                                                                 Employee.hire_date.endswith('05-30')))).\
    group_by(Employee.last_name, Employee.gender, Employee.hire_date, Employee.emp_no,
             Employee.birth_date, Employee.first_name).all()]

'''比較兩個結果，應該是True'''
for d in zip(sql_data, alchemy_data):
    print(d)
print('第九例結果是：{}'.format(operator.eq(sql_data, alchemy_data)))

'''-------------------------------------------------------------------------------------------------'''
session.commit()
session.close()

其實，這是本人維護的一個 github 項目，歡迎你們可以提供有意思的 SQL 語句，咱們一塊兒來將它轉換爲 sqlalachemy 語句。
項目地址——https://eastossifrage.github.io/sql_to_sqlalchemy/

但願你可以喜歡。