1. connections 模块
类:Connection
用法:执行 pymysql.connect() 得到。而不是构造函数 Connection()。
pymysql.connect() 的参数即为 Connection() 构造函数的参数。
构造函数:
pymysql.connections.Connection(self,
host=None, # 要连接的主机地址
user=None, # 用于登录的数据库用户
password='', # 密码
database=None, # 要连接的数据库
port=0, # 端口,一般为 3306
unix_socket=None, # 选择是否要用unix_socket而不是TCP/IP
charset='', # 字符编码
sql_mode=None, # Default SQL_MODE to use.
read_default_file=None, # 从默认配置文件(my.ini或my.cnf)中读取参数
conv=None, # 转换字典
use_unicode=None, # 是否使用 unicode 编码
client_flag=0, # Custom flags to send to MySQL. Find potential values in constants.CLIENT.
cursorclass=<class 'pymysql.cursors.Cursor'>, # 选择 Cursor 类型
init_command=None, # 连接建立时运行的初始语句
connect_timeout=10, # 连接超时时间,(default: 10, min: 1, max: 31536000)
ssl=None, # A dict of arguments similar to mysql_ssl_set()'s parameters.For now the capath and cipher arguments are not supported.
read_default_group=None, # Group to read from in the configuration file.
compress=None, # 不支持
named_pipe=None, # 不支持
no_delay=None, #
autocommit=False, # 是否自动提交事务
db=None, # 同 database,为了兼容 MySQLdb
passwd=None, # 同 password,为了兼容 MySQLdb
local_infile=False, # 是否允许载入本地文件
max_allowed_packet=16777216, # 限制 `LOCAL DATA INFILE` 大小
defer_connect=False, # Don't explicitly connect on contruction - wait for connect call.
auth_plugin_map={}, #
read_timeout=None, #
write_timeout=None,
bind_address=None # 当客户有多个网络接口,指定一个连接到主机
)
重要函数
函数 | 说明 |
---|---|
cursor(cursor=None) | 创建一个游标 |
commit() | 事务提交,如果没有设为自动提交,则每次操作后必须提交事务,否则操作无效。 |
rollback() | 操作出错时,可以用这个函数回滚到执行事务之前 |
close() | 关闭连接 |
- 一个例子
import pymysql.cursors
config = {
'host':'127.0.0.1',
'port':3306,
'user':'root',
'password':'xinxin2333',
'database':'trade_ms',
'charset':'utf8mb4',
'cursorclass':pymysql.cursors.Cursor,
}
# 连接数据库
connection = pymysql.connect(**config)
2. cursors 模块
类 : Cursor
使用 connections.Connection.cursor() 得到,而不是这个类的构造函数。
connections.Connection.cursor()的参数是 cursor 的类型。
重要函数
函数 | 说明 |
---|---|
callproc(procname, args=()) | 执行一个过程 |
execute(query,args=None) | 执行一条SQL语句,返回受影响的行数。若args是列表,用%s做占位符,若是字典,用%(name)s |
executemany(query,args) | 对一个操作运行多个数据,如一次插入多条数据 |
fetchall() | 取出操作返回的所有的行接 |
fetchone() | 取出一行 |
fetchmany(size=None) | 取出 size 行 |
close() | 关闭这个游标对象 |
- 游标类型
类名 | 说明 |
---|---|
Cursor | 默认类型,查询返回list |
DictCursor | 与Cursor不同的地方是,查询返回dict,包括属性名 |
SSCursor | 查询不会返回所有的行,而是按需求返回 |
SSDictCursor | 差别同前两个 |
- 举例说明
#Cursor 查询返回
(10000, 't恤男短袖', 28, Decimal('89.00'), 300)
#DictCursor 查询返回
{'cid': 10000, 'cname': 't恤男短袖', 'claid': 28, 'price': Decimal('89.00'), 'cnum': 300}
- 一个例子
#!python3
#-*- coding: utf-8 -*-
import pymysql.cursors # 好像import这个模块就可以了
config = {
'host':'127.0.0.1',
'port':3306,
'user':'root',
'password':'xinxin2333',
'database':'trade_ms',
'charset':'utf8mb4',
'cursorclass':pymysql.cursors.Cursor,
}
connection = pymysql.connect(**config) # 连接数据库
try:
with connection.cursor() as cursor:
sql = 'SELECT * FROM commodity WHERE price > 100 ORDER BY price'
count = cursor.execute(sql) # 影响的行数
print(count)
result = cursor.fetchall() # 取出所有行
for i in result: # 打印结果
print(i)
connection.commit() # 提交事务
except:
connection.rollback() # 若出错了,则回滚
finally:
connection.close()