PyMySQL详解：Python与MySQL数据库交互的利器

PyMySQL详解：Python与MySQL交互指南
原创 已于 2025-09-09 09:23:34 修改 · 845 阅读 · 20 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#数据库 #python #mysql #flask #os模块

于 2025-09-09 09:17:52 首次发布

PyMySQL详解：Python与MySQL数据库交互的利器

在当今数据驱动的时代，Python作为一门强大的编程语言，与数据库的交互能力至关重要。MySQL作为最流行的关系型数据库之一，被广泛应用于各类应用系统中。PyMySQL作为Python连接MySQL数据库的重要工具，为开发者提供了便捷、高效的数据库操作接口。本文将详细介绍PyMySQL的功能特性、使用方法及最佳实践，帮助开发者更好地掌握这一实用工具。

一、PyMySQL简介

PyMySQL是一个纯Python实现的MySQL客户端库，它遵循Python DB API 2.0规范，提供了与MySQL数据库交互的各种功能。与MySQL官方的MySQL Connector/Python相比，PyMySQL具有以下优势：

  • 纯Python实现，无需依赖额外的C扩展，安装简单
  • 性能优异，支持连接池和批量操作
  • 完全兼容Python 3.x版本
  • 开源免费，社区活跃，问题修复及时

PyMySQL的主要作用是在Python程序与MySQL数据库之间建立通信桥梁，使开发者能够通过Python代码执行SQL语句、处理查询结果、管理数据库连接等。

二、PyMySQL核心功能与安装

2.1 安装PyMySQL

使用pip命令即可轻松安装PyMySQL：

pip install pymysql

如需安装特定版本：

pip install pymysql==1.0.2

2.2 核心功能概览

PyMySQL提供了与MySQL数据库交互的完整功能集，主要包括：

  1. 数据库连接管理
  2. SQL语句执行（DDL、DML、DQL等）
  3. 事务控制（提交、回滚）
  4. 游标操作与结果处理
  5. 批量数据操作
  6. 错误处理机制
  7. 连接池支持（需配合其他库）

三、PyMySQL实战指南

3.1 数据库连接

使用PyMySQL连接MySQL数据库是所有操作的基础，基本步骤如下：

import pymysql
from pymysql.cursors import DictCursor

def get_db_connection():
    """创建并返回数据库连接"""
    try:
        # 建立数据库连接
        connection = pymysql.connect(
            host='localhost',      # 数据库主机地址
            user='root',           # 数据库用户名
            password='your_password',  # 数据库密码
            database='test_db',    # 要连接的数据库
            port=3306,             # 数据库端口，默认3306
            charset='utf8mb4',     # 字符集
            cursorclass=DictCursor # 游标类型，返回字典格式
        )
        print("数据库连接成功")
        return connection
    except pymysql.MySQLError as e:
        print(f"数据库连接失败: {e}")
        raise

# 使用连接
connection = get_db_connection()
# 关闭连接
connection.close()

注意：实际开发中，数据库连接信息应放在配置文件或环境变量中，避免硬编码

3.2 执行SQL语句

PyMySQL通过游标（cursor）对象执行SQL语句，支持各种类型的SQL操作：

def create_table(connection):
    """创建示例表"""
    try:
        with connection.cursor() as cursor:
            # 创建用户表
            sql = """
            CREATE TABLE IF NOT EXISTS users (
                id INT AUTO_INCREMENT PRIMARY KEY,
                username VARCHAR(50) NOT NULL UNIQUE,
                email VARCHAR(100) NOT NULL UNIQUE,
                age INT,
                created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
            ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4
            """
            cursor.execute(sql)
        # 提交更改
        connection.commit()
        print("表创建成功")
    except pymysql.MySQLError as e:
        print(f"创建表失败: {e}")
        connection.rollback()

3.3 数据插入操作

插入数据是数据库操作的常见需求，PyMySQL支持单条和批量插入：

