この記事について
この記事は、生成AIを活用した自動生成フローで作成しています。Python公式のsqlite3とSQLite公式のSAVEPOINTの仕様をもとに、架空の注文データで部分的な取り消しを学ぶ手順を整理しました。検証ステータス:📘 公式仕様確認済み・掲載コードの実行は未確認
SAVEPOINTとROLLBACK TOの仕様を確認しました。掲載コードを今回実行した結果、実際の業務データベース、複数接続での挙動はまだ確認していません。
SQLiteの一部だけ取り消したい:PythonのSAVEPOINTで失敗行を戻す
CSVやAPIから注文データを取り込むとき、3件のうち1件だけ数量が不正だったら、どこまで戻すべきでしょうか。全件をやり直すと正常な行まで失われます。一方、失敗を無視して進めると、不正なデータが残るおそれがあります。
SQLiteのSAVEPOINT(セーブポイント)は、トランザクションの途中に「ここまで戻れる」という目印を付ける仕組みです。Python標準ライブラリのsqlite3からSQLを実行すれば、特定の処理単位だけを取り消し、ほかの処理を続ける例を作れます。ただし「失敗行を無条件に捨てればよい」という意味ではありません。採用・拒否の記録と件数照合も必要です。
対象環境と確認できること
| 項目 | 内容 |
|---|---|
| 対象 | Python 3、標準ライブラリ sqlite3、SQLite |
| 追加パッケージ | 不要 |
| データ | メモリ内の架空の注文データ。実ファイルは変更しない |
| 確認する現象 | 正常行は残し、不正行の途中までの更新だけ戻す |
| 未確認 | 掲載コードの今回の実行、実DB・同時接続・停電・大規模性能 |
以下の例では注文番号と数量を扱います。架空データしか使わず、: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が成功するまで、取り込み結果は最終確定していません。この区別が大切です。部分取り消しと全体確定を混同すると、「保存できたと思ったのに戻った」という誤解が生じます。
条件を1つ変えてみる
入力の("A002", -2)を("A002", 2)に変更して再実行します。制約を満たすため、想定では3件とも採用され、拒否は空配列になります。ほかの行やテーブル定義は変えず、数量の符号だけで結果が変わることを観察します。
次に、別の実験として注文番号を重複させると、今度はPRIMARY KEYの一意性制約によって失敗する可能性があります。同じIntegrityErrorでも原因は異なるため、業務用のログには例外の種類と対象行の識別子、制約違反の分類を記録してください。秘密値や個人情報を例外文からそのまま外部へ出さないことも重要です。
失敗時の切り分け
| 症状 | 確認する場所 | 対処の考え方 |
|---|---|---|
no such savepoint | SAVEPOINT名とRELEASEの順序 | 同じ名前の入れ子や二重RELEASEを確認する |
cannot start a transaction within a transaction | BEGIN前の取引状態 | Pythonのトランザクション制御方式を統一する |
| 不正行が残る | CHECK・UNIQUE制約とROLLBACK TO | 何を制約で拒否しているか見直す |
| 全件が消える | 外側のROLLBACKが走ったか | 行単位の拒否と、全体停止条件を区別する |
| 件数が合わない | 採用・拒否・入力件数 | COMMIT前に停止し、原因を確認する |
この例はisolation_level=Noneを指定して、SQLのBEGIN・COMMITを明示的に管理しています。Pythonのバージョンやautocommit設定によって取引制御の扱いが異なるため、別の接続設定と混在させる場合は公式資料を確認してください。
業務で使うときの判断
一部の行を拒否してよいのは、業務ルールがそれを許す場合だけです。例えば請求データなら1件の不正で全件を差し戻す運用が適切なこともあります。注文番号の重複も「既に処理済みだから無視」でよいとは限りません。再送なのか、異なる注文が衝突したのかを区別する必要があります。
実務へ進めるなら、入力件数・採用件数・拒否件数の突合、拒否理由の安全な記録、再投入時の重複防止、全体取り消しの条件を設計します。メモリ内の実験が成功しても、ディスク障害や同時更新まで安全と証明されたわけではありません。
公式資料と検証範囲
本記事は2026年11月16日時点の公式仕様を参照して作成しました。掲載コードの実行・SQLite実ファイルでの確認・WordPress上での表示確認は未実施です。図は省略し、コードの処理順と切り分け表で説明しています。
