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中的类与对象之描述符详解
Mar 27 Python
Python中的choice()方法使用详解
May 15 Python
详解Python中映射类型的内建函数和工厂函数
Aug 19 Python
Python做简单的字符串匹配详解
Mar 21 Python
Django 视图层(view)的使用
Nov 09 Python
Python定时任务随机时间执行的实现方法
Aug 14 Python
pytorch中tensor.expand()和tensor.expand_as()函数详解
Dec 27 Python
使用Python发现隐藏的wifi
Mar 04 Python
PyQt5 控件字体样式等设置的实现
May 13 Python
Pygame Rect区域位置的使用(图文)
Nov 17 Python
Python OpenCV之常用滤波器使用详解
Apr 07 Python
如何使用python包中的sched事件调度器
Apr 30 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函数
2006/10/09 PHP
PHP 遍历XP文件夹下所有文件
2008/11/27 PHP
php读取msn上的用户信息类
2008/12/05 PHP
详解WordPress中调用评论模板和循环输出评论的PHP函数
2016/01/05 PHP
yii2高级应用之自定义组件实现全局使用图片上传功能的方法
2016/10/08 PHP
php 计算两个时间相差的天数、小时数、分钟数、秒数详解及实例代码
2016/11/09 PHP
PHP实现无限极分类的两种方式示例【递归和引用方式】
2019/03/25 PHP
laravel 解决ajax异步提交数据,并还回填充表格的问题
2019/10/15 PHP
javascript不同页面传值的改进版
2008/09/30 Javascript
jQuery EasyUI API 中文文档 可调整尺寸
2011/09/29 Javascript
jQuery实现动画效果的实例代码
2013/05/07 Javascript
解析JavaScript中的标签语句
2013/06/19 Javascript
jquery使用ul模拟select实现表单美化的方法
2015/08/18 Javascript
老生常谈javascript变量的命名规范和注释
2016/09/29 Javascript
js给table赋值的实例代码
2016/10/13 Javascript
jQuery菜单实例(全选,反选,取消)
2017/08/28 jQuery
vue-cli系列之vue-cli-service整体架构浅析
2019/01/14 Javascript
详解一个基于套接字实现长连接的express
2019/03/28 Javascript
vue实现文字横向无缝走马灯组件效果的实例代码
2019/04/09 Javascript
解决layui数据表格table的横向滚动条显示问题
2019/09/04 Javascript
[08:08]DOTA2-DPC中国联赛2月28日Recap集锦
2021/03/11 DOTA
python 如何快速找出两个电子表中数据的差异
2017/05/26 Python
Python探索之自定义实现线程池
2017/10/27 Python
阿里云ECS服务器部署django的方法
2019/08/29 Python
简单了解python filter、map、reduce的区别
2020/01/14 Python
Python图像处理库PIL的ImageFilter模块使用介绍
2020/02/26 Python
python matplotlib实现将图例放在图外
2020/04/17 Python
解决HTML5中的audio在手机端和微信端的不能自动播放问题
2019/11/04 HTML / CSS
教师个人鉴定材料
2014/02/08 职场文书
餐厅经理岗位职责范本
2014/02/17 职场文书
团干部培训方案
2014/06/03 职场文书
高中同学会致辞
2015/08/01 职场文书
责任书格式
2019/04/18 职场文书
22句经典语录:送给优柔寡断和胡思乱想的朋友们
2019/12/13 职场文书
如何在pycharm中快捷安装pip命令(如pygame)
2021/05/31 Python
MySQL高速缓存启动方法及参数详解(query_cache_size)
2021/07/01 MySQL