22、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…) 构造函数来创建数据库连接，返回一个连接对象，参数依赖于具体数据库。

模块必须定义以下全局变量：
| 变量名 | 说明 | 可能的值 |
| ---- | ---- | ---- |
| apilevel | 支持的 DB API 级别 | 目前仅允许 “1.0” 和 “2.0”，未指定时默认为 1.0 级别接口 |
| threadsafety | 接口支持的线程安全级别 | 0 - 线程不能共享模块；1 - 线程可共享模块，但不能共享连接；2 - 线程可共享模块和连接；3 - 线程可共享模块、连接和游标 |
| paramstyle | 接口期望的参数标记格式类型 | qmark - 问号风格，如 …WHERE name=?；numeric - 数字、位置风格，如 …WHERE name=:1；named - 命名风格，如 …WHERE name=:name；format - ANSI C printf