数据库接口 / DB-API


在Python中,数据库是通过适配器(Adaptor)来连接访问数据库的,适配器通常与数据库客户端接口(通常为C语言编写)想连接,而不同的适配器都会尽量满足相同的DB-API标准。

为了保证不同数据库的数据库接口能够通用于适配器,以减少使用不同数据库接口是需要对代码进行大幅改动,Python的DB-SIG(数据库特殊兴趣小组)制定了DB-API的标准,该API为不同的关系数据库提供了一致的接口,使得使用不同数据库的代码间移植变得更加简单。数据库接口目前的版本为DB-API(2.0),可前往Python官网查看最新版本

通用标准 / General Standard

对于任意的数据库适配器db,需要提供至少以下几项通用标准,以保证可移植性。

1 属性 / Attribute

1.1 apilevel属性

属性调用: al = db.apilevel

属性功能: 返回当前适配器支持的DB-API版本

属性参数: al

al: str类型,目前支持"1.0"和"2.0"两种,如果该适配器未指定,则假定为"1.0"

1.2 threadsafety属性

属性调用: tsf = db.threadsafety

属性功能: 返回当前适配器支持的线程安全等级

属性参数: tsf

tsf: int类型,线程安全等级

threadsafety

Meaning

0

Threads   may not share the module.

1

Threads may share the module, but not connections.

2

Threads   may share the module and connections.

3

Threads   may share the module, connections and cursors.

1.3 paramstyle属性

属性调用: psy = db.paramstyle

属性功能: 返回当前适配器支持的参数风格

属性参数: psy

psy: str类型,参数风格的说明

paramstyle

Meaning

qmark

Question   mark style, e.g. ...WHERE name=?

numeric

Numeric,   positional style, e.g. ...WHERE name=:1

named

Named   style, e.g. ...WHERE name=:name

format

ANSI   C printf format codes, e.g. ...WHERE name=%s

pyformat

Python   extended format codes, e.g. ...WHERE name=%(name)s

2 函数 / Function

2.1 connect ()函数

函数调用: cnx = db.connect/Connection/Connect(*args, **kwargs)

函数功能:生成一个数据库的连接对象

传入参数: args, kwargs

host: str类型,连接的主机地址,未传入或‘localhost’都将连接本地数据库

user: str类型,登入数据库的用户名

password/passwd: str类型,登录数据库的密码

database/db: str类型,使用的数据库schema名称

返回参数: cnx

cnx: obj类型,一个数据库连接实例

3 / Class

3.1 Connection

类实例化:cnx = db.connect/Connection/Connect(*args, **kwargs)

类的功能:用于联系数据库API的连接对象

传入参数: args, kwargs

host: str类型,连接的主机地址,未传入或‘localhost’都将连接本地数据库

user: str类型,登入数据库的用户名

password/passwd: str类型,登录数据库的密码

database/db: str类型,使用的数据库schema名称

返回参数: cnx

cnx: obj类型,一个数据库连接实例

3.1.1 close()方法

函数调用: cnx.close()

函数功能:关闭数据库连接

传入参数:

返回参数:

3.1.2 commit()方法

函数调用: cnx.commit()

函数功能:提交当前事务,通常当命令具有执行修改等性质的时候需要此函数完成确认

传入参数:

返回参数:

3.1.3 rollback()方法

函数调用: cnx.rollback()

函数功能:取消当前事务

传入参数:

返回参数:

3.1.4 cursor()方法

函数调用: cur = cnx.cursor()

函数功能:使用该连接对象创建返回一个游标对象

传入参数:

返回参数: cur

cur: obj类型,游标对象的实例,可以通过游标进行操作数据库

3.2 Cursor

类实例化:cur = cnx.cursor()

类的功能:一个用于操作数据库的游标对象

传入参数: args, kwargs

host: str类型,连接的主机地址,未传入或‘localhost’都将连接本地数据库

user: str类型,登入数据库的用户名

password/passwd: str类型,登录数据库的密码

database/db: str类型,使用的数据库schema名称

返回参数: cnx

cnx: obj类型,一个数据库连接实例

3.2.1 arraysize属性

属性调用: as = cur.arraysize

属性功能: 表示使用fetchmany()方法时,一次性取出的结果行数,默认为1

属性参数: as

as: int类型,一次性fetch的行数

3.2.2 connection属性

属性调用: cnx = cur.connection

属性功能: 返回生成该游标的connection实例

属性参数: cnx

cnx: obj类型,生成当前游标的连接实例

3.2.3 description属性

属性调用: dsp = cur.description

属性功能: 返回当前游标的活动状态

属性参数: dsp

dsp: tuple/NoneType类型,一个7元素元组描述当前状态

3.2.4 lastrowid属性

属性调用: rid = cur.lastrowid

属性功能: 上次修改行的ID,不支持则返回None

属性参数: rid

rid: int/NoneType类型,修改的行ID

3.2.5 rowcount属性

属性调用: roc = cur.rowcount

属性功能: 上次execute*()修改行所影响的行数

属性参数: roc

roc: int类型,修改影响的行数

3.2.6 close()方法

函数调用: cur.close()

函数功能:关闭游标

传入参数:

返回参数:

3.2.7 execute()方法

函数调用: [r =] cur.execute(query, args=None)

函数功能:执行数据库命令

传入参数: query, args

query: str类型,执行的SQL命令行

args: sequence/mapping类型,query使用的参数

返回参数: r

r: int类型,执行所影响的行数

3.2.8 executemany()方法

函数调用: [r =] cur.executemany(query, args)

函数功能:执行多条数据库命令,类似execute()和map()的结合

传入参数: query, args

query: str类型,执行的SQL命令行

args: sequence/mapping类型,query使用的参数

返回参数: r

r: int类型,执行所影响的行数

3.2.9 fetchone()方法

函数调用: r = cur.fetchone()

函数功能:获取查询结果的下一行

传入参数:

返回参数: r

r: tuple类型,查询结果的下一条信息的元组

3.2.10 fetchmany()方法

函数调用: r = cur.fetchmany(size=cursor.arraysize)

函数功能:获取查询结果的下n行,默认为arraysize的设置值

传入参数: size

size: int类型,查询下n行

返回参数: r

r: tuple类型,查询结果的下n条信息的元组

3.2.11 fetchall()方法

函数调用: r = cur.fetchall()

函数功能:获取查询结果的所有(剩余)行

传入参数:

返回参数: r

r: tuple类型,查询结果的所有剩余信息元组

4 补充知识 / Complement Knowledge

4.1 CursorConnection

在MySQL中,Connection生成的实例利用query函数已经可以完成基本的SQL数据库操作,而Cursor的execute功能与其类似,但是引入Cursor可以使在不必要的时候销毁Cursor节省资源占用,同时无需断开连接。参考 stack overflow 链接

5 应用实例 / Complement Knowledge

下面的例子中将构建一个简单的通用适配器驱动,其中实现了各种适配器通用的函数方法。

 class SqlConnector():
def __init__(self, adaptor):
self.adaptor = adaptor
self.result = None
# Check Adaptor info
print('Adaptor %s apply DB-API %s, thread safety: %d, parameter style: %s' % (adaptor.__name__, adaptor.apilevel, adaptor.threadsafety, adaptor.paramstyle)) # Login by user name and password
def login(self, **kwargs):
# Create a connection obj
self.cnx = self.adaptor.connect(**kwargs) def logoff(self):
self.cnx.close() def query_sql(self, sql, show=True):
# Method one: Use Connection
'''
self.cnx.query(sql)
self.result = self.cnx.store_result()
r = self.result.fetch_row(0, )
self.cnx.commit()
'''
# Method two: Use Cursor
cur = self.cnx.cursor()
cur.execute(sql)
r = cur.fetchall()
self.cnx.commit()
cur.close() if show:
splt = '\n' + ((len(sql)+6)*'-')
msg = ''.join(('\n{: ^10} | ').format(str(i)) if x.index(i) == 0 else ('{: ^10} | ').format(str(i)) for x in r for i in x)
s = ('{:-^%d}'%(len(sql)+6)).format(sql) + msg + splt
print(s)
return (i for x in r for i in x) def exec_sql(self, sql):
cur = self.cnx.cursor()
cur.execute(sql)
self.cnx.commit()
cur.close() def commit(self):
self.cnx.commit() if __name__ == '__main__':
import MySQLdb
import pymssql
r = input('Please choose your adaptor:\n(M)MySQL\n(S)MsSQL\n')
adaptor_list = {'M': MySQLdb, 'S': pymssql}
c = SqlConnector(adaptor_list[r.upper()])
# No local MSSQL server
c.login(host='localhost', user='root', password='root')
c.logoff()

第 1-6 行,建立适配器的类,在初始化用利用适配器的通用属性查看适配器的基本信息,包括适配器名称,使用的DB-API等级,线程安全等级,参数风格等。

第 8-14 行,定义登录退出函数,登录时创建连接实例,退出时关闭。

第 16-36 行,定义请求函数,对于数据库的操作有两种方式实现,第一种是使用Connection,第二种是使用Cursor,同时对请求的结果进行显示。

第 38-45 行,定义执行函数,用于执行SQL的命令语句,对于有修改性质的语句必须commit后才能在数据库端生效。

第 47-55 行,最后仅对数据库进行登录退出测试,由于本地仅安装了MYSQL,没有安装MSSQL的服务器,因此无法登录MSSQL。

运行结果如下

Please choose your adaptor:
(M)MySQL
(S)MsSQL
M
Adaptor MySQLdb apply DB-API 2.0, thread safety: 1, parameter style: format

参考链接


https://www.python.org/dev/peps/pep-0249/

https://stackoverflow.com/questions/10660411/difference-between-cursor-and-connection-objects/10660537#10660537

