一、什么是 PyMySQL？
PyMySQL 是在 Python3.x 版本中用于连接 MySQL 服务器的一个库。可以用它来连接Python和MySQL。如果你追求速度，这是一个很好的选择，因为它比mysql-connector-python快。
PyMySQL 遵循 Python 数据库 API v2.0 规范，并包含了 pure-Python MySQL 客户端库。
二、PyMySQL 安装
在使用 PyMySQL 之前，我们需要确保 PyMySQL 已安装。
pip install PyMySQL
三、数据库连接
# coding=utf-8
import pymysql
conn = pymysql.connect(
host="127.0.0.1", # 数据库主机地址
user="root", # 数据库用户名
passwd="root", # 数据库密码
database="python_demo" # 指定数据库
)
# 使用 cursor() 方法创建一个游标对象 cursor
cursor = conn.cursor()
# 使用 execute() 方法执行 SQL 查询
cursor.execute("SELECT VERSION()")
# 使用 fetchone() 方法获取单条数据.
data = cursor.fetchone()
print("Database version : %s " % data)
# 关闭数据库连接
conn.close()
Database version : 8.0.20 四、创建数据库表
使用execute()方法来为数据库创建表，如下所示创建表student：
# coding=utf-8
import pymysql
conn = pymysql.connect(
host="127.0.0.1", # 数据库主机地址
user="root", # 数据库用户名
passwd="root", # 数据库密码
database="python_demo" # 指定数据库
)
# 使用 cursor() 方法创建一个游标对象 cursor
cursor = conn.cursor()
# 使用 execute() 方法执行 SQL，如果表存在则删除
cursor.execute("DROP TABLE IF EXISTS student")
# 使用预处理语句创建表
sql = """CREATE TABLE student (
id int(11) primary key not null auto_increment,
first_name VARCHAR(20) NOT NULL,
last_name VARCHAR(20),
age int,
sex VARCHAR(2))"""
cursor.execute(sql)
# 关闭数据库连接
conn.close()
五、数据库插入操作
使用执行 SQL INSERT 语句向表 studnet 插入记录：
# coding=utf-8
import pymysql
conn = pymysql.connect(
host="127.0.0.1", # 数据库主机地址
user="root", # 数据库用户名
passwd="root", # 数据库密码
database="python_demo" # 指定数据库
)
# 使用 cursor() 方法创建一个游标对象 cursor
cursor = conn.cursor()
# SQL 插入语句
sql = """INSERT INTO student(first_name,
last_name, age, sex)
VALUES ('Li', 'Lei', 20, '男')"""
try:
# 执行sql语句
cursor.execute(sql)
# 提交到数据库执行
conn.commit()
except:
# 如果发生错误则回滚
conn.rollback()
# 关闭数据库连接
conn.close()
以上例子也可以写成如下形式：
# coding=utf-8
import pymysql
conn = pymysql.connect(
host="127.0.0.1", # 数据库主机地址
user="root", # 数据库用户名
passwd="root", # 数据库密码
database="python_demo" # 指定数据库
)
# 使用 cursor() 方法创建一个游标对象 cursor
cursor = conn.cursor()
# SQL 插入语句
sql = "INSERT INTO student(first_name,last_name, age, sex) \
VALUES ('%s', '%s', %s, '%s')" % \
('Zhang', 'Fei', 80, '男')
try:
# 执行sql语句
cursor.execute(sql)
# 提交到数据库执行
conn.commit()
except:
# 如果发生错误则回滚
conn.rollback()
# 关闭数据库连接
conn.close()
六、数据库查询操作
Python查询Mysql使用 fetchone() 方法获取单条数据, 使用fetchall() 方法获取多条数据。
fetchone(): 该方法获取下一个查询结果集。结果集是一个对象
fetchall(): 接收全部的返回结果行.
rowcount: 这是一个只读属性，并返回执行execute()方法后影响的行数。
# coding=utf-8
import pymysql
conn = pymysql.connect(
host="127.0.0.1", # 数据库主机地址
user="root", # 数据库用户名
passwd="root", # 数据库密码
database="python_demo" # 指定数据库
)
# 使用 cursor() 方法创建一个游标对象 cursor
cursor = conn.cursor()
# SQL 插入语句
sql = "INSERT INTO student(first_name,last_name, age, sex) \
VALUES ('%s', '%s', %s, '%s')" % \
('Zhang', 'Fei', 80, '男')
sql = "SELECT * FROM student \
WHERE age > %s" % (18)
try:
# 执行SQL语句
cursor.execute(sql)
# 获取所有记录列表
results = cursor.fetchall()
for row in results:
id = row[0]
firstName = row[1]
lastName = row[2]
age = row[3]
sex = row[4]
# 打印结果
print("id=%s,firstName=%s,lastName=%s,age=%s,sex=%s" % \
(id,firstName, lastName, age, sex))
except:
print("Error: unable to fetch data")
# 关闭数据库连接
conn.close()
id=1,firstName=Li,lastName=Lei,age=20,sex=男
id=2,firstName=Zhang,lastName=Fei,age=80,sex=男七、数据库更新操作
更新数据表的数据，以下实例将 user 表中 name 为 'Lucy' 的 mobile 字段改成13883838438：
# coding=utf-8
import pymysql
conn = pymysql.connect(
host="127.0.0.1", # 数据库主机地址
user="root", # 数据库用户名
passwd="root", # 数据库密码
database="python_demo" # 指定数据库
)
# 使用 cursor() 方法创建一个游标对象 cursor
cursor = conn.cursor()
# SQL 更新语句
sql = "update user set %s='%s' where name='%s'" % ('mobile', '13883838438', 'Lucy')
try:
# 执行SQL语句
cursor.execute(sql)
# 提交到数据库执行
conn.commit()
except:
# 发生错误时回滚
conn.rollback()
# 关闭数据库连接
conn.close()
八、删除操作
删除数据表中的数据，以下实例演示了删除数据表 student 中 age 大于 30 的所有数据：
# coding=utf-8
import pymysql
conn = pymysql.connect(
host="127.0.0.1", # 数据库主机地址
user="root", # 数据库用户名
passwd="root", # 数据库密码
database="python_demo" # 指定数据库
)
# 使用 cursor() 方法创建一个游标对象 cursor
cursor = conn.cursor()
# SQL 更新语句
sql = "DELETE FROM student WHERE age > %s" % (30)
try:
# 执行SQL语句
cursor.execute(sql)
# 提交到数据库执行
conn.commit()
except:
# 发生错误时回滚
conn.rollback()
# 关闭数据库连接
conn.close()
九、执行事务
事务机制可以确保数据一致性。
事务应该具有4个属性：原子性、一致性、隔离性、持久性。这四个属性通常称为ACID特性。
原子性（atomicity）。一个事务是一个不可分割的工作单位，事务中包括的诸操作要么都做，要么都不做。
一致性（consistency）。事务必须是使数据库从一个一致性状态变到另一个一致性状态。一致性与原子性是密切相关的。
隔离性（isolation）。一个事务的执行不能被其他事务干扰。即一个事务内部的操作及使用的数据对并发的其他事务是隔离的，并发执行的各个事务之间不能互相干扰。
持久性（durability）。持续性也称永久性（permanence），指一个事务一旦提交，它对数据库中数据的改变就应该是永久性的。接下来的其他操作或故障不应该对其有任何影响。
Python DB API 2.0 的事务提供了两个方法 commit 或 rollback。
对于支持事务的数据库， 在Python数据库编程中，当游标建立之时，就自动开始了一个隐形的数据库事务。
commit()方法游标的所有更新操作，rollback（）方法回滚当前游标的所有操作。每一个方法都开始了一个新的事务。
十、错误处理
DB API中定义了一些数据库操作的错误及异常，下表列出了这些错误和异常:
异常 | 描述 |
Warning | 当有严重警告时触发，例如插入数据是被截断等等。必须是 StandardError 的子类。 |
Error | 警告以外所有其他错误类。必须是 StandardError 的子类。 |
InterfaceError | 当有数据库接口模块本身的错误（而不是数据库的错误）发生时触发。 必须是Error的子类。 |
DatabaseError | 和数据库有关的错误发生时触发。 必须是Error的子类。 |
DataError | 当有数据处理时的错误发生时触发，例如：除零错误，数据超范围等等。 必须是DatabaseError的子类。 |
OperationalError | 指非用户控制的，而是操作数据库时发生的错误。例如：连接意外断开、 数据库名未找到、事务处理失败、内存分配错误等等操作数据库是发生的错误。 必须是DatabaseError的子类。 |
IntegrityError | 完整性相关的错误，例如外键检查失败等。必须是DatabaseError子类。 |
InternalError | 数据库的内部错误，例如游标（cursor）失效了、事务同步失败等等。 必须是DatabaseError子类。 |
ProgrammingError | 程序错误，例如数据表（table）没找到或已存在、SQL语句语法错误、 参数数量错误等等。必须是DatabaseError的子类。 |
NotSupportedError | 不支持错误，指使用了数据库不支持的函数或API等。例如在连接对象上 使用.rollback()函数，然而数据库并不支持事务或者事务已关闭。 必须是DatabaseError的子类。 |
以下为异常的继承结构：
