Python操作MySQL数据库完整指南：连接、游标与增删改查

周末不加班

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

原创

本文详解Python如何使用pymysql库连接MySQL数据库。涵盖安装配置、连接参数解析、游标对象方法及常用命令，通过实例演示建表、查询、插入、更新和删除数据的完整流程，并强调事务提交与异常处理的重要性。

安装pymysql库

1、安装pymysql库

若要在Python中操作MySQL数据库，首先需安装pymysql库。安装过程十分简便，直接在命令行执行pip install pymysql即可。如果上述方式安装失败，可访问https://www.lfd.uci.edu/~gohlke/pythonlibs/下载对应的whl安装包进行手动安装，具体步骤请自行查阅相关资料。建议在学习本文前，先阅读关于游标cursor讲解的往期文章（https://www.jb51.net/article/177865.htm），以获得更佳的学习效果。

连接MySQL数据库与参数详解

2、使用python连接mysql数据库 1）六个常用的连接参数

参数host：指定MySQL服务器所在主机的IP地址；
参数user：指定登录数据库的用户名；
参数password：指定登录数据库的密码；
参数port：指定连接MySQL主机的端口号，默认值为3306；
参数db：指定要连接的数据库名称；
参数charset：当读取数据出现中文乱码时，需设置编码格式。Python操作数据库时，Python作为客户端（client）与MySQL服务器交互。Python3默认采用utf8字符集，而部分MySQL服务器默认采用latin1字符集。因此，在MySQL中创建表时若指定了utf8编码，此处connection连接器的编码设置应与之一致，以避免乱码问题。

关于connection的具体概念，可参考另一篇文章深入学习：https://www.jb51.net/article/177872.htm

2）python连接mysql的语法


import pymysql 
db = pymysql.connect(host='localhost',user='root',password='123456',port=3306,db='spiders',charset=' utf8')

最基本的参数包括host、user、password和port，这些是建立连接所必需的。其余参数可根据实际需求选择是否使用。
host指代MySQL服务器的安装位置。若MySQL安装在本机，可填写localhost，也可使用主机名或主机IP地址。
db指代要操作的具体数据库名称。在建立数据库连接时，建议显式指定该参数以确保连接目标正确。

3）一个简单的热身案例


# 导包
import pymysql 
# 使用pymysql连接上mysql数据库服务器，创建了一个数据库对象；
db = pymysql.connect(host='localhost',user='root', password='123456',
     port=3306, db='huangwei', charset='utf8')
# 开启mysql的游标功能，创建一个游标对象；    
cursor = db.cursor()
# 要执行的SQL语句；
sql = "select * from student"
# 使用游标对象执行SQL语句；
cursor.execute(sql)
# 使用fetchone()方法，获取返回的结果，但是需要用变量保存返回结果；
data = cursor.fetchone()
print(data)
# 断开数据库的连接，释放资源；
db.close()

运行结果如下：

游标对象常用方法

3、cursor游标对象的一些常用方法

1）cursor用来执行命令的方法

execute(query, args)：用于执行单条SQL语句。接收的参数为SQL语句本身及参数列表，返回值为受影响的行数；
executemany(query, args)：用于执行单条SQL语句，但会重复执行参数列表中的多组参数，返回值为受影响的总行数；

2）cursor用来接收返回值的方法

fetchone()：从结果集中返回一条记录；
fetchmany(size)：接收size条返回结果行。如果size值大于实际返回的结果行数，则返回cursor.arrsize条数据；
fetchall()：接收并返回所有的结果行；

创建数据表

4、创建表


import pymysql 
db = pymysql.connect(host='localhost',user='root', password='123456',port=3306, db='huangwei', charset='utf8')

# 创建一个游标对象；
cursor = db.cursor()
 
# 建表语句；
sql = """
  create table person(
   id int auto_increment primary key not null,
   name varchar(10) not null,
   age int not null
  )charset=utf8
  """

# 执行sql语句；
cursor.execute(sql)
 
# 断开数据库的连接；
db.close()

注意：在Python中编写的SQL语句应与在MySQL中直接执行的语法保持一致。另外，当Python代码需要多次换行时，建议使用“三引号”来包裹SQL语句，以提高代码可读性。

查询数据操作

5、查询数据…查

1）fetchone()：一次获取一条记录


import pymysql
 
db = pymysql.connect(host='localhost',user='root',db='huangwei',password='123456',port=3306,charset='utf8')
      