Python与数据库[1] -> 数据库接口/DB-API[0] -> 通用标准的更多相关文章

  1. Python与数据库[1] -> 数据库接口/DB-API[1] -> MySQL 适配器

    MySQL适配器 / MySQL Adapter MySQL是一种关系型数据库,下面主要介绍利用如何利用Python的MySQL适配器来对MySQL进行操作,其余内容可参考文末相关阅读. 1 MySQ ...

  2. Python与数据库[1] -> 数据库接口/DB-API[3] -> ODBC 适配器

    ODBC适配器 / ODBC Adaptor ODBC(Open Database Connectivity,开放数据库互连)是微软公司开放服务结构(WOSA,Windows Open Service ...

  3. Python与数据库[1] -> 数据库接口/DB-API[2] -> SQL Server 适配器

    SQL_Server适配器 / SQL_Server Adapter 1 环境配置 / Environment Configuration 安装SQL_Server的Python适配器包 pip in ...

  4. 【Python+Django+Pytest】数据库异常pymysql.err.InterfaceError: (0, '') 解决方案

    问题背景: 接口自动化测试平台,在执行测试案例之外,还需要做以下五件事情(或步骤): 1.查询用户在数据准备中预置的测试套件层数据初始化相关sql  (setUp_class方法中) 2.查询用户在数 ...

  5. Python与数据库

    链接汇总 https://www.cnblogs.com/stacklike/category/1134822.html Python与数据库[1] -> 数据库接口/DB-API[0] -&g ...

  6. Atitit.跨语言数据库db  api兼容性 jdbc odbc ado oledb 增强方案

    Atitit.跨语言数据库db  api兼容性 jdbc odbc ado oledb 增强方案 1. 跨语言db api兼容性..1 2. 目前访问数据库的接口很多.比较常用的jdbc odbc 以 ...

  7. Python DB API 连接数据库

    Python DB API Mysql,Oracle,SqlServer 不关闭,会浪费资源.

  8. Python与数据库[0] -> 数据库概述

    数据库概述 / Database Overview 1 关于SQL / About SQL 构化查询语言(Structured Query Language)简称SQL,是一种特殊目的的编程语言,是一 ...

  9. 零基础学Python--------第11章 使用Python操作数据库

    第11章 使用Python操作数据库 11.1 数据库编程接口 在项目开发中,数据库应用必不可少.虽然数据库的种类有很多,如SQLite.MySQL.Oracle等,但是它们的功能基本都是一样的,为了 ...

随机推荐

  1. 《Cracking the Coding Interview》——第13章:C和C++——题目9

    2014-04-25 20:37 题目:请设计一个字节对齐的malloc函数,配套上对应的free函数.要求这个函数分配出的内存块儿的首地址是某个值n的整数倍,n是2的整次幂,比如128.1024之类 ...

  2. PL/SQL 循环语句

    1.基本 LOOP 循环语句 语法: LOOP 语句序列; END LOOP; 其中,语句序列中需要一个EXIT语句或一个EXIT WHEN语句来中断循环. 实例: DECLARE x ) :; BE ...

  3. 动态删边SPFA: [HNOI2014]道路堵塞

    [HNOI2014]道路堵塞 题目描述 $A$ 国有 $N$座城市,依次标为$1$到$N$.同时,在这$N$座城市间有$M$条单向道路,每条道路的长度是一个正整数.现在,$A$国交通部指定了一条从城市 ...

  4. Linux网卡驱动程序对ethtool的支持和实现

    Linux 的一个显著特点就是其强大的网络功能,Linux 几乎支持所有的网络协议,并在这些协议基础上提供了丰富的应用.对 Linux 网络管理的重要性不言而喻,这些管理依赖于网络工具,比如最常用的 ...

  5. A Neural Algorithm of Artistic Style

    本系列文章由 @yhl_leo 出品,转载请注明出处. 文章链接: http://blog.csdn.net/yhl_leo/article/details/53931536 1. 资源 Paper: ...

  6. HDU 3549 基础网络流EK算法 Flow Problem

    欢迎参加——BestCoder周年纪念赛(高质量题目+多重奖励) Flow Problem Time Limit: 5000/5000 MS (Java/Others)    Memory Limit ...

  7. Java9最受期待的5大新特性

    虽然Java9要等到明年才正式发布,但是现在网上已经有了各种各样的有关Java9新特性的文章了,今天小编也将为大家分享除了通常猜测之外的一些很值得期待的5个新特性. 1.Java + REPL = j ...

  8. [CF463D]Gargari and Permutations

    题目大意:给你$k(2\leqslant k\leqslant5)$个$1\sim n(n\leqslant10^3)$的排列,求它们的最长子序列 题解:将$k$个排列中每个元素的位置记录下来.如果是 ...

  9. BZOJ2594 [Wc2006]水管局长数据加强版 【LCT维护最小生成树】

    题目 SC省MY市有着庞大的地下水管网络,嘟嘟是MY市的水管局长(就是管水管的啦),嘟嘟作为水管局长的工作就是:每天供水公司可能要将一定量的水从x处送往y处,嘟嘟需要为供水公司找到一条从A至B的水管的 ...

  10. 纯css美化复选框,单选框,滑动条(range)

    <div class="box"> <!-- 借鉴地址:http://www.cnblogs.com/xiaoxianweb/p/5465607.html --& ...