def insert_data(connection):
    """插入数据示例"""
    try:
        with connection.cursor() as cursor:
            # 单条插入
            sql = """
            INSERT INTO users (username, email, age)
            VALUES (%s, %s, %s)
            """
            # 使用参数化查询防止SQL注入
            cursor.execute(sql, ('john_doe', 'john@example.com', 30))
            
            # 批量插入
            users = [
                ('jane_smith', 'jane@example.com', 28),
                ('bob_johnson', 'bob@example.com', 35),
                ('alice_wang', 'alice@example.com', 25)
            ]
            cursor.executemany(sql, users)
        
        connection.commit()
        print(f"成功插入 {cursor.rowcount} 条记录")
    except pymysql.MySQLError as e:
        print(f"插入数据失败: {e}")
        connection.rollback()

重要：始终使用参数化查询（%s作为占位符），而不是字符串拼接，以防止SQL注入攻击

3.4 数据查询操作

查询数据并处理结果是数据库交互的核心环节：

def query_data(connection):
    """查询数据示例"""
    try:
        with connection.cursor() as cursor:
            # 基本查询
            sql = "SELECT * FROM users WHERE age > %s"
            cursor.execute(sql, (28,))
            
            # 获取单条记录
            first_user = cursor.fetchone()
            print("第一条记录:", first_user)
            
            # 获取剩余所有记录
            remaining_users = cursor.fetchall()
            print(f"剩余 {len(remaining_users)} 条记录:")
            for user in remaining_users:
                print(f"ID: {user['id']}, 用户名: {user['username']}, 邮箱: {user['email']}")
                
            # 统计查询
            sql = "SELECT COUNT(*) as total FROM users"
            cursor.execute(sql)
            total = cursor.fetchone()['total']
            print(f"总用户数: {total}")
            
    except pymysql.MySQLError as e:
        print(f"查询数据失败: {e}")

3.5 数据更新与删除

更新和删除操作也是数据库维护的重要部分：

def update_and_delete_data(connection):
    """更新和删除数据示例"""
    try:
        with connection.cursor() as cursor:
            # 更新数据
            update_sql = "UPDATE users SET age = %s WHERE username = %s"
            cursor.execute(update_sql, (31, 'john_doe'))
            print(f"更新了 {cursor.rowcount} 条记录")
            
            # 删除数据
            delete_sql = "DELETE FROM users WHERE username = %s"
            cursor.execute(delete_sql, ('bob_johnson',))
            print(f"删除了 {cursor.rowcount} 条记录")
            
        connection.commit()
    except pymysql.MySQLError as e:
        print(f"更新/删除数据失败: {e}")
        connection.rollback()

3.6 事务处理

PyMySQL支持完整的事务处理，确保数据一致性：

def transaction_example(connection):
    """事务处理示例"""
    try:
        with connection.cursor() as cursor:
            # 开始事务（默认自动开启）
            
            # 操作1: 插入新用户
            cursor.execute(
                "INSERT INTO users (username, email, age) VALUES (%s, %s, %s)",
                ('transaction_user', 'trans@example.com', 40)
            )
            
            # 操作2: 更新另一个用户
            cursor.execute(
                "UPDATE users SET age = age + 1 WHERE username = %s",
                ('john_doe',)
            )
            
            # 如果所有操作成功，提交事务
            connection.commit()
            print("事务提交成功")
            
    except pymysql.MySQLError as e:
        # 如果发生错误，回滚事务
        connection.rollback()
        print(f"事务执行失败，已回滚: {e}")

3.7 上下文管理器的使用

PyMySQL支持上下文管理器（with语句），简化资源管理：

def context_manager_example():
    """使用上下文管理器操作数据库"""
    try:
        # 连接作为上下文管理器
        with get_db_connection() as connection:
            # 游标作为上下文管理器
            with connection.cursor() as cursor:
                cursor.execute("SELECT username, email FROM users LIMIT 2")
                results = cursor.fetchall()
                for row in results:
                    print(f"用户名: {row['username']}, 邮箱: {row['email']}")
                    
        # 上下文管理器会自动关闭游标和连接，无需手动调用close()
    except pymysql.MySQLError as e:
        print(f"操作失败: {e}")

四、PyMySQL高级应用

4.1 连接池的使用

在高并发场景下，使用连接池可以显著提高性能。我们可以结合DBUtils库实现连接池：

pip install DBUtils

from DBUtils.PooledDB import PooledDB
import pymysql

