如何让Python sqlite3驱动显示类型？为何cursor.description不返回PEP249要求的类型数据

原因解析 #

1. SQLite是动态类型数据库，即便你声明了字段类型，它也不会强制数据类型约束，Python内置sqlite3驱动默认不会将表声明的类型映射到PEP249要求的type_code字段。
2. detect_types=sqlite3.PARSE_DECLTYPES参数的作用是在读取查询结果时自动转换Python数据类型（例如将声明为DATE的字段转为datetime.date对象），而非填充cursor.description中的type_code。

解决技巧 #

方法1：自定义Cursor类补全type_code #

通过重写Cursor的execute方法，查询SQLite系统元数据获取字段类型，手动映射到PEP249要求的type_code：

import sqlite3
from sqlite3 import Cursor

class TypeAwareCursor(Cursor):
    def execute(self, sql, params=None):
        result = super().execute(sql, params)
        if self.description:
            # 提取查询涉及的表名（仅适配单表简单查询，复杂查询需调整逻辑）
            table_name = sql.strip().split()[-1].strip('`"[]')
            # 查询字段元数据
            self.execute(f"PRAGMA table_info({table_name})")
            col_metadata = self.fetchall()
            # 映射SQLite类型到Python类型（对应PEP249的type_code）
            type_mapping = {
                'INTEGER': int,
                'TEXT': str,
                'REAL': float,
                'BLOB': bytes,
                'NUMERIC': complex
            }
            # 重构description
            updated_desc = []
            for orig_col, meta in zip(self.description, col_metadata):
                col_type = meta[2].upper()
                type_code = type_mapping.get(col_type, None)
                updated_col = (orig_col[0], type_code) + orig_col[2:]
                updated_desc.append(updated_col)
            self._description = updated_desc
        return result

# 使用自定义Cursor
conn = sqlite3.connect('your_db.db', detect_types=sqlite3.PARSE_DECLTYPES)
conn.cursor_factory = TypeAwareCursor
cursor = conn.cursor()

注意：该示例仅适配单表查询，若涉及多表JOIN、视图等复杂查询，需要更复杂的SQL解析逻辑来提取字段所属表。

方法2：手动查询元数据补充类型 #

无需修改Cursor，每次查询后手动通过PRAGMA table_info(表名)获取字段类型，再结合cursor.description补全信息：

cursor.execute("SELECT * FROM your_table")
# 获取原始description
orig_desc = cursor.description
# 查询字段元数据
cursor.execute("PRAGMA table_info(your_table)")
col_meta = cursor.fetchall()
# 补全type_code
type_mapping = {'INTEGER': int, 'TEXT': str, ...}
full_desc = []
for col, meta in zip(orig_desc, col_meta):
    type_code = type_mapping.get(meta[2].upper(), None)
    full_desc.append((col[0], type_code) + col[2:])

总结 #

sqlite3驱动未在cursor.description中填充type_code是由于SQLite的动态类型特性及驱动设计取舍，PARSE_DECLTYPES仅作用于数据类型转换而非元数据填充。要获取符合PEP249要求的元数据，需通过查询SQLite系统元数据并手动映射类型。

内容的提问来源于stack exchange，提问作者AllAboutMike