2025年9月25日: PostgreSQL 18 发布!
支持的版本: 当前 (18) / 17 / 16 / 15 / 14 / 13
开发版本: devel
不支持的版本: 12 / 11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1

44.7. 显式子事务 #

正如第 44.6.2 节中所述,从数据库访问引起的错误中恢复,可能会导致一种不良情况,即某些操作在其中一个操作失败之前成功了,而在从该错误恢复后,数据将处于不一致状态。PL/Python 提供了一种解决方案来解决这个问题,即显式子事务。

44.7.1. 子事务上下文管理器 #

考虑一个实现两个账户之间转账的函数

CREATE FUNCTION transfer_funds() RETURNS void AS $$
try:
    plpy.execute("UPDATE accounts SET balance = balance - 100 WHERE account_name = 'joe'")
    plpy.execute("UPDATE accounts SET balance = balance + 100 WHERE account_name = 'mary'")
except plpy.SPIError as e:
    result = "error transferring funds: %s" % e.args
else:
    result = "funds transferred correctly"
plan = plpy.prepare("INSERT INTO operations (result) VALUES ($1)", ["text"])
plpy.execute(plan, [result])
$$ LANGUAGE plpython3u;

如果第二个 UPDATE 语句引发了异常,此函数将报告错误,但第一个 UPDATE 的结果仍将提交。换句话说,资金将从 Joe 的账户中取出,但不会转到 Mary 的账户。

为避免此类问题,您可以将 plpy.execute 调用包装在显式子事务中。plpy 模块提供了一个帮助对象来管理显式子事务,该对象是通过 plpy.subtransaction() 函数创建的。由该函数创建的对象实现了上下文管理器接口。使用显式子事务,我们可以重写函数如下:

CREATE FUNCTION transfer_funds2() RETURNS void AS $$
try:
    with plpy.subtransaction():
        plpy.execute("UPDATE accounts SET balance = balance - 100 WHERE account_name = 'joe'")
        plpy.execute("UPDATE accounts SET balance = balance + 100 WHERE account_name = 'mary'")
except plpy.SPIError as e:
    result = "error transferring funds: %s" % e.args
else:
    result = "funds transferred correctly"
plan = plpy.prepare("INSERT INTO operations (result) VALUES ($1)", ["text"])
plpy.execute(plan, [result])
$$ LANGUAGE plpython3u;

请注意,仍然需要使用 try/except。否则,异常将传播到 Python 堆栈的顶部,并导致整个函数因 PostgreSQL 错误而中止,因此 operations 表不会插入任何行。子事务上下文管理器不会捕获错误,它只确保在其作用域内执行的所有数据库操作都将原子地提交或回滚。子事务块的回滚发生在任何类型的异常退出时,而不仅仅是数据库访问引起的错误。在显式子事务块内引发的常规 Python 异常也会导致子事务回滚。

提交更正

如果您在文档中看到任何不正确、与您对特定功能的体验不符或需要进一步澄清的内容,请使用此表单报告文档问题。