cursor = db.cursor()

cursor.execute('select count(*) from person')
aa = cursor.fetchone()
print(aa)
cursor.execute('select name,age from person') 
for i in range(aa[0]):
 a,b = cursor.fetchone()
 c = "我的名字叫{}，今年{}岁".format(a,b)
 display(c)
db.close()

运行结果如下：

2）fetchall()：一次获取所有记录


import pymysql
 
db = pymysql.connect(host='localhost',user='root',db='huangwei',password='123456',port=3306,charset='utf8')
      
cursor = db.cursor()

cursor.execute('select name,age from person')
aa = cursor.fetchall()
# print(aa)
for a,b in aa:
 c = "我的名字叫{}，今年{}岁".format(a,b)
 display(c)
db.close()

运行结果如下：

注：还有一个fetchmany()方法，用于一次性获取指定条数的记录，读者可自行研究其用法。

3）使用pandas中的read_sql()方法，将提取到的数据直接转化为DataFrame对象以便进行后续操作


import pymysql 
import pandas as pd

db = pymysql.connect(host='localhost',user='root',db='huangwei',password='123456',port=3306,charset='utf8')
cursor = db.cursor()

df1 = pd.read_sql("select * from student where ssex='男'",db)
display(df1)

df2 = pd.read_sql("select * from student where ssex='女'",db)
display(df2)

运行结果如下：

插入数据操作

6、插入数据…增

1）一次性插入一条数据


import pymysql

db = pymysql.connect(host='localhost',user='root', password='123456',port=3306, db='huangwei', charset='utf8')
 
cursor = db.cursor()
 
# mysql中SQL语句怎么写，这里就怎么写；
name = "猪八戒"
age = 8000
sql = 'insert into person(name,age) values ("猪八戒",8000)'

try:
 cursor.execute(sql)
 db.commit()
 print("插入成功")
except:
 print("插入失败")
 db.rollback()
db.close()

1.1）一次性插入一条数据（示例代码见a10）


import pymysql
 
db = pymysql.connect(host='localhost',user='root', password='123456',port=3306, db='huangwei', charset='utf8')
 
cursor = db.cursor()
 
# 插入数据
sql = 'insert into person(name,age) values(%s,%s)'
try:
 cursor.execute(sql,('孙悟空',100000))
 db.commit()
 print("插入成功")
except:
 print("插入失败")
 db.rollback()
db.close()

2）一次性插入多条数据（示例代码见a12）


import pymysql
 
db = pymysql.connect(host='localhost',user='root', password='123456',port=3306, db='huangwei', charset='utf8')
 
cursor = db.cursor()
 
# 插入数据
sql = 'insert into person(name,age) values(%s,%s)'
# 注意：(('牛魔王',9000),('铁扇公主',8000),('玉皇大帝',6000))也可以，小括号都可以换为中括号
datas = [('牛魔王',9000),('铁扇公主',8000),('玉皇大帝',6000)]
try:
 cursor.executemany(sql,datas)
 db.commit()
 print("插入成功")
except:
 print("插入失败")
 db.rollback()
db.close()

总结如下：

① pymysql模块默认开启MySQL的事务功能。因此，在执行“增”、“删”、“改”操作时，必须调用db.commit()提交事务，否则插入的数据将无法保存。

② 在执行“增”、“删”、“改”操作时，务必使用try…except…语句进行异常处理。若插入失败，需调用db.rollback()回滚至操作前的状态；若执行成功，则调用db.commit()提交事务，确保数据一致性。

更新与删除数据操作

7、更新数据…改（示例代码见a13）


import pymysql
 
db = pymysql.connect(host='localhost',user='root', password='123456',port=3306, db='huangwei', charset='utf8')
 
cursor = db.cursor()
 
# 更新数据
sql = 'update person set age=%s where name=%s'
try:
 cursor.execute(sql,[90000,"玉皇大帝"])
 db.commit()
 print("更新成功")
except:
 print("更新失败")
 db.rollback()
db.close()

8、删除数据…删（示例代码见a14）


import pymysql
 
db = pymysql.connect(host='localhost',user='root', password='123456',port=3306, db='huangwei', charset='utf8')
 
cursor = db.cursor()
 
# 删除数据
sql = 'delete from person where age=8000'
try:
 cursor.execute(sql)
 db.commit()
 print("删除成功")
except:
 print("删除失败")
 db.rollback()
db.close()

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持本站。