Python 3 使用 PyMySQL 连接 MySQL 数据库教程

洛溪

发布时间：2026-10-13 | 2人浏览过

原创

本文介绍在 Python 3 环境下使用 PyMySQL 模块连接 MySQL 数据库的方法。内容涵盖模块安装、数据库连接配置、以及利用游标执行查询、插入、修改和删除数据的具体代码示例，重点强调事务提交（commit）的必要性。

在 Python 2 时代，连接 MySQL 通常使用 MySQLdb 模块。随着升级到 Python 3.x，由于 MySQLdb 不再支持该版本，开发者需要改用 PyMySQL 模块来建立连接。下文将详细说明 PyMySQL 的安装步骤及其常用操作方法。

一、安装

pip install PyMySQL

二、常用操作

查询数据


import pymysql
# 连接数据库
conn = pymysql.connect(
  host='127.0.0.1',
  user='root',
  passwd='root',
  port=3306,
  db='test',
  charset='utf8'
)
# 创建一个游标
cursor = conn.cursor()
# 查询数据
sql = "select * from user"
cursor.execute(sql) # 执行sql
# 查询所有数据，返回结果默认以元组形式，所以可以进行迭代处理
for i in cursor.fetchall():
  print(i)
print('共查询到：', cursor.rowcount, '条数据。')
# 获取第一行数据
result_1 = cursor.fetchone()
print(result_1)
# 获取前n行数据
result_3 = cursor.fetchmany(3)
print(result_3)
cursor.close() # 关闭游标
conn.close() # 关闭连接

插入数据

执行插入语句后，必须调用 .commit() 提交事务方可生效。支持批量插入后统一提交，若遗漏提交步骤，数据写入将无效。


import pymysql
# 连接数据库
conn = pymysql.connect(
  host='127.0.0.1',
  user='root',
  passwd='root',
  port=3306,
  db='test',
  charset='utf8'
)
# 创建一个游标
cursor = conn.cursor()
# 插入数据
# 数据直接写在sql后面
sql = "insert into username(id,name) values(%s, %s)" # 注意是%s,不是s%
cursor.execute(sql, [3, '王五']) # 列表格式数据
cursor.execute(sql, (4, '马六')) # 元组格式数据
# 数据单独赋给一个对象
sql = "insert into username values(%s,%s)"
data = (5, '老七')
cursor.execute(sql, data) #sql和data之间以","隔开
sql = "insert into username values(%s,'%s')"
data = (6, '小八')
cursor.execute(sql % data) #sql和data之间以"%"隔开，此时它的sql中注意要给中文字符对应的占位符加上引号，即"%s",不然会报错：unsupported format character
conn.commit()  # 提交，不然无法保存插入或者修改的数据(这个一定不要忘记加上)
cursor.close() # 关闭游标
conn.close() # 关闭连接

修改数据

执行修改语句后，必须调用 .commit() 提交事务方可生效。支持批量修改后统一提交，若遗漏提交步骤，数据更新将无效。


import pymysql
# 连接数据库
conn = pymysql.connect(
  host='127.0.0.1',
  user='root',
  passwd='root',
  port=3306,
  db='test',
  charset='utf8'
)
# 创建一个游标
cursor = conn.cursor()
# 修改数据
sql = "update username set name='%s' where id=%s" #注意%s什么时候加引号，什么时候不加
data = ('改名了', 1)
cursor.execute(sql % data)
sql = "update username set name=%s where id=%s"
data = ('也改名了', 2)
cursor.execute(sql, data)
conn.commit()  # 提交，不然无法保存插入或者修改的数据
cursor.close() # 关闭游标
conn.close() # 关闭连接

删除数据

执行删除语句后，必须调用 .commit() 提交事务方可生效。支持批量删除后统一提交，若遗漏提交步骤，数据删除将无效。


import pymysql
# 连接数据库
conn = pymysql.connect(
  host='127.0.0.1',
  user='root',
  passwd='root',
  port=3306,
  db='test',
  charset='utf8'
)
# 创建一个游标
cursor = conn.cursor()
# 删除数据
sql = "delete from username where id=%s"
data = (2)
cursor.execute(sql, data)
conn.commit()  # 提交，不然删除操作不生效
cursor.close() # 关闭游标
conn.close() # 关闭连接

总结

以上介绍了在 Python 中使用 PyMySQL 操作数据库的方法，希望能为读者提供实际帮助。