Python ORM框架SQLAlchemy学习笔记之关系映射实例


Posted in Python onJune 10, 2014

昨天简单介绍了SQLAlchemy的使用,但是没有能够涉及其最精彩的ORM部分,今天我将简单说明一下,当然主要还是讲解官方文档的内容,由于是学习笔记,有可能存在精简或者自己理解的部分,不做权威依据。

当我们开始使用ORM,一种可配置的结构可以用于描述我们的数据库表,稍后我们定义的类将会被映射到这些表上。当然现代的SQLAlchemy(新版本SQLAlchemy,原文是modern SQLAlchemy)使用Declarative把这两件事一起做了,即允许我们把创建类和描述定义数据库表以及它们之间的映射关系一次搞定。

这段话是什么意思呢?简单来说吧,SQLAlchemy分为Classic (经典模式)和Modern (现代模式),Classic定义数据库表的模式比较传统,需要先描述这个表。

1. Classic 映射

比如以官方文档中的例子,我们拥有表结构如下:

CREATE TABLE [users] (
  [id]       INTEGER PRIMARY KEY,
  [name]     TEXT NOT NULL,
  [fullname] TEXT NOT NULL,
  [password] TEXT NOT NULL
);

下面我们描述这张表:

from sqlalchemy import Table, MetaData, Column, Integer, Stringmetadata = MetaData()
user = Table('users', metadata,
            Column('id', Integer, primary_key=True),
            Column('name', String(50)),
            Column('fullname', String(50)),
            Column('password', String(12))
        )

好,这样我们的表算是描述完成了,接下来我们需要定义我们的Python类,比如这样的:
class User(object):
    def __init__(self, name, fullname, password):
        self.name = name
        self.fullname = fullname
        self.password = password

如何让我们定义的类与之前描述的表结构发生映射关系就是我们接下来要做的:
from sqlalchemy.orm import mapper
mapper(User, user)

大家注意到mapper函数,第一个参数是我们类的名称,第二个参数是我们先前描述的表定义。

这就是传统的定义ORM的方法,有关这个方法的更多信息,可以阅读文档Mapper Configuration,以后有机会再和大家详谈。

2. Modern 映射

当大家都乐此不疲的定义描述表,定义类,再映射来实现ORM的时候,SQLAlchemy团队搞出了更简单的映射方法,那就是Modern模式了,即通过定义映射类来一次性完成所有任务。

为了定义的类能够被SQLAlchemy管理,所以引入了Declarative这个概念,也就是说我们所有的类必须是Declarative基类的子类,而这个基类可以通过下面的办法来获取:

from sqlalchemy.ext.declarative import declarative_base
Base = declarative_base()

当然一个程序内,这个基类最好是唯一的,建议存储在全局变量比如Base中供所有映射类使用。

现在通过刚才的代码我们得到了名为Base的基类,通过这个基类我们可以定义N多的映射子类,而这些子类都能被SQLAlchemy Declarative系统管理到。

下面我们还是看刚才的那个users表的例子:

from sqlalchemy import Column, Integer, String
class User(Base):
     __tablename__ = 'users'     id = Column(Integer, primary_key=True)
     name = Column(String)
     fullname = Column(String)
     password = Column(String)
     def __init__(self, name, fullname, password):
         self.name = name
         self.fullname = fullname
         self.password = password
     def __repr__(self):
        return "<User('%s','%s', '%s')>" % (self.name, self.fullname, self.password)

就这段代码就完成了我们先前在Classic中需要的三步,代码比原先更简洁和容易管理了,同刚才Classic中Table定义的Column,这个代表数据库表中的列,当然Integer和String代表着数据库表的字段类型了。

这样User类就建立起与数据库表的映射,真实表的名字可以使用__tablename__指明,然后是表列的集合,包括id、name、fullname以及password,当然想必大家已经知道了,我们通过primary_key=True已经指明id为主键了。当然一些数据库表可能不包含有主键(例如视图View,当然视图也可以被映射),ORM为了能够实际映射表需要至少一个列被定义为主键列。多列,比如复合多主键也能够被很好地映射支持。

大家可能注意到User类中还包含有通常意义上的Python魔术方法,包含__init__()初始化类(构造方法)以及__repr__()字符串化支持方法,当然这些都是可选的,如果需要这个类可以加入程序所需要的任意多方法或者属性,你只要把这个类看作一个普通的Python类就可以了。

当然User类唯一不能马虎的就是必须继承至Base,这个Base就是刚才我们通过declarative_base()生成的类,通过它我们可以接下来让SQLAlchemy Declarative系统管理并操作这些映射类和数据库表。

实际上包括继承的Base类,所有的类都应该是Python的新式类(new style class),关于新式类的更多信息可以参考Python手册。

随着我们的User映射类通过Declarative系统构造成功,我们就拥有了相关的定义信息,比如在Classic定义中介绍的Table()描述,也包含映射到表的类,就是User自身,我们可以通过User.__table__来查看我们的表描述情况:

>>> User.__table__ 
Table('users', MetaData(None),
    Column('id', Integer(), table=<users>, primary_key=True, nullable=False),
    Column('name', String(), table=<users>),
    Column('fullname', String(), table=<users>),
    Column('password', String(), table=<users>), schema=None)

当然找到描述表的数据结构,也应该能找到mapper,我们的Mapper对象可以通过__mapper__属性来获取,比如这样的:
>>> User.__mapper__ 
<Mapper at 0x...; User>

同样的MetaData可以通过.metadata属性找到。