# 创建连接池
pool = PooledDB(
    creator=pymysql,        # 使用链接数据库的模块
    maxconnections=10,      # 连接池允许的最大连接数
    mincached=2,            # 初始化时，链接池中至少创建的空闲的链接
    maxcached=5,            # 链接池中最多闲置的链接
    maxshared=3,            # 链接池中最多共享的链接数量
    blocking=True,          # 连接池中没有可用连接时，是否阻塞等待
    maxusage=None,          # 一个链接最多被使用的次数，None表示无限制
    setsession=[],          # 开始会话前执行的命令列表
    ping=0,                 # ping MySQL服务端，检查是否服务可用
    host='localhost',
    user='root',
    password='your_password',
    database='test_db',
    charset='utf8mb4'
)

def use_connection_pool():
    """使用连接池获取连接"""
    # 从连接池获取一个连接
    connection = pool.connection()
    
    try:
        with connection.cursor() as cursor:
            cursor.execute("SELECT 1")
            result = cursor.fetchone()
            print("连接池测试成功:", result)
    finally:
        # 将连接返回给连接池，而不是关闭
        connection.close()

4.2 处理大数据集

对于大量数据的查询，应使用迭代方式获取结果，避免占用过多内存：

def handle_large_dataset(connection):
    """处理大数据集示例"""
    try:
        with connection.cursor() as cursor:
            # 关闭查询缓存，提高大数据查询性能
            cursor.execute("SET SESSION query_cache_type = OFF")
            
            # 查询大量数据
            cursor.execute("SELECT * FROM large_table")
            
            # 迭代获取结果，而不是一次性获取全部
            batch_size = 1000
            while True:
                batch = cursor.fetchmany(batch_size)
                if not batch:
                    break
                # 处理当前批次数据
                process_batch(batch)
                
    except pymysql.MySQLError as e:
        print(f"处理大数据集失败: {e}")

def process_batch(batch):
    """处理数据批次"""
    print(f"处理 {len(batch)} 条记录")
    # 实际处理逻辑...

五、最佳实践与注意事项

  1. 安全方面

    • 始终使用参数化查询，防止SQL注入
    • 避免在代码中硬编码数据库 credentials，使用环境变量或配置文件
    • 遵循最小权限原则，为数据库用户分配必要的最小权限

  2. 性能优化

    • 对频繁访问的数据库操作使用连接池
    • 合理使用索引，优化查询语句
    • 大批量操作使用executemany而非循环execute
    • 适当设置fetchmany的批次大小，平衡内存占用和性能

  3. 资源管理

    • 始终确保数据库连接和游标被正确关闭，推荐使用上下文管理器
    • 长连接场景下，定期检查连接有效性（使用ping()方法）
    • 事务操作应尽量简短，避免长时间占用连接

  4. 错误处理

    • 捕获并妥善处理数据库操作可能出现的异常
    • 对事务操作实现完整的提交/回滚机制
    • 记录详细的错误日志，便于问题排查

六、常见问题及解决方案

  1. 连接超时问题

    • 解决方案：设置合理的connect_timeout参数；长连接定期发送ping包；使用连接池管理连接

  2. 编码问题

    • 解决方案：连接时指定charset=‘utf8mb4’；确保数据库和表使用正确的字符集

  3. 大量数据插入性能低下

    • 解决方案：使用executemany()；开启事务批量提交；调整innodb_flush_log_at_trx_commit参数

  4. "MySQL server has gone away"错误

    • 解决方案：增加wait_timeout配置；操作前检查连接状态；实现自动重连机制

七、总结

PyMySQL作为Python与MySQL交互的重要工具，为开发者提供了简洁、高效的数据库操作接口。通过本文的介绍，我们了解了PyMySQL的核心功能、使用方法和最佳实践。从基本的连接管理、SQL执行，到事务处理、连接池应用，PyMySQL能够满足各种场景下的数据库操作需求。

在实际开发中，合理使用PyMySQL可以显著提高Python应用与MySQL数据库交互的效率和安全性。同时，结合数据库设计最佳实践和查询优化技巧，能够构建出高性能、可靠的数据驱动应用。

掌握PyMySQL不仅是Python开发者的必备技能，也是深入理解数据库交互原理、提升系统设计能力的重要途径。希望本文能为开发者在使用PyMySQL的过程中提供有价值的参考和指导。

