当前位置：首页 > 文章列表 > 文章 > python教程 > Python sqlite3.Row 如何让查询结果支持列名访问：row_factory、类型转换与空值检查

Python sqlite3.Row 如何让查询结果支持列名访问：row_factory、类型转换与空值检查

来源：17golang原创 2026-08-30 12:16:53 0浏览收藏

订单列表从元组改成按列名读取后，代码会更好懂，但真正容易踩坑的地方在结果边界：sqlite3.Row 只改变行的访问方式，不会把 NULL 变成空字符串，也不会替你设计金额和时间的业务类型。把 row_factory、列名访问和 Python 类型一次核对清楚，读取层就不容易在后续拼装响应时失真。

要点速览

把 connection.row_factory 设为 sqlite3.Row 后，游标返回的行支持列名和下标两种访问。
Row.keys() 能核对查询列名，窗口列 total_rows 也会进入同一个行对象。
SQLite 的 INTEGER、REAL、NULL 分别对应 Python 的整数、浮点数和 None。
业务层仍要显式判断 None；金额为 0.0 不是缺失值。

先把 Row 的访问边界跑出来

下面的实验只使用内存数据库，表结构和查询就是文章中后续判断的依据。查询固定取订单 1002，它的金额是 0.0，发货时间是 SQL NULL，这样可以把“零值”和“缺失”同时放到输出里。

connection = sqlite3.connect(":memory:")
connection.row_factory = sqlite3.Row
row = connection.execute(
    """
    SELECT order_id, customer, amount, shipped_at,
           COUNT(*) OVER () AS total_rows
    FROM orders
    WHERE order_id = ?
    """,
    (1002,),
).fetchone()

Python sqlite3.Row 运行结果显示列名访问、下标访问和 keys 列表 — 图1：检查终端中的 row_type、keys 和两种访问结果；列名能取到 customer，说明 row_factory 已作用于查询行。

输出中的 row_type= Row 是第一道检查。接着看 keys=：它列出 order_id、customer、amount、shipped_at 和 total_rows，说明查询别名也成为行的可访问列名。row["customer"] 与 row[1] 得到同一个客户值，但代码里更推荐列名写法，查询调整列顺序时不容易把业务字段读错。

row_factory 影响的是行对象，不是数据类型

row_factory 可以设置在连接上，也可以设置在游标上。连接级设置会影响之后创建的游标；已经创建的游标不会因为事后修改连接属性而追溯改变。这个时机在封装数据库访问类时很重要，通常应在创建游标前完成设置。

本例的 amount 来自 SQLite 的 REAL 列，读取后是 Python float；order_id 是 int。COUNT(*) OVER () 的结果也按整数返回，所以它可以直接作为列表总数使用，但分页接口仍要根据自己的查询范围设计统计口径。

Python sqlite3.Row 终端输出显示 INTEGER、REAL、NULL 对应的 Python 类型和 None 判断 — 图2：核对 python_types、null_check 和 zero_amount；None 表示 SQL NULL，0.0 仍是有效金额值。

NULL、零值和业务转换要分三层处理

终端中的 python_types= int float NoneType 说明驱动已经完成基础类型映射，但这不等于业务校验完成。发货时间为空时，可以把它显示为“待发货”；金额为零时，则应保留为 0.0，不能用 if not row["amount"] 把它误判成缺失。

shipped_at = row["shipped_at"]
if shipped_at is None:
    display_time = "待发货"
else:
    display_time = shipped_at

amount = row["amount"]
if amount is None:
    raise ValueError("amount must not be NULL")

如果接口需要十进制金额、日期对象或枚举状态，应在读取层之后增加明确的转换函数，并保留转换失败的字段名。不要把所有列一股脑转成字符串，否则前端看到的“0.0”和后端的数值比较会失去边界。