好啦,下面轻松一下,见证奇迹的时刻,我们需不需要定义创建好实体数据库然后再定义ORM?对于SQLAlchemy来说这些都是小事一桩,其都可以给你一手包办,也就是说你可以完全不必理会数据库,交给SQLAlchemy就可以了,比如通过MetaData.create_all()并将engine参数传入即可(什么是engine?参考我的笔记1),比如通过下面的方式创建我们的users表。

>>> Base.metadata.create_all(engine) 
PRAGMA table_info("users")
()
CREATE TABLE users (
    id INTEGER NOT NULL,
    name VARCHAR,
    fullname VARCHAR,
    password VARCHAR,
    PRIMARY KEY (id)
)
()
COMMIT

由于我们开启了engine的echo=True,所以在交互命令下SQLAlchemy把SQL语句也输出了,正好可以检验是否符合我们的要求。

这样简单的create_all()我们就轻松建立起先前ORM映射定义的表啦。

时间不早了,今天先聊到这儿,下次再谈SQLAlchemy的其他特性。

Python 相关文章推荐
Python探索之创建二叉树
Oct 25 Python
浅谈python 里面的单下划线与双下划线的区别
Dec 01 Python
python人民币小写转大写辅助工具
Jun 20 Python
用pycharm开发django项目示例代码
Jun 13 Python
Python学习笔记之集合的概念和简单使用示例
Aug 22 Python
Python异步编程之协程任务的调度操作实例分析
Feb 01 Python
OpenCV中VideoCapture类的使用详解
Feb 14 Python
探秘TensorFlow 和 NumPy 的 Broadcasting 机制
Mar 13 Python
Django 拼接两个queryset 或是两个不可以相加的对象实例
Mar 28 Python
使用Keras中的ImageDataGenerator进行批次读图方式
Jun 17 Python
编译 pycaffe时报错:fatal error: numpy/arrayobject.h没有那个文件或目录
Nov 29 Python
通过Python把学姐照片做成拼图游戏
Feb 15 Python
Python ORM框架SQLAlchemy学习笔记之安装和简单查询实例
Jun 10 #Python
Python使用htpasswd实现基本认证授权的例子
Jun 10 #Python
python网络编程学习笔记(10):webpy框架
Jun 09 #Python
python网络编程学习笔记(九):数据库客户端 DB-API
Jun 09 #Python
python网络编程学习笔记(八):XML生成与解析(DOM、ElementTree)
Jun 09 #Python
python网络编程学习笔记(七):HTML和XHTML解析(HTMLParser、BeautifulSoup)
Jun 09 #Python
python网络编程学习笔记(六):Web客户端访问
Jun 09 #Python
You might like
php学习笔记 PHP面向对象的程序设计
2011/06/13 PHP
php堆排序(heapsort)练习
2013/11/13 PHP
PHP+jQuery翻板抽奖功能实现
2015/10/19 PHP
Zend Framework实现将session存储在memcache中的方法
2016/03/22 PHP
thinkPHP5分页功能实现方法分析
2017/10/25 PHP
基于JQuery的简单实现折叠菜单代码
2010/09/15 Javascript
纯js实现背景图片切换效果代码
2010/11/14 Javascript
仿猪八戒网左下角的文字滚动效果
2011/10/28 Javascript
浅谈JavaScript中的string拥有方法的原因
2015/08/28 Javascript
jQuery移动web开发之页面跳转和加载外部页面的实现
2015/12/04 Javascript
不得不分享的JavaScript常用方法函数集(上)
2015/12/23 Javascript
解决canvas画布使用fillRect()时高度出现双倍效果的问题
2017/08/03 Javascript
手把手教你使用vue-cli脚手架(图文解析)
2017/11/08 Javascript
react-router4 配合webpack require.ensure 实现异步加载的示例
2018/01/18 Javascript
纯JS实现的读取excel文件内容功能示例【支持所有浏览器】
2018/06/23 Javascript
使用Node.js写一个代码生成器的方法步骤
2019/05/10 Javascript
修改Vue打包后的默认文件名操作
2020/08/12 Javascript
前端使用crypto.js进行加密的函数代码
2020/08/16 Javascript
vue-cli3配置favicon.ico和title的流程
2020/10/27 Javascript
解决vant-UI库修改样式无效的问题
2020/11/03 Javascript
[02:05:03]完美世界DOTA2联赛循环赛 LBZS VS Matador BO2 10.28
2020/10/28 DOTA
Python操作Sql Server 2008数据库的方法详解
2018/05/17 Python
使用Python监控文件内容变化代码实例
2018/06/04 Python
对python中的乘法dot和对应分量相乘multiply详解
2018/11/14 Python
利用CSS3的transform做的动态时钟效果
2011/09/21 HTML / CSS
css3+伪元素实现鼠标移入时下划线向两边展开的效果
2017/04/25 HTML / CSS
css3实现六边形边框的实例代码
2019/05/24 HTML / CSS
POP文化和音乐灵感的时尚:Hot Topic
2019/06/19 全球购物
什么是聚集索引和非聚集索引
2012/01/17 面试题
网络工程师个人的自我评价范文
2013/10/01 职场文书
幼儿教师考核制度
2014/01/25 职场文书
音乐教育专业自荐信
2014/09/18 职场文书
五年级小学生评语
2014/12/26 职场文书
管理失职检讨书
2015/05/05 职场文书
周恩来的四个昼夜观后感
2015/06/03 职场文书
2015新教师教学工作总结
2015/07/22 职场文书