Python的SQLAlchemy框架使用入门


Posted in Python onApril 29, 2015

数据库表是一个二维表,包含多行多列。把一个表的内容用Python的数据结构表示出来的话,可以用一个list表示多行,list的每一个元素是tuple,表示一行记录,比如,包含id和name的user表:

[
  ('1', 'Michael'),
  ('2', 'Bob'),
  ('3', 'Adam')
]

Python的DB-API返回的数据结构就是像上面这样表示的。

但是用tuple表示一行很难看出表的结构。如果把一个tuple用class实例来表示,就可以更容易地看出表的结构来:

class User(object):
  def __init__(self, id, name):
    self.id = id
    self.name = name

[
  User('1', 'Michael'),
  User('2', 'Bob'),
  User('3', 'Adam')
]

这就是传说中的ORM技术:Object-Relational Mapping,把关系数据库的表结构映射到对象上。是不是很简单?

但是由谁来做这个转换呢?所以ORM框架应运而生。

在Python中,最有名的ORM框架是SQLAlchemy。我们来看看SQLAlchemy的用法。

首先通过easy_install或者pip安装SQLAlchemy:

$ easy_install sqlalchemy

然后,利用上次我们在MySQL的test数据库中创建的user表,用SQLAlchemy来试试:

第一步,导入SQLAlchemy,并初始化DBSession:

# 导入:
from sqlalchemy import Column, String, create_engine
from sqlalchemy.orm import sessionmaker
from sqlalchemy.ext.declarative import declarative_base

# 创建对象的基类:
Base = declarative_base()

# 定义User对象:
class User(Base):
  # 表的名字:
  __tablename__ = 'user'

  # 表的结构:
  id = Column(String(20), primary_key=True)
  name = Column(String(20))

# 初始化数据库连接:
engine = create_engine('mysql+mysqlconnector://root:password@localhost:3306/test')
# 创建DBSession类型:
DBSession = sessionmaker(bind=engine)

以上代码完成SQLAlchemy的初始化和具体每个表的class定义。如果有多个表,就继续定义其他class,例如School:

class School(Base):
  __tablename__ = 'school'
  id = ...
  name = ...

create_engine()用来初始化数据库连接。SQLAlchemy用一个字符串表示连接信息:

'数据库类型+数据库驱动名称://用户名:口令@机器地址:端口号/数据库名'

你只需要根据需要替换掉用户名、口令等信息即可。

下面,我们看看如何向数据库表中添加一行记录。

由于有了ORM,我们向数据库表中添加一行记录,可以视为添加一个User对象:

# 创建session对象:
session = DBSession()
# 创建新User对象:
new_user = User(id='5', name='Bob')
# 添加到session:
session.add(new_user)
# 提交即保存到数据库:
session.commit()
# 关闭session:
session.close()

可见,关键是获取session,然后把对象添加到session,最后提交并关闭。Session对象可视为当前数据库连接。

如何从数据库表中查询数据呢?有了ORM,查询出来的可以不再是tuple,而是User对象。SQLAlchemy提供的查询接口如下:

# 创建Session:
session = DBSession()
# 创建Query查询,filter是where条件,最后调用one()返回唯一行,如果调用all()则返回所有行:
user = session.query(User).filter(User.id=='5').one()
# 打印类型和对象的name属性:
print 'type:', type(user)
print 'name:', user.name
# 关闭Session:
session.close()

运行结果如下:

type: <class '__main__.User'>
name: Bob

可见,ORM就是把数据库表的行与相应的对象建立关联,互相转换。

由于关系数据库的多个表还可以用外键实现一对多、多对多等关联,相应地,ORM框架也可以提供两个对象之间的一对多、多对多等功能。

例如,如果一个User拥有多个Book,就可以定义一对多关系如下:

class User(Base):
  __tablename__ = 'user'

  id = Column(String(20), primary_key=True)
  name = Column(String(20))
  # 一对多:
  books = relationship('Book')

class Book(Base):
  __tablename__ = 'book'

  id = Column(String(20), primary_key=True)
  name = Column(String(20))
  # “多”的一方的book表是通过外键关联到user表的:
  user_id = Column(String(20), ForeignKey('user.id'))

当我们查询一个User对象时,该对象的books属性将返回一个包含若干个Book对象的list。
小结

