onmode 和 Z 参数:终止分布式事务(SQL 管理 API)

随同 admin()task() 函数,使用 onmodeZ 参数来终止指定的分布式事务。仅当参与的数据库服务器之间已失去通信才使用这个函数。 如果应用正在执行分布式事务,则终止分布式事务之一可令客户端/服务器数据库系统处于不一致的状态。

语法

元素 描述 关键考虑
address 与分布式事务相关联的共享内存地址。 这必须是正在进行的分布式事务的地址,该事务已超过了 TXTIMEOUT 配置参数指定的时间量。

address 必须符合特定操作系统对共享内存寻址的规则。这个地址可从 onstat -x 输出获取。

用法

仅当该分布式事务已超过了 TXTIMEOUT 配置参数指定的时间量,这个函数才会成功。

这个函数等同于 onmode -Z 命令。

示例

下列示例终止地址为 0xa509018 的分布式事务:
EXECUTE FUNCTION task("onmode","Z","0xa509018");