只想撤销 SQLite 的部分操作:使用 Python 的 SAVEPOINT 回滚失败行

プログラミング・Web開発カテゴリを表すパンダのイラスト 编程・Web开发

关于本文
本文是通过利用生成式 AI 的自动化生成流程创建的。基于 Python 官方的 sqlite3 以及 SQLite 官方的 SAVEPOINT 规范,整理了通过虚拟订单数据学习局部撤销的操作步骤。

验证状态:📘 已确认官方规范・未在实际环境中运行所附代码
我们已确认 SAVEPOINT 和 ROLLBACK TO 的规范。虽然本次确认了相关代码,但实际业务数据库中的表现以及多连接下的行为尚未经过验证。

只想撤销 SQLite 的部分操作:使用 Python 的 SAVEPOINT 回滚失败行

当从 CSV 或 API 导入订单数据时,如果 3 条数据中有 1 条的数量不合法,应该回滚到什么程度?如果全部重来,连正常的数据也会丢失。另一方面,如果忽略失败继续操作,可能会留下不合法的数据。

SQLite 的SAVEPOINT(保存点)是一种在事务进行中设置“可回滚至此”标记的机制。通过 Python 标准库执行 SQL,你可以创建一个仅撤销特定处理单元、同时继续其他处理的示例。但这并不意味着“可以直接无条件丢弃失败行”。同时还需要记录通过与拒绝的情况并进行条数核对。sqlite3

目标环境与可确认内容

项目内容
目标Python 3、标准库 sqlite3、SQLite
附加软件包不需要
数据内存中的虚拟订单数据。不修改实际文件
确认的现象保留正常行,仅回滚错误行中途的更新
未确认所发布代码的本次执行、实际数据库、并发连接、停电、大规模性能

以下示例中处理订单号和数量。仅使用虚拟数据,:memory:由于限定于此类内存数据库,因此不会破坏现有的业务文件。

使用 SAVEPOINT 进行小规模尝试

将以下内容保存为savepoint_demo.py,并在python savepoint_demo.py中运行。代码中的BEGIN用于开始整个事务,并在处理每一行之前设置SAVEPOINT one_order。

import sqlite3

orders = [
    ("A001", 3),
    ("A002", -2),
    ("A003", 5),
]

# メモリ内だけで試す。業務DBやファイルは変更しない。

con = sqlite3.connect(":memory:", isolation_level=None)
try:
    con.execute("CREATE TABLE orders (code TEXT PRIMARY KEY, qty INTEGER NOT NULL CHECK(qty > 0))")
    con.execute("BEGIN")
    accepted = []
    rejected = []

    for code, qty in orders:

        # 1件ずつ取り消せる位置を作る

        con.execute("SAVEPOINT one_order")
        try:
            con.execute("INSERT INTO orders(code, qty) VALUES (?, ?)", (code, qty))
        except sqlite3.IntegrityError:

            # この行の更新だけを戻す

            con.execute("ROLLBACK TO SAVEPOINT one_order")
            con.execute("RELEASE SAVEPOINT one_order")
            rejected.append(code)
        else:
            con.execute("RELEASE SAVEPOINT one_order")
            accepted.append(code)

    # 取り込み件数が合わなければ、全体を確定しない

    if len(accepted) + len(rejected) != len(orders):
        raise RuntimeError("件数が一致しません")
    con.execute("COMMIT")

    rows = con.execute("SELECT code, qty FROM orders ORDER BY code").fetchall()
    print("採用:", accepted)
    print("拒否:", rejected)
    print("保存:", rows)
except Exception:

    # 未確定の全体取引が残っていれば取り消す

    if con.in_transaction:
        con.execute("ROLLBACK")
    raise
finally:
    con.close()

预期的显示为,采用['A001', 'A003'],拒绝['A002'],保存的行数[('A001', 3), ('A003', 5)]。这是从规范推导出的期望值,并非本次的执行日志。 在自己的环境中运行后,请确认是否为采用 2 条、拒绝 1 条、保存 2 行。

为什么只有无效行会被回滚

qty列上设置了CHECK(qty > 0)这一约束。如果数量不是正数,INSERT就会失败,在Python侧通常可以作为sqlite3.IntegrityError捕获到。ROLLBACK TO SAVEPOINT会取消该标记之后的更改,但标记本身依然存在。因此接着执行RELEASE SAVEPOINT来关闭该标记。

RELEASE并不是确认外部事务的指令。在整个COMMIT成功之前,导入结果并未最终确定。这种区别非常重要。如果混淆了部分撤销与整体确认,就会产生“以为保存成功了却又回滚了”的误解。

更改一个条件

将输入的("A002", -2)修改为("A002", 2)并重新运行。为了满足约束,预期这3条记录都会被采纳,拒绝列表为空数组。在不改变其他行或表定义的前提下,仅凭数量的正负号来观察结果的变化。

接下来,作为另一个实验,如果让订单号重复,这次可能会因为PRIMARY KEY的唯一性约束而失败。即使是相同的IntegrityError原因也可能不同,因此请在业务日志中记录异常类型、目标行的标识符以及约束违反的分类。同时,切记不要将机密值或个人信息直接从异常文本中输出到外部。

失败时的排查

症状检查位置处理思路
no such savepointSAVEPOINT 名称与 RELEASE 的顺序检查同名嵌套或重复的 RELEASE
cannot start a transaction within a transactionBEGIN 之前的事务状态统一 Python 的事务控制方式
残留无效行CHECK/UNIQUE 约束与 ROLLBACK TO重新审视约束拒绝了什么内容
所有数据被删除是否执行了外层的 ROLLBACK区分逐行拒绝与整体停止条件
条数不符接受、拒绝、输入条数在 COMMIT 之前停止并确认原因

本示例中isolation_level=None指定了并显式管理 SQL 的BEGIN・COMMIT。Python 的版本或autocommit由于不同设置对事务控制的处理方式有所不同,因此如果与其它连接设置混用,请查阅官方文档。

在业务中应用时的判断

只有在业务规则允许的情况下,才可以拒绝部分行。例如,对于计费数据,可能存在因一条错误数据而驳回整批数据的合适运营场景。订单号重复也不一定能简单地视为“已处理过故予以忽略”。必须区分这是重复发送还是不同订单的冲突。

如果要在实际业务中推进,需要设计:输入行数、采用行数和拒绝行数的核对;拒绝原因的安全记录;重新投入时的重复防止;以及整体取消的条件。即使内存中的实验成功,也并不证明磁盘故障或并发更新时的安全性已经得到保证。

官方文档与验证范围

本文参考了截至 2026 年 11 月 16 日的官方规范编写。文中的代码尚未进行实际执行、SQLite 实际文件验证以及 WordPress 上的显示验证。文中省略了图表,改用代码处理顺序和隔离表进行说明。

文档信息

文章??
只想撤销 SQLite 的部分操作:使用 Python 的 SAVEPOINT 回滚失败行
?布日期
更新日期
来源
https://papanda925.com/?p=18659&lang=zh

?可: ?于本站?有相??利的正文及原??表,除非?有?明,可依据 CC BY 4.0 使用。本文可能包含使用生成式AI?建或??的内容。若代??有?可声明,或?接的GitHub???定了?可,?代?以??可?准。引用内容、第三方?料、?片及商?不在本?可范?内。 使用政策

标题和URL已复制