《解锁 Python 数据挖掘的奥秘》
zheng_ruiguo的专栏
12-23 2060
定义挖掘目标：明确业务问题或研究问题，确定要从数据中发现的模式、关系或预测结果。例如，预测客户的购买行为、识别疾病的风险因素、优化生产流程等。这一步骤需要与业务领域专家紧密合作，确保挖掘目标具有实际价值和可操作性。数据收集与预处理：收集与挖掘目标相关的数据，可以来自各种数据源，如数据库、文件系统、网络爬虫、传感器等。然后对数据进行清洗、去噪、处理缺失值和异常值、数据集成和转换等操作，以提高数据的质量和可用性。例如，去除重复记录、填充缺失值、纠正错误数据、将数据标准化或归一化等。特征工程。
Python数据分析_Pandas_数据组合和缺失值处理_4
AGI爱好者_数仓&可视化&数据分析工程师_Vae’伯乐‘
12-26 1475
简介好多数据集都含缺失数据。缺失数据有多重表现形式数据库中，缺失数据表示为NULL在某些编程语言中用NA表示缺失值也可能是空字符串（’’）或数值在Pandas中使用NaN表示缺失值NaN，NAN，nan，他们都一样缺失值和其它类型的数据不同，它毫无意义，NaN不等于0，也不等于空串数据中出现缺失值是很常见的计算的过程中, 两个表join 可能会有缺失原始的数据中也有可能直接带着缺失值数据处理和模型训练的时候, 有很多场景要求必须先把缺失值处理掉,想处理缺失值先要在数据中找到缺失值。
Python3_MySQL数据库连接 - PyMySQL 驱动
ILen的博客
11-17 967
数据库连接 连接数据库前，请先确认以下事项： 您已经创建了数据库 TESTDB. 在TESTDB数据库中您已经创建了表 EMPLOYEE EMPLOYEE表字段为 FIRST_NAME, LAST_NAME, AGE, SEX 和 INCOME。 连接数据库ILen_Devops使用的用户名为 "root" ，密码为 "blueware",你可以可以自己设定或者直接使用root用户名及其...
python——数据库操作PyMysql使用详解
iamballer77的博客
10-10 2万+
PyMysql使用详解
【Python】Python操作MySQL详解——PyMySQL
会飞的大象
01-31 1万+
PyMySQL模块简介 纯Python实现的模块，可以与Python代码兼容衔接，并也几乎兼容MySQL-python。遵循 Python 数据库 API v2.0 规范。安装PyMySQL需要满足以下需求。
【数据库】PyMySQL详解：轻松实现Python与MySQL的高效交互
易辰的博客
09-30 7141
PyMySQL是一个纯 Python 的库，用于连接 MySQL 数据库，并执行 SQL 语句。它是MySQLdb的替代品，但不同于后者，PyMySQL不需要 C 语言的依赖，因此更加轻量且易于安装和使用。该库的主要用途是通过 Python 代码与 MySQL 数据库进行交互，比如执行查询、插入数据、更新数据、删除数据等操作。PyMySQL是一个轻量级、易于使用的 Python 库，适合 Python 程序员与 MySQL 数据库进行交互。
Python数据库编程之pymysql详解
热门推荐
youngwyj的博客
05-11 4万+
文章目录前言一、pymsql的安装二、连接数据库三、创建和管理数据库四、创建和管理表 前言 学习之前务必安装MySQL并已启动相关服务，MySQL安装方法及查看初始密码见文章第一部分： https://blog.youkuaiyun.com/youngwyj/article/details/124293362?spm=1001.2014.3001.5502 一、pymsql的安装 在python3的环境中直接使用以下命令即可： pip install pymsql #或者 pip3 install pymysq
Python与数据库交互：Pandas数据读取与存储的高效方法
![Python与数据库交互：Pandas数据读取与存储的高效方法](https://www.delftstack.com/img/Python Pandas/feature ...本章将为读者概述Python与数据库交互的基本概念和常用方法，为后续章节深入探讨Pandas库与数据库
1.Python语言开发要点详解_python教程_waswbb_
09-30
Python与数据库的交互通常通过DB-API实现，如sqlite3模块提供了SQLite数据库的支持，而pymysql和psycopg2则可以连接MySQL和PostgreSQL数据库。 十、科学计算与数据分析 NumPy、Pandas和Matplotlib等库是Python在...
从零开始：用Python实现钻孔柱状图的自动化，掌握数据可视化新趋势
本文全面概述了Python在数据可视化领域的应用，从基础编程知识到数据处理技术，再到钻孔柱状图的实现与自动化数据可视化的案例研究。首先介绍了Python数据可视化的概念和Python编程基础，包括环境搭建、基础语法、...
Python MySQL数据库连接池组件pymysqlpool详解
09-09
主要跟大家介绍了关于Python MySQL数据库连接池组件pymysqlpool的相关资料，文中通过示例代码介绍的非常详细，对大家具有一定的参考学习价值，需要的朋友们下面来一起看看吧。
python-pymysql库使用一文详解+实例代码
master_hunter的博客
05-31 3255
前言 首先使用python很大一部分人是用于数据分析或者是开发，而数据来源一般都是存储在数据库中。作为python怎么能不会从mysql里面获取到数据呢。而pymysql就是联通mysql实现python窗口与mysql数据库交互的库，十分方便操作。此篇文章将详细说明如何掌握并使用该库。mysql库官方文档：PyMySQL 一、pymysql用途 pymysql是可用于连接mysql数据库，且能够提供mysql与python窗口交互创立通道的工具库。可以通过创建引擎，建立游标直接通过python编..
PyMySQL 详解
没有撤退可言.
08-25 5004
PyMySQL是一个纯 Python 实现的 MySQL 客户端操作库，支持事务、存储过程、批量执行等。 PyMySQL 遵循 Python 数据库 API v2.0 规范，并包含了 pure-Python MySQL 客户端库。 安装 pip install PyMySQL 创建数据库连接 import pymysql connection = pymysql.connect(host='localhost', port=3..
python-入门篇-day08-PyMySQL
m0_60916732的博客
08-22 1077
自定义的模块(充当: 工具类), 里边定义的都是 PyMysql相关的最基本的操作, 用于简化刚才 PyMysql-CURD中 大量重复代码的.因为受到目前所学知识点的限制, 很多内容例如: 面向对象, 魔法方法, 封装很多内容都没学, 所以我们仅仅是: 模拟 工具模块(工具类)的 思维.实际开发中, 如果我们的SQL语句中 部分内容是由用户键盘录入的, 此时如果用户录入一些非法值, 就很有可能改变了我们SQL语句的结构, 从而引发一系列的安全问题, 这些安全问题就是: SQL注入攻击.事务。
简单易懂！迅速掌握Python语言----操作MySQL数据库之pymysql模块教程（讲解+示例+代码，欢迎关注点赞收藏~）
m0_56868937的博客
01-04 7299
pymysql是Python中的一个类库, 主要是通过python代码来操作SQL语句的，主要是对数据库的数据进行增删改查。
Python之pymysql详解
Hello LinWoW~ ⊙o⊙
05-16 8395
PyMySQL PyMySQL 是在 Python3.x 版本中用于连接 MySQL 服务器的一个库，Python2中则使用mysqldb。 安装pymysql PyMySQL ： 这是一个使Python连接到MySQL的库，它是一个纯Python库。 PyMySQL是一个开源项目 ：https://github.com/PyMySQL/PyMySQL 通过下面的命令来进行安装pymysql模块：...
Python MySQL使用基础
最新发布
weixin_46014373的博客
06-14 1032
主键一般用于表示当前这条数据的ID编号（类似于人的身份证），需要我们自己来维护一个不重复的值。退出并再次修改配置文件，删除[mysqld]节点下的skip-grant-tables=1，之后再次重启就可以使用新密码登录了。同时创建必备一些数据，例如默认账户root（无密码），用于登录MySQL并通过指令操作MySQL。当连接上MySQL之后，执行如下命令（一般称为SQL语句），就可以对MySQL的数据进行操作。在解压目录下，创建my.ini文件作为MySQL的配置文件。进入数据库后执行修改密码命令。
pymysql进行数据库各项基础操作
ximu__l的博客
03-31 2109
本文实现了对mysql、基于pymysql的表的插入、表的修改、表的查询、表的删除的基础操作。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值