Python的ORM框架SQLAlchemy
接口测试时,测试数据有多种方式来存放(比如yaml、excel、MySQL、甚至txt文件等等),使用哪种方式需要根据接口的实际情况(请求数据量大小)来决定。当然也可以写死在代码里,不过从可维护性的角度来看这显然是一个糟糕的做法。还有另外一个场景,大多数情况下,POST或PUT接口会向业务数据库(MySOL)中插入数据,如果想进一步增强接口校验的可信度,除了对返回的response body做校验之外,业务数据库中是否完成插入数据的动作也可以作为一个校验点。
无论是用MySOL来存放测试数据还是校验业务数据库(MySOL)中是否插入数据,都需要做到使用Python脚本完成MySQL的增删改查操作。MySQL操作有两种方式,第一种最直接的方式是用SQL语句拼接成字符串,然后执行SQL,这种方式同样面临维护性的问题(如果表名发生了变化,需要在引用表名的所有位置全部完成替换),同时大量SQL字符串的存在会使得代码看起来异常臃肿。第二种是使用ORM框架,ORM框架把MySOL表和Python的类一一对应,MySQL的增删改查操作对应类中的各个方法,这大大降低了维护难度。
Python中,SQLAlchemy是最有名的ORM框架之一。
安装
pip3 install sqlalchemy
SQLAlchemy架构:
Schema / Types 架构和类型
SQL Expression Language 封装好的 SQL 语句
Engine 框架引擎
Connection Pooling 数据库连接池
Dialect 根据用户的配置,调用不同的数据库 API(Oracle, postgresql, Mysql) 并执行对应的 SQL语句
SQLAlchemy本身无法操作数据库,其必须依赖pymsql等第三方插件,从而实现对数据库的操作,如:
pymysql
mysql+pymysql://<username>:<password>@<host>/<dbname>[?<options>]
如果和我一样用的是Python3,需要先确保pymysql已经安装。
SQLAlchemy操作数据表CURD
直接上代码
创建数据表(model.py):
from sqlalchemy import create_engine
from sqlalchemy.ext.declarative import declarative_base
from sqlalchemy import Column, Integer, String
from sqlalchemy.orm import sessionmaker
# 创建对象的基类
Base = declarative_base()
# 初始化数据库连接
engine = create_engine('mysql+pymysql://root:root@localhost/0501_db',
echo=True, # 程序运行时反馈执行过程中的关键对象,包括ORM构建的sql语句
max_overflow=0, # 超过连接池大小外最多创建的连接
pool_size=5, # 连接池大小
pool_timeout=30, # 池中没有线程最多等待的时间,否则报错
pool_recycle=-1 # 多久之后对线程池中的线程进行一次连接的回收(重置)
)
'''
创建数据表的映射类
'''
# 定义Users对象
class Users(Base):
# 表的名字
__tablename__ = 'users'
# 表的结构
id = Column(Integer, primary_key=True)
age = Column(String(3))
name = Column(String(20))
# 定义Cat对象
class Cat(Base):
__tablename__ = 'cat'
id = Column(Integer, primary_key=True)
name = Column(String(20))
color = Column(String(20))
# 创建表到数据库表中
Base.metadata.create_all(engine)
declarative_base()是sqlalchemy内部封装的一个方法,Base作为所有映射类的父类,将在子类中把声明式映射过程作用于其子类。
从上面的代码不难总结出:
一个类对应数据库中的一张表,类的数据属性对应了表中的字段名,这个类称为映射类。
根据映射类创建出一个个的对象,每个对象对应了表中的一条实际的数据。
图形化语言:
执行代码,终端查看数据表:
有了数据表,怎么去操作呢?根据上面所说“根据映射类创建出一个个的对象,每个对象对应了表中的一条实际的数据”,创建一个对象就可以了吗?比如这样:
user_1 = Users(age='18', name='yangge')
当然是不可以的,此时,user_1对象只是在此刻环境的内存中有效,并没有在表中真正生成数据。
要想生成数据到表中,需要创建一个和数据库沟通的会话对象,利用这个会话对象对数据库中的表进行CURD操作。
from sqlalchemy.orm import sessionmaker
# 把当前的引擎绑定给这个会话
DBSession = sessionmaker(bind=engine)
# 添加
# 创建Session对象
session = DBSession()
# 创建User对象
user_1 = Users(age='18', name='zhangwu')
user_2 = Users(age='19', name='zhangliu')
user_3 = Users(age='20', name='zhangjiu')
# 添加到session
# session.add(user_1)
session.add_all([user_1, user_2, user_3])
# 提交
session.commit()
# 关闭session
session.close()
执行代码,终端查看数据表:
查询:
# 创建session
session = DBSession()
# 利用session创建查询,query(对象类).filter(条件).one()/all()
# one()返回一个记录,all()返回所有符合条件的记录列表
user = session.query(Users).filter(Users.id == '2').one()
user_list = session.query(Users).all()
print('type:{0}'.format(type(user)))
print('name:{0}'.format(user.name))
print('type:{0}'.format(type(user_list)))
print('name:{0}'.format(user_list[2].name))
# 关闭session
session.close()
控制台输出:
更新&删除:
# 更新
session = DBSession()
user_result = session.query(Users).filter_by(id='2').first()
user_result.name = "lishi"
session.commit()
session.close()
# 删除
session = DBSession()
user_del = session.query(Users).filter_by(id='1').first()
session.delete(user_del)
session.commit()
session.close()
由于关系型数据库的多个表还可以用外键实现一对多、多对多等关联,相应地,作为ORM框架的SQLAlchemy也支持多表的CURD。
源码: