Python：Connector/Python数据库连接参数详细介绍

Lasted 2020-11-28 11:11:05

MySQL 官方提供了 Python 驱动程序 Connector/Python。其中包括 mysql.connector.connect() 方法和 mysql.connector.MySQLConnection() 类可用于连接数据库。

安装 Connector/Python

pip install mysql-connector-python

连接数据库

import mysql.connector

cnx = mysql.connector.connect(user='scott', password='password',
                              host='127.0.0.1',
                              database='employees')
cnx.close()

表格：Connector/Python 详细连接参数

参数名称	默认值	描述
user		数据库服务器的用户名。
password		数据库服务器的密码。
database		数据库名称。
host	127.0.0.1	数据库服务器的 IP 地址或主机名称。
port	3306	数据库服务器的 TCP/IP 端口，必须时整数。
unix_socket		Unix socket 文件地址。
auth_plugin		认证插件。
use_unicode	True	是否使用 Unicode。
charset	utf8	数据库编码。
collation	utf8mb4_general_ai_ci	数据库字符编码集，主要用于字段排序和存储。
autocommit	False	是否自动提交事务。
time_zone		设置连接时的时区。
sql_mode		设置连接时的模式。
get_warnings	False	是否获取警告。
raise_on_warnings	False	警告时是否抛出异常。
connection_timeout		TCP 或 Unix socket 连接的超时时间。
client_flags		客户端标志。
buffered	False	执行查询语句后时间立即获取数据或缓存。
raw	False	是否转换 MySQL 结果为 Python 类型，默认不转换。
consume_results	False	是否自动读取结果集。
ssl_ca		SSL 连接时 CA 认证。
ssl_cert		SSL 连接时证书。
ssl_disabled	False	使用 SSL/TLS 时禁用。
ssl_key		SSL 密钥。
ssl_verify_cert	False	设置为 True 时会检测 SSL 证书。
ssl_verify_identity	False	CA 检测。
force_ipv6	False	如果设置为 True，优先使用 IPv6，默认优先使用 Ipv4。
dsn		不再支持、使用时会抛 NotSupportedError 异常。
pool_name		数据库连接池名称。
pool_size	5	数据库连接池大小，值必须大于 0 小于等于 pooling.CNX_POOL_MAXSIZE 设置的值，默认 32。
pool_reset_session	True	是否重置数据库连接池。
compress	False	客户端和服务器之间是否使用压缩协议。
converter_class		转换类名称。
failover		服务故障转换顺序。
option_files		可选文件路径。
option_groups	['client', 'connector_python']	可选文件组。
allow_local_infile	True	是否使用（LOAD DATA LOCAL INFILE）。
use_pure	False	8.0.11 后默认 False，更早的版本默认 True。