一、什么是 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的子类。