pymysql库详解

Connection Object（连接对象）

classpymysql.connections.Connection(
*,
user=None,
password='',
host=None,
database=None,
unix_socket=None,port=0,
charset='',
sql_mode=None,
read_default_file=None,
conv=None,
use_unicode=True,
client_flag=0,
cursorclass=<class 'pymysql.cursors.Cursor'>,
init_command=None,
connect_timeout=10,
read_default_group=None,
autocommit=False,
local_infile=False,
max_allowed_packet=16777216,
defer_connect=False,
auth_plugin_map=None,
read_timeout=None,
write_timeout=None,
bind_address=None,
binary_prefix=False,
program_name=None,
server_public_key=None,
ssl=None,
ssl_ca=None,
ssl_cert=None,
ssl_disabled=None,
ssl_key=None,
ssl_verify_cert=None,
ssl_verify_identity=None,
compress=None,
named_pipe=None,
passwd=None,db=None)

用mysql服务器表示套接字。

获取此类实例的正确方法是调用connect（）。

建立到MySQL数据库的连接。接受以下几种建议：

host #主办–数据库服务器所在的主机
user #用户–登录用户名
password#密码–要使用的密码。
database #数据库–使用数据库，无不使用特定数据库。
Port #端口–使用MySQL端口，默认值通常是可以的。（默认值：3306）
bind_address#绑定地址–当客户端有多个网络接口时，请指定从哪个接口连接到主机。参数可以是主机名或IP地址。
unix_socket#unix接口–您可以选择使用unix套接字而不是TCP/IP。
read_timeout#读取超时–读取连接的超时时间（秒）（默认值：无-无超时）
write_timeout#写入超时–写入连接的超时时间（秒）（默认值：无-无超时）
charset#字符集–您要使用的字符集。
sql_mode#sql模式\–要使用的默认SQL模式。
read_default_file#读取默认\u文件–指定要从[client]部分下读取这些参数的my.cnf文件。
conv#–要使用的转换字典，而不是默认字典。它用于提供类型的自定义封送和解组。请参阅转换器。
use_unicode#使用\u unicode–是否默认为unicode字符串。此选项默认为true。
client_flag#客户端标记–发送到MySQL的自定义标志。在constants.CLIENT中查找潜在值。
cursorclass#–要使用的自定义游标类。
init_command#init_命令–建立连接时要运行的初始SQL语句。
connect_timeout#连接超时–连接时引发异常前超时。（默认值：10，最小值：1，最大值：31536000）
ssl– A#ssl–与mysql_ssl_set（）的参数类似的参数dict。
ssl_-ca#公司–包含PEM格式CA证书的文件的路径
ssl_cert#–包含PEM格式的客户端证书的文件的路径
ssl_disabled#已禁用ssl–一个禁止使用TLS的布尔值
ssl_key#ssl密钥–包含客户端证书的PEM格式私钥的文件的路径
ssl_verify_cert#ssl验证证书–设置为true以检查服务器证书的有效性
ssl_verify_identity#ssl验证身份–设置为true以检查服务器的标识
read_default_group#读取默认组–要从配置文件中读取的组。
autocommit#自动提交–自动提交模式。无表示使用服务器默认值。（默认值：False）
local_infile#局部填充–布尔值，以启用加载数据本地命令。（默认值：False）
max_allowed_packet#允许的最大包数–发送到服务器的最大数据包大小（字节）。（默认值：16MB）仅用于限制“加载本地填充”数据包的大小小于默认值（16KB）。
defer_connect#连接延迟–构造时不要显式连接-等待connect调用。（默认值：False）
验证插件地图–插件名称的dict到处理该插件的类。该类将把Connection对象作为构造函数的参数。该类需要一个authenticate#方法，该方法将身份验证包作为参数。对于dialog插件，可以使用prompt（echo，prompt）方法（如果没有authenticate方法）从用户返回字符串。（实验性）
server_public_key#服务器公钥–SHA256认证插件公钥值。（默认值：无）
compress#二进制前缀–在字节和bytearray上添加二进制前缀。（默认值：False）
binary_prefix#压缩–不支持
named_pipe#命名_pipe–不支持
db–DEPRECATED# Holmium已弃用数据库的别名。
passwd Holmium#已弃用密码的别名。

begin()
Begin transaction.

cursor(cursor=None)
Create a new cursor to execute queries with.

select_db(db)
Set current db.

Cursor Objects（游标对象）

classpymysql.cursors.Cursor(connection)

（这是用于与数据库交互的对象）

callporc

callproc(procname,args=())

原文：
Execute stored procedure procname with args
procname – string, name of procedure to execute on server
args – Sequence of parameters to use with procedure
Returns the original args.
翻译：
使用参数执行存储过程procname
procname–字符串，要在服务器上执行的过程的名称
args–与过程一起使用的参数序列
返回原始参数。

close()

close()

cursor.close()
connection.close()

Closing a cursor just exhausts all remaining data.
关闭光标只会耗尽所有剩余的数据。

execute()

execute(query,args=None)

sql = "select * from user_name where name=%s and pwd=%s"
ret = cursor.execute(sql, [user, pwd])

Execute a query (执行查询)

1. Parameters: （参数）
2. query(str) – Query to execute.（查询——要执行的查询）
3. args(tuple,listordict) – parameters used with query. (optional)
   （args (元组 ,列表或dict)–用于查询的参数。（可选））
4. returns：（受影响de行数）
   Number of affected rows

Return type: （返回类型，int）
int

If args is a list or tuple, %s can be used as a placeholder in the query.If args is a dict, %(name)s can be used as a placeholder in the query.
（如果args是列表或元组，%s可以用作查询中的占位符。如果args是dict，%（name）s可以用作查询中的占位符。）

executemany

executemany (查询 ,args )
针对一个查询运行多个数据

参数：
查询–在服务器上执行的查询
args–序列或映射序列。用作参数。
退货：
受影响的行数（如果有）。

该方法提高了多行插入和替换的性能。否则，它相当于用execute（）在参数上循环。

fetchall ( )

获取所有行

(fetch
vt. 取来；接来；到达；吸引
vi. 拿；取物；卖得
n. 取得；诡计)

fetchmany (size=None )

取出几行

fetchone ( )

获取下一行

max_stmt_length= 1024000

最大语句大小executemany()生成。

allowed语句的最大大小为Max_allowed_packet-packet_header_size。Max_allowed_packet的默认值为1048576。

mogrify (查询 ,args=None )

返回通过调用execute（）方法发送到数据库的确切字符串。

此方法遵循对dbapi2.0的扩展，后跟Psycopg。

setinputsizes (*args )

不执行任何操作，这是DB API所必需的。

setoutputsizes (*args )

不执行任何操作，这是DB API所必需的。

classpymysql.cursors.SSCursor(connection)

无缓冲游标，主要用于返回大量数据的查询或通过慢速网络连接到远程服务器。

这不是将每一行数据复制到缓冲区，而是根据需要提取行。这样做的好处是客户机使用的内存要少得多，在慢速网络上传输或结果集非常大时，返回行的速度更快。

但也有局限性。MySQL协议不支持返回总行数，因此判断行数的唯一方法是遍历返回的每一行。而且，目前不可能向后滚动，因为只有当前行保存在内存中。

classpymysql.cursors.DictCursor (连接 )

以字典形式返回结果的游标

classpymysql.cursors.SSDictCursor (连接 )

无缓冲游标，以字典形式返回结果