PyMySQL 是在 Python3.x 版本中用于连接 MySQL 服务器的一个库。可以用它来连接Python和MySQL。如果你追求速度,这是一个很好的选择,因为它比mysql-connector-python快。
PyMySQL 遵循 Python 数据库 API v2.0 规范,并包含了 pure-Python MySQL 客户端库。
在使用 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的子类。 |
以下为异常的继承结构: