python版本 >=2.6或3.3
mysql版本>=4.1
安装
可以使用pip安装也可以手动下载安装。
使用pip安装，在命令行执行如下命令：
|
1
|
pip install PyMySQL
|
手动安装，请先下载。下载地址：https://github.com/PyMySQL/PyMySQL/tarball/pymysql-X.X。
其中的X.X是版本（目前可以获取的最新版本是0.6.6）。
下载后解压压缩包。在命令行中进入解压后的目录，执行如下的指令：
|
1
|
python setup.py install
|
建议使用pip安装。
使用示例
连接数据库如下：
|
1
2
3
4
5
6
7
8
9
10
|
import pymysql.cursors
# Connect to the database
connection = pymysql.connect(host=‘127.0.0.1‘,
port=3306,
user=‘root‘,
password=‘zhyea.com‘,
db=‘employees‘,
charset=‘utf8mb4‘,
cursorclass=pymysql.cursors.DictCursor)
|
也可以使用字典进行连接参数的管理，我觉得这样子更优雅一些：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
import pymysql.cursors
config = {
‘host‘:‘127.0.0.1‘,
‘port‘:3306,
‘user‘:‘root‘,
‘password‘:‘zhyea.com‘,
‘db‘:‘employees‘,
‘charset‘:‘utf8mb4‘,
‘cursorclass‘:pymysql.cursors.DictCursor,
}
# Connect to the database
connection = pymysql.connect(**config)
|
插入数据：
执行sql语句前需要获取cursor，因为配置默认自动提交，故在执行sql语句后需要主动commit，最后不要忘记关闭连接：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
from datetime import date, datetime, timedelta
import pymysql.cursors
#连接配置信息
config = {
‘host‘:‘127.0.0.1‘,
‘port‘:3306,
‘user‘:‘root‘,
‘password‘:‘zhyea.com‘,
‘db‘:‘employees‘,
‘charset‘:‘utf8mb4‘,
‘cursorclass‘:pymysql.cursors.DictCursor,
}
# 创建连接
connection = pymysql.connect(**config)
# 获取明天的时间
tomorrow = datetime.now().date() + timedelta(days=1)
# 执行sql语句
try:
with connection.cursor() as cursor:
# 执行sql语句，插入记录
sql = ‘INSERT INTO employees (first_name, last_name, hire_date, gender, birth_date) VALUES (%s, %s, %s, %s, %s)‘
cursor.execute(sql, (‘Robin‘, ‘Zhyea‘, tomorrow, ‘M‘, date(1989, 6, 14)));
# 没有设置默认自动提交，需要主动提交，以保存所执行的语句
connection.commit()
finally:
connection.close();
|
执行查询：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
|
import datetime
import pymysql.cursors
#连接配置信息
config = {
‘host‘:‘127.0.0.1‘,
‘port‘:3306,
‘user‘:‘root‘,
‘password‘:‘zhyea.com‘,
‘db‘:‘employees‘,
‘charset‘:‘utf8mb4‘,
‘cursorclass‘:pymysql.cursors.DictCursor,
}
# 创建连接
connection = pymysql.connect(**config)
# 获取雇佣日期
hire_start = datetime.date(1999, 1, 1)
hire_end = datetime.date(2016, 12, 31)
# 执行sql语句
try:
with connection.cursor() as cursor:
# 执行sql语句，进行查询
sql = ‘SELECT first_name, last_name, hire_date FROM employees WHERE hire_date BETWEEN %s AND %s‘
cursor.execute(sql, (hire_start, hire_end))
# 获取查询结果
result = cursor.fetchone()
print(result)
# 没有设置默认自动提交，需要主动提交，以保存所执行的语句
connection.commit()
finally:
connection.close();
|
这里的查询支取了一条查询结果，查询结果以字典的形式返回：
从结果集中获取指定数目的记录，可以使用fetchmany方法：
|
1
|
result = cursor.fetchmany(2)
|
不过不建议这样使用，最好在sql语句中设置查询的记录总数。
获取全部结果集可以使用fetchall方法：
|
1
|
result = cursor.fetchall()
|
因为只有两条记录，所以上面提到的这两种查询方式查到的结果是一样的：
|
1
|
[{‘last_name‘: ‘Vanderkelen‘, ‘hire_date‘: datetime.date(2015, 8, 12), ‘first_name‘: ‘Geert‘}, {‘last_name‘:‘Zhyea‘, ‘hire_date‘: datetime.date(2015, 8, 21), ‘first_name‘: ‘Robin‘}]
|
在django中使用
在django中使用是我找这个的最初目的。目前同时支持python3.4、django1.8的数据库backend并不好找。这个是我目前找到的最好用的。
设置DATABASES和官方推荐使用的MySQLdb的设置没什么区别：
|
1
2
3
4
5
6
7
8
9
10
|
DATABASES = {
‘default‘: {
‘ENGINE‘: ‘django.db.backends.mysql‘,
‘NAME‘: ‘mytest‘,
‘USER‘: ‘root‘,
‘PASSWORD‘: ‘zhyea.com‘,
‘HOST‘: ‘127.0.0.1‘,
‘PORT‘: ‘3306‘,
}
}
|
关键是这里：我们还需要在站点的__init__.py文件中添加如下的内容：
|
1
2
|
import pymysql
pymysql.install_as_MySQLdb()
|