python torndb使用简介

一、torndb概述

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

二、连接与查询

1、创建连接

import torndb
db = torndb.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/