순수 Python으로 구현된 MySQL 클라이언트 작업 라이브러리 공유-MySQL 튜토리얼-php.cn

PyMySQL은 순수 Python으로 구현된 MySQL 클라이언트 작업 라이브러리로, 트랜잭션, 저장 프로시저, 일괄 실행 등을 지원합니다. PyMySQL은 Python Database API v2.0 사양을 따르며 순수 Python MySQL 클라이언트 라이브러리를 포함합니다.

Installation

pip install PyMySQL

로그인 후 복사

데이터베이스 연결 만들기

import pymysql

connection = pymysql.connect(host=&#39;localhost&#39;,
                             port=3306,
                             user=&#39;root&#39;,
                             password=&#39;root&#39;,
                             db=&#39;demo&#39;,
                             charset=&#39;utf8&#39;)

로그인 후 복사

매개변수 목록:

사전을 다음으로 변환 기본 유형 대신 사용합니다.기본적으로 유니코드 문자열을 사용할지 여부입니다. Py3k에서는 이 옵션이 기본적으로 true입니다. MySQL로 보낼 사용자 정의 플래그입니다. SQL 문 초기화연결 시간 초과, 기본값 10, 최소 1, 최대 31536000mysql_ssl_set()의 매개변수와 유사한 인수 딕셔너리 . 현재 capath 및 cipher 인수는 지원되지 않습니다.구성 파일에서 읽을 그룹입니다. local_infilemax_allowed_packetdefer_connectauth_plugin_mapserver_public_keydbpasswd binary_prefix

执行 SQL

cursor.execute(sql, args) 执行单条 SQL

# 获取游标
cursor = connection.cursor()

# 创建数据表
effect_row = cursor.execute(&#39;&#39;&#39;
CREATE TABLE `users` (
  `name` varchar(32) NOT NULL,
  `age` int(10) unsigned NOT NULL DEFAULT &#39;0&#39;,
  PRIMARY KEY (`name`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8
&#39;&#39;&#39;)

# 插入数据(元组或列表)
effect_row = cursor.execute(&#39;INSERT INTO `users` (`name`, `age`) VALUES (%s, %s)&#39;, (&#39;mary&#39;, 18))

# 插入数据(字典)
info = {&#39;name&#39;: &#39;fake&#39;, &#39;age&#39;: 15}
effect_row = cursor.execute(&#39;INSERT INTO `users` (`name`, `age`) VALUES (%(name)s, %(age)s)&#39;, info)

connection.commit()

로그인 후 복사

executemany(sql, args) 批量执行 SQL

# 获取游标
cursor = connection.cursor()

# 批量插入
effect_row = cursor.executemany(
    &#39;INSERT INTO `users` (`name`, `age`) VALUES (%s, %s) ON DUPLICATE KEY UPDATE age=VALUES(age)&#39;, [
        (&#39;hello&#39;, 13),
        (&#39;fake&#39;, 28),
    ])

connection.commit()

로그인 후 복사

注意：INSERT、UPDATE、DELETE 等修改数据的语句需手动执行connection.commit()完成对数据修改的提交。

获取自增 ID

cursor.lastrowid

로그인 후 복사

查询数据

# 执行查询 SQL
cursor.execute(&#39;SELECT * FROM `users`&#39;)

# 获取单条数据
cursor.fetchone()

# 获取前N条数据
cursor.fetchmany(3)

# 获取所有数据
cursor.fetchall()

로그인 후 복사

游标控制

所有的数据查询操作均基于游标，我们可以通过cursor.scroll(num, mode)控制游标的位置。

cursor.scroll(1, mode=&#39;relative&#39;) # 相对当前位置移动
cursor.scroll(2, mode=&#39;absolute&#39;) # 相对绝对位置移动

로그인 후 복사

设置游标类型

查询时，默认返回的数据类型为元组，可以自定义设置返回类型。支持5种游标类型：

Cursor: 默认，元组类型
DictCursor: 字典类型
DictCursorMixin: 支持自定义的游标类型，需先自定义才可使用
SSCursor: 无缓冲元组类型
SSDictCursor: 无缓冲字典类型

无缓冲游标类型，适用于数据量很大，一次性返回太慢，或者服务端带宽较小时。源码注释：

Unbuffered Cursor, mainly useful for queries that return a lot of data, or for connections to remote servers over a slow network.
Instead of copying every row of data into a buffer, this will fetch rows as needed. The upside of this is the client uses much less memory, and rows are returned much faster when traveling over a slow network
or if the result set is very big.
There are limitations, though. The MySQL protocol doesn't support returning the total number of rows, so the only way to tell how many rows there are is to iterate over every row returned. Also, it currently isn't possible to scroll backwards, as only the current row is held in memory.

创建连接时，通过 cursorclass 参数指定类型：

connection = pymysql.connect(host=&#39;localhost&#39;,
                             user=&#39;root&#39;,
                             password=&#39;root&#39;,
                             db=&#39;demo&#39;,
                             charset=&#39;utf8&#39;,
                             cursorclass=pymysql.cursors.DictCursor)

로그인 후 복사

也可以在创建游标时指定类型：

cursor = connection.cursor(cursor=pymysql.cursors.DictCursor)

로그인 후 복사

事务处理

开启事务

connection.begin()

提交修改

connection.commit()

回滚事务

connection.rollback()

防 SQL 注入

转义特殊字符
connection.escape_string(str)
参数化语句
支持传入参数进行自动转义、格式化 SQL 语句，以避免 SQL 注入等安全问题。

# 插入数据(元组或列表)
effect_row = cursor.execute(&#39;INSERT INTO `users` (`name`, `age`) VALUES (%s, %s)&#39;, (&#39;mary&#39;, 18))

# 插入数据(字典)
info = {&#39;name&#39;: &#39;fake&#39;, &#39;age&#39;: 15}
effect_row = cursor.execute(&#39;INSERT INTO `users` (`name`, `age`) VALUES (%(name)s, %(age)s)&#39;, info)

# 批量插入
effect_row = cursor.executemany(
    &#39;INSERT INTO `users` (`name`, `age`) VALUES (%s, %s) ON DUPLICATE KEY UPDATE age=VALUES(age)&#39;, [
        (&#39;hello&#39;, 13),
        (&#39;fake&#39;, 28),
    ])

로그인 후 복사

参考资料

Python中操作mysql的pymysql模块详解
Python之pymysql的使用

Parameter	Description
host	데이터베이스 서버 주소, 기본 localhost
user	사용자 이름, 기본 로그인 현재 프로그램을 실행 중인 사용자
password	의 비밀번호, 기본값은 빈 문자열
database	기본 운영 데이터베이스
port	데이터베이스 포트, 기본값은 3306
바인드_ address	클라이언트에 여러 네트워크 인터페이스가 있는 경우 호스트에 연결할 인터페이스를 지정합니다. 매개변수는 호스트 이름 또는 IP 주소일 수 있습니다.
unix_socket	unix 소켓 주소, 호스트 연결과 다름
read_timeout	읽기 데이터 시간 초과, 단위 초, 기본값 무제한
write_timeout	쓰기 데이터 시간 초과, 단위 초, 기본값 무제한
charset	데이터베이스 인코딩
sql_mode	지정 기본 SQL_MODE
read_default_file	[client] 섹션에서 이러한 매개변수를 읽을 my.cnf 파일을 지정합니다. v
	use_unicode
	client_flag
	connect_timeout
	ssl
	read_default_group
자동 제출 여부에 관계없이 기본값은 자동 제출이 아니며 매개변수 값은 없음입니다. LOAD DATA LOCAL 명령 사용을 활성화하는 것은 서버
부울의 영향을 받습니다. (기본값: False)
서버로 전송되는 최대 데이터 양, 기본값은 16MB입니다.
지연 연결 여부, 기본값은 즉시 연결입니다
해당 플러그인을 처리하는 클래스에 대한 플러그인 이름 딕셔너리입니다. 클래스는 연결 개체를 인수로 사용합니다. 생성자 클래스에는 인증 패킷을 인수로 사용하는 인증 방법이 필요합니다(인증 방법이 없는 경우). (실험적)
SHA256 인증 플러그인 공개 키 값(기본값: 없음)
매개변수 데이터베이스 별칭
매개변수 비밀번호 별칭
_binary 접두사 추가 바이트 및 바이트 배열(기본값: False)