python 模块 torndb

一、torndb概述

​ torndb是一个轻量级的基于MySQLdb封装的一个模块，其是tornado框架的一部分。其项目主页为：https://github.com/bdarnell/torndb 。从tornado3.0版本以后，其已经作为一个独立模块发行了。可以通过easy_install 或pip的方式直接安装。

二、连接与查询

1、创建连接

import torndbdb = torn
db.Connection("127.0.0.1:3306", "test", user="root", password="admin") 

​ 默认字符集UTF8，没必要在加上 charset = "utf8" 。另外需要注意的是其默认时区为time_zone='+0:00'，这个可以手动在连接的时候指定为东8区。

2、查询

​ 在MySQLdb中所有的操作都是通过execute执行的，而把TA封装之后的torndb，提供了3种，execute,get,query。execute的示例：

cre='create table blog(id int,content text)'
db.execute(cre)string='wawuee'
exe='insert into blog(id,content)values(%d,"%s")'%(1,string)
db.execute(exe)

​ execute包括创建表，插入表，删除表等等，另外其也单独封装了insert、insertmany、update、updatemany函数，同时除了一般的execute函数，其还有execute_lastrowid、execute_rowcount、executemany、executemany_lastrowid、executemany_rowcount函数。

query与get

​ 两个都是用于返回数据结果，不同的是query可以返回多条结果；get查询的结果为空时，返回None，返回多于一条结果时会报出一个异常，一般只用于只有一条结果返回的情况。

//query查询
>>>sql = 'SELECT * FROM test WHERE name = %s AND id < %s'
>>>db.query(sql, 'bbb', 11)
[{'date': None, 'id': 1L, 'name': u'bbb'}, {'date': None, 'id': 2L, 'name': u'bbb'}]

//get查询
>>>sql = 'SELECT * FROM test WHERE id = %s'
>>>db.get(sql, 2)
{'date': None, 'id': 2L, 'name': u'bbb'}

​ query查询时，结果为多行时为list列表，单行只为字典。

insert与insertmany

>>>sql = "INSERT INTO test (id,name,date) VALUES (%s,%s,%s)"
>>>db.insert(sql, 100, "aaa", '0000-01-01')
100L

​ insert的参数不支持列表或元组，如果想插入列表或元组的话可以用insertmany

#插入单行记录
sql = "INSERT INTO test (id,name,date) VALUES (%s,%s,%s)"
db.insertmany(sql,[[200,'bbb',None]])200L
#插入多行记录
db.insertmany(sql,[[300,'bbb',None],[400,'bbb',None]])400L
db.insertmany(sql,[(301,'bbb',None),(401,'bbb',None)])401L

​ 总结下，torndb对MySQLdb封装后，query,get返回是list,dict这些，非常方便，可以直接拿来用，这是TA的优点，而且是默认自动commit的，不用MySQLdb的手动commit，用起来很是简洁。更多用法可以参看：http://torndb.readthedocs.org/en/latest/