python3之pymysql模块

1、python3 MySQL数据库链接模块

PyMySQL 是在 Python3.x 版本中用于连接 MySQL 服务器的一个库，Python2中则使用mysqldb。

PyMySQL 遵循 Python 数据库 API v2.0 规范，并包含了 pure-Python MySQL 客户端库。

PyMySQL模块下载地址：https://github.com/PyMySQL/PyMySQL

安装PyMySQL模块的方法：

#(1)pip方式安装
$pip install PyMySQL

#(2)克隆安装
$git clone https://github.com/PyMySQL/PyMySQL
　　$cd PyMySQL
　　$python3 setup.py install

#(3)源码安装
$ curl -L https://github.com/PyMySQL/PyMySQL/tarball/pymysql-X.X | tar xz
　　$ cd PyMySQL*
　　$python3 setup.py install

2、PyMySQL的API参考

（1）链接对象API：

classpymysql.connections.Connection(host=None, user=None, password='', database=None, port=0, unix_socket=None, charset='', sql_mode=None, read_default_file=None, conv=None, use_unicode=None, client_flag=0, cursorclass=<class 'pymysql.cursors.Cursor'>, init_command=None, connect_timeout=10, ssl=None, read_default_group=None, compress=None, named_pipe=None, no_delay=None, autocommit=False, db=None, passwd=None, local_infile=False, max_allowed_packet=16777216, defer_connect=False, auth_plugin_map={}, read_timeout=None, write_timeout=None, bind_address=None, binary_prefix=False)

使用MySQL服务器表示一个套接字，创建类实例的方法是调用connect()，将创建一个MySQL链接对象，建立连接可使用的参数如下：

host：数据库服务器主机名可以是IP或域名

user：用户登陆名

password：用户名密码
database：要使用的数据库名

port：端口号默认3306

bind_address：多网口是绑定网络接口，可以是主机名或IP

unix_socket：指定套接字链接

read_timeout：读取连接的超时时间

write_timeout：写入连接的超时时间

carset：指定字符集
sql_mode：指定SQL_MODE

read_defautl_file：指定my.cnf配置文件读取参数

init_command：建立连接时运行的初始SQL语句

链接对象使用的方法：

conn.close()   关闭链接

conn.commit()  提交更改到数据库服务器

conn.cursor(cursor=None)  创建一个新的游标来执行查询，cursor指定游标类型：Cursor、SSCursor、DictCursor或SSDictCursor，没有指定即使用光标

conn.open   如果链接处于打开状态则返回true

conn.ping(reconnect=True)  检查服务器是否存在，reconnect为True时重新链接

conn.rellback()   回滚当前事务

(2)游标对象API

class pymysql.cursors.Cursor(connection)  ：创建与数据库交换的对象，对象表示数据库游标，用于管理提取操作的上下文

游标的方法：

cursor.callproc(procname)  查看数据库存储过程

cursor.close() 关闭游标

cursor.execute(query,args=None) 执行查询，query查询参数为字符串，args可以是元组，列表或字典，用于查询的参数，返回类型为INT

cursor.executemany(query,seq_of_parameters) 多次查询返回结果

cursor.fetchall()  获取所有行

cursor.fetchmany(size=None) 获取指定的行数

cursor.fetchone() 获取下一行

cursor.max_stmt_length=1024000  executemany()生成的最大语句大小

cursor.mogrify(query,args=None)  通过调用execute()方法返回发送到数据库的字符串

（3）其它对象API

class pymysql.cursors.SSCursor(connection)  ：用于返回大量数据的查询

class pymysql.cursors.DictCursor(connection)  ：用于将结果作为字典返回的游标

class pymysql.cursors.SSDictCursor(connection)  ：用于无缓冲的游标，它将结果作为字典返回

3、pymysql使用

（1）MySQL查询操作：

import pymysql

#创建数据库链接，分别指定主机、用户、密码和数据库名,必须保证用户有权限链接
db=pymysql.connect('10.0.1.198','test1','123.com','test')

#创建游标对象
cursor = db.cursor()

#使用execute()方法执行SQL语句
cursor.execute('select * from test1')

#获取单条数据
print(cursor.fetchone())
#获取N条数据
print(cursor.fetchmany(3))

#获取所有数据，序列形式 
data = cursor.fetchall() 
print(data) 

#关闭游标 
cursor.close() 
#关闭链接 
db.close()

（2）获取字典类型数据：

