登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  python教程

Python sqlite3.Connection.total_changes 怎样统计连接累计修改行数

来源:17golang原创

时间:2026-11-19 18:02:01 422浏览 收藏

如果你想知道一个 SQLite 连接从打开以后累计改了多少行,Python 的 sqlite3.Connection.total_changes 就是对应入口。它统计这个连接创建后被修改、插入或删除的行数,适合观察一段批量写入的累计结果;如果只想知道最近一条 DML 语句影响了多少行,则应看游标的 rowcount。

官方地址:https://docs.python.org/3/library/sqlite3.html#sqlite3.Connection.total_changes

total_changes 的统计范围是什么

total_changes 是连接对象的只读属性,统计范围从 Connection 打开开始计算,关注的是数据库行被修改、插入或删除的累计数量。它不是某一个游标的临时结果,也不是所有连接共享的全局计数。

因此,批量写入完成后可以直接读取连接属性:

import sqlite3

con = sqlite3.connect(":memory:")
try:
    # 建表不会作为业务数据修改量来统计,后续 DML 才是重点。
    con.execute("CREATE TABLE task(id INTEGER PRIMARY KEY, name TEXT)")

    # executemany 会在同一个连接上执行多次插入。
    con.executemany(
        "INSERT INTO task(name) VALUES (?)",
        [("编译",), ("测试",), ("发布",)],
    )

    # total_changes 读取的是当前连接打开以来的累计修改行数。
    print(con.total_changes)
finally:
    # 无论统计结果如何,都要释放连接资源。
    con.close()
Connection、DML 和 total_changes 的连接级统计关系说明图
图1:结构说明图,展示 Connection 级累计计数与 INSERT、UPDATE、DELETE 等 DML 来源的关系。

使用时要记住三个边界:计数属于当前连接;它是累计值;它描述修改量,不描述 SELECT 返回了多少行。若程序建立了第二个连接,第二个连接不会继承第一个连接的计数。

total_changes 和 rowcount 怎么选

Cursor.rowcount 更适合回答“刚才这条 DML 语句影响了多少行”,而 Connection.total_changes 更适合回答“这个连接累计影响了多少行”。两者可以同时使用,但不能互相替代。

import sqlite3

con = sqlite3.connect(":memory:")
try:
    # 初始化数据,让后面的 UPDATE 有明确对象。
    con.execute("CREATE TABLE task(id INTEGER PRIMARY KEY, done INTEGER)")
    con.executemany("INSERT INTO task(done) VALUES (?)", [(0,), (0,), (1,)])

    cur = con.execute("UPDATE task SET done = 1 WHERE done = 0")
    # rowcount 只看这次 UPDATE,total_changes 还包含此前的 INSERT。
    print("本条语句:", cur.rowcount)
    print("连接累计:", con.total_changes)

    # SELECT 不是修改语句,不要用 rowcount 判断查询结果行数。
    rows = con.execute("SELECT id FROM task WHERE done = 1").fetchall()
    print("查询行数:", len(rows))
finally:
    con.close()
Connection.total_changes 与 Cursor.rowcount 统计口径边界说明图
图2:边界说明图,对比连接级累计值、游标语句级值和 SELECT 查询结果。

官方文档对 rowcount 的定义也更接近语句级结果:它针对 INSERT、UPDATE、DELETE 和 REPLACE 等修改语句更新;其他语句不应拿它当作通用结果计数器。

放进批量写入和事务代码时要注意什么

批量导入时,total_changes 很适合做“本次连接累计处理量”的日志字段。例如一段导入逻辑可以在批次结束记录一次累计值,再用开始时的快照计算本批增量:

before = con.total_changes

# 这里执行本批次的 INSERT、UPDATE 或 DELETE。
con.executemany("UPDATE task SET done = ? WHERE id = ?", [(1, 1), (1, 2)])

after = con.total_changes
batch_changes = after - before
print("本批修改量:", batch_changes)

这个写法的关键是保存快照,而不是把累计值误当成当前批次的结果。事务是否最终提交,则应由明确的 commit()、rollback() 和业务错误处理共同决定;total_changes 本身不替代提交成功记录、业务审计或跨连接汇总。

常见问题

total_changes 会在 commit() 后自动清零吗?

不要把它当作事务计数器使用。它的定义是连接打开后的累计值,若需要统计单次事务或单个批次,应在边界前保存快照并计算差值。

为什么第二个连接读到的 total_changes 不一样?

因为统计范围绑定在 Connection 对象上。多连接程序要分别记录各连接的变化量,再由业务层决定是否汇总。

查询结果行数应该怎么看?

执行 SELECT 后直接获取结果集并使用 len(rows),或按业务需要迭代统计;不要把 rowcount 当成查询结果行数接口。

小结

  • Connection.total_changes:当前连接打开后的累计修改、插入和删除行数。
  • Cursor.rowcount:更适合查看最近一条 DML 语句的影响行数。
  • 批量统计:保存起始快照,用结束值减去起始值,避免累计口径干扰。
声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>