pymysql
一、概要
PyMySQL 是在 Python3.x 版本中用于连接 MySQL 服务器的一个库，
二、PyMySQL 安装
pip install pymysql
三、操作流程
- 创建connection
- 获取cursor
- 执行增删改查的操作
- 处理数据
- 关闭cursor
- 关闭connection
四、核心类介绍
1、创建connection
-
说明
-
语法格式
conn = pymysql.connect(host=None, user=None, password="", database=None, port=0, db=None,charset='') -
常用参数说明
参数名 类型 说明 host String MySQL的服务器地址 port int MySQL的端口号 user String 用户名 passwd String 密码 db String 使用的数据库 charset String 连接字符集 -
返回值
cursor
-
示例代码
HOST = '127.0.0.1' PORT = 3306 USER = 'root' PASSWD = 'root' DB = 'python' CHARSET = 'utf8' connection = pymysql.connect(host=HOST, port=PORT, user=USER, passwd=PASSWD, db=DB, charset=CHARSET) -
其它方法
方法 描述 begin() 开启事务 commit() 提交事务 cursor(cursor=None) 创建一个游标用来执行语句 ping(reconnect=True) 检查连接是否存活，会重新发起连接 rollback() 回滚事务 close() 关闭连接 select_db(db) 选择数据库 show_warnings() 查看warning信息 -
详细
- host – 数据库服务器所在的主机。
- user – 登录用户名。
- password – 登录用户密码。
- database – 连接的数据库。
- port – 数据库开放的端口。（默认: 3306）
- bind_address – 当客户端有多个网络接口时，请指定连接到主机的接口，参数可以是主机名或IP地址。
- unix_socket – 使用unix套接字而不是tcp/ip。
- charset – 连接字符集。
- sql_mode – 默认SQL模式。
- read_default_file – 指定my.cnf文件路径，以便从[client]部分读取参数。
- conv – 要使用的转换字典，而不是默认值。
- use_unicode – 是否默认为unicode字符串，对于Py3k，此选项默认为true。
- client_flag – 发送到MySQL的自定义标志。
- cursorclass – 使用自定义的游标类。
- init_command – 建立连接时要运行的初始SQL语句。
- connect_timeout – 建立连接超时时间。（默认: 10，最小: 1，最大: 31536000）
- read_default_group – 从配置文件中读取组。
- compress – 不支持
- named_pipe – 不支持
- autocommit – 设置自动提交模式，不设置意味着使用数据库默认。（默认值: False）
- local_infile – 是否启用“LOAD LOCAL INFILE”命令的使用。(默认值: False)
- max_allowed_packet – 发送到服务器的数据包的最大大小 (以字节为单位，默认值: 16MB)，仅用于限制小于默认值 (16KB) 的 “LOAD LOCAL INFILE” 数据包的大小。
- defer_connect – 不要显式连接建设，等待连接调用。（默认值: False）
- db – 连接数据库别名（兼容MySQLdb）
- passwd – 密码输入别名（兼容MySQLdb）
- binary_prefix – 在bytes和bytearray上添加_binary前缀（默认: False）
2、获取cursor对象
-
说明
游标对象，用于执行查询和获取结果
-
核心方法
方法名 说明 execute() 用于执行一个数据库的查询命令 fetchone() 获取结果集中的下一行 fetchmany(size) 获取结果集中的下（size）行 fetchall() 获取结果集中剩下的所有行 rowcount 最近一次execute返回数据/影响的行数 close() 关闭游标 -
举个栗子
1、执行查询功能
with connection.cursor() as cursor: sql = 'select * from home_user' cursor.execute(sql) results = cursor.fetchall() connection.commit() for results in results: uid = results[0] name = results[1] password = results[2] print('==========用户信息===============') print('用户id: {id} \n用户名: {name}\n密码: {pwd}'.format(id=uid, name=name, pwd=password)) -
详细
方法 描述 close() 关闭游标。 execute(query, args=None) 执行单条语句，传入需要执行的语句，是string类型；同时可以给查询传入参数，参数可以是tuple、list或dict。执行完成后，会返回执行语句的影响行数，如果有的话。 executemany(query, args) 执行多条INSERT语句，传入需要执行的语句；同时可以给查询传入参数，参数是一个mappings序列。执行完成后，会返回执行语句的影响行数，如果有的话。 fetchone() 获取下一行数据。 fetchall() 获取所有数据。 fetchmany(size=None) 获取几行数据。 read_next() 获取下一行数据。 callproc() 用来调用存储过程。 mogrify() 参数化查询，防止SQL注入。 scroll(num,mode) 移动游标位置。
五、基本操作
查询数据
-
分页查询操作
def find_by_page(page, size): with pymysql.connect(host=HOST, port=PORT, user=USER, passwd=PASSWORD, charset=CHARSET, db=DB_NAME) as cursor: sql = "SELECT * FROM t_addr LIMIT{},{}".format((page - 1) * size, size) cursor.execute(sql) users = cursor.fetchall()
事务操作
-
示例代码
conn = pymysql.connect( host='127.0.0.1', port=3306, user='root', password='root', database='python', charset='utf8' ) cursor = conn.cursor() # 插入sql; sql_insert = "insert into t_user (userid,username) values (10,'user10')" # 更新sql; sql_update = "update t_user set username = 'name91' where userid=9" # 删除sql; sql_delete = "delete from t_user where userid < 3" # 把一个事务放到一个try块里，如果出现异常就回滚； try: # 开启事务; conn.begin() cursor.execute(sql_insert) print(cursor.rowcount) cursor.execute(sql_update) print(cursor.rowcount) cursor.execute(sql_delete) print(cursor.rowcount) # 提交事务; conn.commit() except Exception as e: # 若有异常就回滚; conn.rollback() cursor.close() conn.close()
批量插入
-
示例代码
# 测试事务 批量添加 def test_batch_insert(): conn = pymysql.connect(host=HOST, port=PORT, user=USER, passwd=PASSWORD, charset=CHARSET, db=DB_NAME) cursor = conn.cursor() try: sql = 'INSERT INTO t_addr(PROVICE, CITY, COUNTY, DEATIL, USERID) VALUES (%s,%s,%s,%s,%s)' li = [] for i in range(50): li.append(('湖北省', '武汉市', '高新区' + str(i), '智慧园', 6)) # 开启事物 conn.begin() cursor.executemany(sql, li) # 提交 conn.commit() except Exception as e: conn.rollback() print(e) # 报错事务回滚 finally: # 关闭连接 cursor.close() conn.close()