在 Sybase ASE 实际应用中,特别是在 ASE +
J2EE? 应用中,较容易出现
SET CHAINED command not allowed within multi-statement transaction.的异常(尽管到版本 15.0.1 为止,ASE 并不支持异常机制,但本文为了方便,统一采用“异常”一词)。有的开发人员认为这是 Sybase 数据库的问题;有的认为是多次调用 setAutoCommit() 方法的问题;有的开发人员则认为这是 jConnect 的问题,甚至从 jConnect 的代码上直接屏蔽此异常。
然而,SET CHAINED 异常倒底是怎样产生的?
一、数据库层
首先,让我们看看 set chained。下面的文字片段摘自《ASE 12.5.2 Reference Manual: Commands》,Page 430:
下面的 sql 代码片断将说明在数据库层上 SET CHAINED 错误信息是如何产生的。
重建一个数据库连接,从头开始:
J2EE 应用中,一些轻量级的数据访问层实现采用 Connection 的setAutoCommit(false) + commit()/rollback() 的方式来管理事务。通过对 jConnect 的反编译以及对 spt_mda 数据的分析,可以得知 setAutoCommit(true) = SET CHAINED OFF;setAutoCommit(false) = SET CHAINED ON,下图以顺序图展示调用 setAutoCommit() 方法时,实际发生的交互。
另一方面,J2EE 应用中大多采用了连接池。应用在调用 Connection.close() 方法时,实际上并没有真正地关闭连接,而是将连接回收到池中。假设连接的初态是 chained off。如果应用在取得连接后调用该连接的 setAutoCommit(false) 方法来启动事务,在未完成事务的情况下,通过 close() 方法回到池中,则当该连接下一次被取出并调用 setAutoCommit(false) 方法时就会抛出异常。见下图:
通过上面的分析,理解了产生此异常的原因,就很容易避免此异常,即调用了 setAutoCommit(false) 后,必须显示地完成事务,即使只是执行了一个select语句。同时,关闭连接前,应显式地调用 setAutoCommit(true)。或许有的程序员会认为麻烦,但别忘记“完壁归赵”是资源借用者的义务。
然而,SET CHAINED 异常倒底是怎样产生的?
一、数据库层
首先,让我们看看 set chained。下面的文字片段摘自《ASE 12.5.2 Reference Manual: Commands》,Page 430:
chained begins a transaction just before the first data retrieval or data modification statement at the beginning of a session and after a transaction ends. In chained mode, Adaptive Server implicitly executes a begin transaction command before the following statements: delete, fetch, insert, lock table, open, select, and update. You cannot execute set chained within a transaction.从此段文字可以得知,当 set chained on 后,delete、fetch、insert、lock table、open、select 以及 update 语句将自动启动一个事务,并要求显式的完成事务,即明确地调用 commit/rollback。同时,在事务中,不允许设置 chained 模式。
下面的 sql 代码片断将说明在数据库层上 SET CHAINED 错误信息是如何产生的。
1> set chained on 2> go 1> set chained on 2> go 1> begin tran 2> go 1>似乎多次调用 set chained 并不会产生异常。接下来,
1> set chained on 2> go Msg 226, Level 16, State 1: Server 'FLYBEAN', Line 1: SET CHAINED command not allowed within multi-statement transaction. 1> set chained off 2> go Msg 226, Level 16, State 1: Server 'FLYBEAN', Line 1: SET CHAINED command not allowed within multi-statement transaction. 1>显然,处于事务环境下,调用 set chained 是会发生异常的,这一点手册上也非常明确的指出了。但为什么前面的片断中两次连续调用 set chained 却不会产生异常呢?请注意文档上这一句: Adaptive Server implicitly executes a begin transaction command before the following statements: 。
重建一个数据库连接,从头开始:
1> set chained on 2> go 1> select 1 2> go ----------- 1 (1 row affected) 1> set chained on 2> go Msg 226, Level 16, State 1: Server 'FLYBEAN', Line 1: SET CHAINED command not allowed within multi-statement transaction. 1> set chained off 2> go Msg 226, Level 16, State 1: Server 'FLYBEAN', Line 1: SET CHAINED command not allowed within multi-statement transaction. 1>在执行 select 1 之前,数据库自动启动了一笔事务,因此不能再执行 set chained。接下来,完成隐式启动的事务:
1> rollback 2> go 1> set chained off 2> go 1>二、J2EE 层
J2EE 应用中,一些轻量级的数据访问层实现采用 Connection 的setAutoCommit(false) + commit()/rollback() 的方式来管理事务。通过对 jConnect 的反编译以及对 spt_mda 数据的分析,可以得知 setAutoCommit(true) = SET CHAINED OFF;setAutoCommit(false) = SET CHAINED ON,下图以顺序图展示调用 setAutoCommit() 方法时,实际发生的交互。
![](http://www.sybaseclub.org/blog/wp-content/uploads/2007/01/conn.jpg)
理解 SET CHAINED command not allowed within multi-statement transaction.
另一方面,J2EE 应用中大多采用了连接池。应用在调用 Connection.close() 方法时,实际上并没有真正地关闭连接,而是将连接回收到池中。假设连接的初态是 chained off。如果应用在取得连接后调用该连接的 setAutoCommit(false) 方法来启动事务,在未完成事务的情况下,通过 close() 方法回到池中,则当该连接下一次被取出并调用 setAutoCommit(false) 方法时就会抛出异常。见下图:
通过上面的分析,理解了产生此异常的原因,就很容易避免此异常,即调用了 setAutoCommit(false) 后,必须显示地完成事务,即使只是执行了一个select语句。同时,关闭连接前,应显式地调用 setAutoCommit(true)。或许有的程序员会认为麻烦,但别忘记“完壁归赵”是资源借用者的义务。