import pymysql
#创建数据库链接，分别指定主机、用户、密码和数据库名,必须保证用户有权限链接
db=pymysql.connect('10.0.1.198','test1','123.com','test')
#创建游标对象，指定数据类型为字典，将打印key,value
cursor = db.cursor(cursor=pymysql.cursors.DictCursor)
#使用execute()方法执行SQL语句
cursor.execute('select * from test1')

#获取所有数据，字典形式
data = cursor.fetchall()
print(data)

#关闭数据库链接
db.close()

（3）MySQL更新操作：

import pymysql

conn = pymysql.connect(host='10.0.1.198',port=3306,user='test1',passwd='123.com',db='test')
cursor = conn.cursor()
sql = "update test1 set age=28 where id=4"
cursor.execute(sql)
#提交语句到数据库
conn.commit()
cursor.close()
conn.close()

（4）插入多条语句：

import pymysql

conn = pymysql.connect(host='10.0.1.198',port=3306,user='test1',passwd='123.com',db='test')
cursor = conn.cursor()
l1 = [
    ('k1','aa',22,''),
    ('k2','bb',23,''),
    ('k3','cc',24,''),
    ('k4','dd',25,'')
]
#定义数据库语句
sql = "insert into test1(name,sex,age,tel) values(%s,%s,%s,%s)"
#executemany()插入多条数据
cursor.executemany(sql,l1)
#获取新增数据自增ID
print(cursor.lastrowid)
#提交语句到数据库
conn.commit()
cursor.close()
conn.close()

（5）创建数据库表：

#!/usr/bin/env python
# -*- coding: utf-8 -*-
# @Time    : 2018/1/30 17:19
# @Author  : Py.qi
# @File    : create_database.py
# @Software: PyCharm

import pymysql

conn = pymysql.connect('10.0.1.198','test1','123.com')
#创建游标对象,字典输出
cursor = conn.cursor(cursor=pymysql.cursors.DictCursor)
cursor.execute('drop database if exists student')
cursor.execute("create database student character set 'utf8' collate utf8_general_ci")

#如果表存在则删除
cursor.execute('drop table if exists student.test2')
#sql建表语句
sql = '''create table student.test2(
    id int not null auto_increment primary key,
    name char(8) not null,
    age int not null)'''
#执行建表语句
cursor.execute(sql)

cursor.close()
conn.close()

（6）数据回滚操作：

#!/usr/bin/env python
# -*- coding: utf-8 -*-
# @Time    : 2018/1/30 14:53
# @Author  : Py.qi
# @File    : mysqldb_clien.py
# @Software: PyCharm

import pymysql
#创建数据库链接，分别指定主机、用户、密码和数据库名,必须保证用户有权限链接
db=pymysql.connect('10.0.1.198','test1','123.com','test')
#创建游标对象
cursor = db.cursor(cursor=pymysql.cursors.DictCursor)
#使用execute()方法执行SQL语句

sql2 = "insert into test1(name,sex,age,tel) values('zz','ee',21,'8999')"
try:
    cursor.execute(sql2)
    #提交到数据库执行
    db.commit()
except:
    #发生错误时回滚操作
    db.rollback()

#获取所有数据，序列形式
data = cursor.fetchall()
print(data)

#关闭数据库链接
cursor.close()
db.close()

（7）错误处理：

DB API中定义了一些数据库操作的错误及异常，下表列出了这些错误和异常:

异常	描述
Warning	当有严重警告时触发，例如插入数据是被截断等等。必须是 StandardError 的子类。
Error	警告以外所有其他错误类。必须是 StandardError 的子类。
InterfaceError	当有数据库接口模块本身的错误（而不是数据库的错误）发生时触发。 必须是Error的子类。
DatabaseError	和数据库有关的错误发生时触发。 必须是Error的子类。
DataError	当有数据处理时的错误发生时触发，例如：除零错误，数据超范围等等。 必须是DatabaseError的子类。
OperationalError	指非用户控制的，而是操作数据库时发生的错误。例如：连接意外断开、 数据库名未找到、事务处理失败、内存分配错误等等操作数据库是发生的错误。 必须是DatabaseError的子类。
IntegrityError	完整性相关的错误，例如外键检查失败等。必须是DatabaseError子类。
InternalError	数据库的内部错误，例如游标（cursor）失效了、事务同步失败等等。 必须是DatabaseError子类。
ProgrammingError	程序错误，例如数据表（table）没找到或已存在、SQL语句语法错误、 参数数量错误等等。必须是DatabaseError的子类。
NotSupportedError	不支持错误，指使用了数据库不支持的函数或API等。例如在连接对象上 使用.rollback()函数，然而数据库并不支持事务或者事务已关闭。 必须是DatabaseError的子类。

-----------------------------------------------------------------------------------------------------------------------------------------