一、环境
Windows 7 x64 python 3.7.1 pymysql 0.9.3 mysql5.6.43
二、pymysql的简单使用
1、准备数据库demo_temp
create database demo_temp;
2、连接数据库
import pymysql.cursors
connect = pymysql.connect(
host='127.0.0.1',
user='root',
password='123',
db='demo_temp',
charset='utf8',
cursorclass=pymysql.cursors.DictCursor
)
3、创建表
import pymysql.cursors
# 连接数据库
connect = pymysql.connect(
host='127.0.0.1',
user='root',
password='123',
db='demo_temp',
charset='utf8',
cursorclass=pymysql.cursors.DictCursor
)
# 创建表users
with connect.cursor() as cursor:
sql = """
CREATE TABLE users (
id INT PRIMARY KEY AUTO_INCREMENT ,
user CHAR(30),
passwd CHAR(20))
"""
cursor.execute(sql)
connect.close()
4、一个简单的增、删、改、查实例
import pymysql.cursors
# 连接数据库
connect = pymysql.connect(
host='127.0.0.1',
user='root',
password='123',
db='demo_temp',
charset='utf8',
cursorclass=pymysql.cursors.DictCursor
)
with connect.cursor() as cursor: # 创建游标
# 创建表
sql = """
CREATE TABLE users (
id INT PRIMARY KEY AUTO_INCREMENT ,
user CHAR(30),
passwd CHAR(20))
"""
cursor.execute(sql)
# 向表中插入数据
sql = """
INSERT INTO users (user,passwd) VALUES ('小明','123')
"""
cursor.execute(sql)
connect.commit() # 插入数据后必须更新
# 查询数据
sql = """
select * from users
"""
cursor.execute(sql)
ret = cursor.fetchone() # 提取查询数据
print(ret)
# 修改数据
sql = """
update users set user='葫芦娃' where id=1
"""
cursor.execute(sql)
# 再次查询数据
sql = """
select * from users
"""
cursor.execute(sql)
ret = cursor.fetchone() # 提取查询数据
print(ret)
connect.close() # 关闭数据库连接
# 打印内容如下
{'id': 1, 'user': '小明', 'passwd': '123'}
{'id': 1, 'user': '葫芦娃', 'passwd': '123'}
5、简单的事务
import pymysql.cursors
# 连接数据库
connect = pymysql.connect(
host='127.0.0.1',
user='root',
password='123',
db='demo_temp',
charset='utf8',
cursorclass=pymysql.cursors.DictCursor
)
try:
with connect.cursor() as cursor: # 创建游标
# 插入数据
sql = """
INSERT INTO users (user,passwd) VALUES ('11111','123')
"""
cursor.execute(sql)
# 更新数据
sql_1 = """
update users set user='葫芦娃' where id=1
"""
cursor.execute(sql_1)
raise NameError # 更新数据时主动抛出异常
except Exception as e:
connect.rollback() # 事务回滚
connect.commit()
connect.close() # 关闭数据库连接
通过下面的小动画我们可以看出,这里模拟在更新数据时出现问题。而插入数据时没有问题的。然后执行事务回滚,最终数据没有被写入到数据库中。
三、Connection中常用API
1、open() :检测数据库是否连接。
connect.open:如果数据库连接返回Trhe,否则返回False。
2、ping(reconnect=True)
connect.ping(reconnect=True):如果reconnect=True表示连接断开后,重新进行连接。
import pymysql.cursors
# 连接数据库
connect = pymysql.connect(
host='127.0.0.1',
user='root',
password='123',
db='demo_temp',
charset='utf8',
cursorclass=pymysql.cursors.DictCursor
)
print(connect.open) # 打印数据库连接状态
connect.close() # 关闭数据库连接
connect.ping(reconnect=True) # 重新连接数据库
print(connect.open) # 打印数据库连接状态
下面的小动画向我们展示了当connect断开连接后,使用connect.ping(reconnect=True)又重新连接到了数据库。
3、rollback
():回滚当前事务,用法在上面,这里就不再演示了。
4、select_db(db):切换数据库。
# demo_test数据库中users表数据
mysql> select * from users;
+----+-----------+--------+
| id | user | passwd |
+----+-----------+--------+
| 1 | 小明 | 123 |
| 2 | 小刚 | 123 |
| 3 | 小红 | 123 |
| 4 | 葫芦娃 | 123 |
| 5 | 小明 | 123 |
+----+-----------+--------+
# demo_temp2库中test表中数据
mysql> select * from test;
+------+------+----------+
| id | user | password |
+------+------+----------+
| 1 | abc | 123 |
+------+------+----------+
import pymysql.cursors
# 连接数据库
connect = pymysql.connect(
host='127.0.0.1',
user='root',
password='123',
db='demo_temp',
charset='utf8',
cursorclass=pymysql.cursors.DictCursor
)
with connect.cursor() as cursor: # 创建游标
# 查询demo_temp中users表的数据
sql = """
select * from users
"""
cursor.execute(sql)
ret = cursor.fetchall() # 提取查询数据
print(ret)
print('-'*80)
# 切换到demo_temp2数据库,查询test表的数据
connect.select_db('demo_temp2')
sql = """
select * from test
"""
cursor.execute(sql)
ret = cursor.fetchall() # 提取查询数据
print(ret)
connect.close() # 关闭数据库连接
# 打印结果
[{'id': 1, 'user': '小明', 'passwd': '123'}, {'id': 2, 'user': '小刚', 'passwd': '123'}, {'id': 3, 'user': '小红', 'passwd': '123'},
{'id': 4, 'user': '葫芦娃', 'passwd': '123'}, {'id': 5, 'user': '小明', 'passwd': '123'}]
--------------------------------------------------------------------------------
[{'id': 1, 'user': 'abc', 'password': '123'}]
5、cursor():创建游标对象,用于操作数据(增、删、改、查)。
6、commit():提交请求,当向数据库中插入数据时,需要使用commit()进行提交,否则数据将不能写入数据库。
7、close():关闭数据库连接。
四、Cursor常用API
1、cursor.execute(query, args=None):执行sql语句。
参数:
- query (str):sql语句.
- args (tuple, list or dict):sql语句中如果有变量,或者格式化输出,会在这里填充数据。
Returns:返回一个int值,表示sql语句影响到的行数。
下面演示插入数据的四种方式:
import pymysql.cursors
# 连接数据库
connect = pymysql.connect(
host='127.0.0.1',
user='root',
password='123',
db='demo_temp',
charset='utf8',
cursorclass=pymysql.cursors.DictCursor
)
with connect.cursor() as cursor: # 创建游标
# 第一种方式向表中插入数据
sql = """
INSERT INTO users (user,passwd) VALUES ('123','123')
"""
cursor.execute(sql)
# 第二种方式向表中插入数据
sql = """
INSERT INTO users (user,passwd) VALUES (%s,%s)
"""
cursor.execute(sql,['456','456'])
# 第三种方式向表中插入数据
sql = """
INSERT INTO users (user,passwd) VALUES (%s,%s)
"""
cursor.execute(sql, ('789', '789'))
# 第四种方式向表中插入数据
sql = """
INSERT INTO users (user,passwd) VALUES (%(a)s,%(b)s)
"""
cursor.execute(sql, {'a':'abc','b':'123'}) # 这里的'a'和'b'要和上面VALUES中对应
connect.commit() # 插入数据后必须更新
# 查询数据
sql = """
select * from users
"""
cursor.execute(sql)
ret = cursor.fetchall() # 提取查询数据
print(ret)
connect.close() # 关闭数据库连接
2、cursor.executemany(query, args):可以执行多条sql语句。
参数:
query :sql语句
args:可迭代对象
Returns:返回sql语句影响到的行数。
下面是方法实例:
import pymysql.cursors
# 连接数据库
connect = pymysql.connect(
host='127.0.0.1',
user='root',
password='123',
db='demo_temp',
charset='utf8',
cursorclass=pymysql.cursors.DictCursor
)
with connect.cursor() as cursor: # 创建游标
# 插入多条数据
sql = """
INSERT INTO users (user,passwd) VALUES (%s,%s)
"""
ret_row = cursor.executemany(sql,[['a','123'],['b','234'],['c','456']]) # 在args中传入一个可迭代对象。
connect.commit() # 插入数据后必须更新
print(f'当前受影响了{ret_row}行')
# 查询数据
sql = """
select * from users
"""
cursor.execute(sql)
ret = cursor.fetchall() # 提取查询数据
print(ret)
connect.close() # 关闭数据库连接
3、cursor.fetchone():从查询语句中获取一条查询结果。
4、cursor.fetchall():获取所有查询到的结果。
5、cursor.fetchmany(size):根据size获取相应的行数。
6、cursor.mogrify(query, args=None):返回执行的sql语句,下面是示例:
import pymysql.cursors
# 连接数据库
connect = pymysql.connect(
host='127.0.0.1',
user='root',
password='123',
db='demo_temp',
charset='utf8',
cursorclass=pymysql.cursors.DictCursor
)
with connect.cursor() as cursor: # 创建游标
sql = """
select * from users
"""
cursor.execute(sql)
ret_sql = cursor.mogrify(sql) # 返回执行的sql语句
cursor.fetchmany(2) # 提取查询数据
print(ret_sql)
connect.close() # 关闭数据库连接
7、cursor.close():关闭游标,关闭游标后,游标内所有数据将被清空。
参考文档:https://pymysql.readthedocs.io/en/latest/