一、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/
参考