21、Python Database API 2.0 详解

Python Database API 2.0 详解

1. 概述

Python Database API 2.0 旨在促进访问数据库的 Python 模块之间的相似性，以实现模块的一致性，使代码更易于理解，在不同数据库间更具可移植性，并拓宽 Python 与数据库的连接范围。该接口规范包含以下几个部分：
- 模块接口
- 连接对象
- 游标对象
- 类型对象和构造函数
- 实现提示
- 从 1.0 到 2.0 的主要变化

2. 模块接口

访问数据库通过连接对象实现，模块必须提供 connect(parameters…) 构造函数来创建数据库连接，该函数返回一个 Connection 对象，其参数依赖于具体数据库。

模块必须定义以下全局变量：
| 变量名 | 描述 | 可能的值 |
| ---- | ---- | ---- |
| apilevel | 表示支持的 DB API 级别，当前仅允许 ‘1.0’ 和 ‘2.0’ | ‘1.0’, ‘2.0’ |
| threadsafety | 表示接口支持的线程安全级别 | 0: 线程不能共享模块；1: 线程可共享模块，但不能共享连接；2: 线程可共享模块和连接；3: 线程可共享模块、连接和游标 |
| paramstyle | 表示接口期望的参数标记格式类型 | ‘qmark’: 问号风格，如 …WHERE name=?；’numeric’: 数字、位置