ORM框架的作用就是把数据库表的一行记录与一个对象互相做自动转换。

正确使用ORM的前提是了解关系数据库的原理。

Python 相关文章推荐
python实现批量转换文件编码(批转换编码示例)
Jan 23 Python
python统计cpu利用率的方法
Jun 02 Python
python 实现tar文件压缩解压的实例详解
Aug 20 Python
解决python 输出是省略号的问题
Apr 19 Python
python中logging模块的一些简单用法的使用
Feb 22 Python
Python配置虚拟环境图文步骤
May 20 Python
Python BeautifulSoup [解决方法] TypeError: list indices must be integers or slices, not str
Aug 07 Python
Pytorch修改ResNet模型全连接层进行直接训练实例
Sep 10 Python
利用pytorch实现对CIFAR-10数据集的分类
Jan 14 Python
python with语句的原理与用法详解
Mar 30 Python
利用python中的matplotlib打印混淆矩阵实例
Jun 16 Python
python中K-means算法基础知识点
Jan 25 Python
python使用post提交数据到远程url的方法
Apr 29 #Python
python实现根据ip地址反向查找主机名称的方法
Apr 29 #Python
连接Python程序与MySQL的教程
Apr 29 #Python
python实现通过代理服务器访问远程url的方法
Apr 29 #Python
python实现带错误处理功能的远程文件读取方法
Apr 29 #Python
python使用socket远程连接错误处理方法
Apr 29 #Python
python使用socket连接远程服务器的方法
Apr 29 #Python
You might like
PHP程序员最常犯的11个MySQL错误小结
2010/11/20 PHP
在云虚拟主机部署thinkphp5项目的步骤详解
2017/12/21 PHP
基于jQuery实现图片的前进与后退功能
2013/04/24 Javascript
jquery实现的一个导航滚动效果具体代码
2013/05/27 Javascript
仿当当网淘宝网等主流电子商务网站商品分类导航菜单
2013/09/25 Javascript
Javascript自定义函数判断网站访问类型是PC还是移动终端
2014/01/10 Javascript
jquery获取tagName再进行判断
2014/05/29 Javascript
jQuery css() 方法动态修改CSS属性
2016/09/25 Javascript
Angular.js中用ng-repeat-start实现自定义显示
2016/10/18 Javascript
使用jquery的jsonp如何发起跨域请求及其原理详解
2017/08/17 jQuery
Angular实现可删除并计算总金额的购物车功能示例
2017/12/26 Javascript
Node.js之readline模块的使用详解
2019/03/25 Javascript
JavaScript使用百度ECharts插件绘制饼图操作示例
2019/11/26 Javascript
package.json各个属性说明详解
2020/03/11 Javascript
vue中解决chrome浏览器自动播放音频和MP3语音打包到线上的实现方法
2020/10/09 Javascript
js用正则表达式筛选年月日的实例方法
2021/01/04 Javascript
[38:42]完美世界DOTA2联赛循环赛 Matador vs Forest BO2第二场 11.05
2020/11/05 DOTA
用Python制作简单的朴素基数估计器的教程
2015/04/01 Python
Python中几个比较常见的名词解释
2015/07/04 Python
Python实现的生产者、消费者问题完整实例
2018/05/30 Python
Python中分支语句与循环语句实例详解
2018/09/13 Python
使用python的turtle函数绘制一个滑稽表情
2020/02/28 Python
python Matplotlib数据可视化(1):简单入门
2020/09/30 Python
Lungolivigno Fashion官网:高级时装在线购物
2020/10/17 全球购物
主持人演讲稿范文
2013/12/28 职场文书
大学生职业生涯规划书范文
2014/01/14 职场文书
中学生差生评语
2014/01/30 职场文书
企业标语大全
2014/07/01 职场文书
八项规定个人对照检查材料思想汇报
2014/09/25 职场文书
2014年银行个人工作总结
2014/12/05 职场文书
公司奖励通知
2015/04/21 职场文书
Django项目如何获得SSL证书与配置HTTPS
2021/04/30 Python
如何设计高效合理的MySQL查询语句
2021/05/26 MySQL
浅谈Python3中datetime不同时区转换介绍与踩坑
2021/08/02 Python
vue实现移动端div拖动效果
2022/03/03 Vue.js
python如何读取和存储dict()与.json格式文件
2022/06/25 Python