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=, 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查询操作:
importpymysql#创建数据库链接,分别指定主机、用户、密码和数据库名,必须保证用户有权限链接
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)获取字典类型数据:
importpymysql#创建数据库链接,分别指定主机、用户、密码和数据库名,必须保证用户有权限链接
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更新操作:
importpymysql
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)插入多条语句:
importpymysql
conn= pymysql.connect(host='10.0.1.198',port=3306,user='test1',passwd='123.com',db='test')
cursor=conn.cursor()
l1=[
('k1','aa',22,'2222'),
('k2','bb',23,'3333'),
('k3','cc',24,'4444'),
('k4','dd',25,'5555')
]#定义数据库语句
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
importpymysql
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
importpymysql#创建数据库链接,分别指定主机、用户、密码和数据库名,必须保证用户有权限链接
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的子类。
-----------------------------------------------------------------------------------------------------------------------------------------