SQL命令 ROLLBACK

回滾事務。

大綱

ROLLBACK [WORK]ROLLBACK TO SAVEPOINT pointname

參數

• pointname - 作為標識符指定的現有保存點的名稱。

描述

ROLLBACK語句將回滾事務,撤消已執行但未提交的工作,減少$TLEVEL事務級別計數器,并釋放鎖。 ROLLBACK用于將數據庫恢復到以前的一致狀態。

• ROLLBACK回滾當前事務期間完成的所有工作,將$TLEVEL事務級別計數器重置為0,并釋放所有鎖。 這會將數據庫恢復到事務開始之前的狀態。 ROLLBACK和ROLLBACK WORK是等價的語句; 這兩個版本都支持兼容性。
• ROLLBACK TO SAVEPOINT pointname將回滾自指定保存點以來已完成的所有工作,并按未完成的保存點的數量遞減$TLEVEL事務級別計數器。 當所有保存點都被回滾或提交,并且事務級別計數器重置為零時,事務就完成了。 如果指定的保存點不存在,或者已經回滾,ROLLBACK將發出SQLCODE -375錯誤并回滾整個當前事務。

回滾到SAVEPOINT必須指定一個點名。 如果不這樣做,將導致SQLCODE -301錯誤。

如果事務操作未能成功完成,則會發出SQLCODE -400錯誤。

不回滾

ROLLBACK操作不影響以下項目:

• 回滾不會減少默認類的IDKey計數器。 IDKey是由$INCREMENT(或$SEQUENCE)自動生成的,它維護一個獨立于SQL事務的計數。
• 回滾不會逆轉緩存查詢的創建、修改或清除。 這些操作不被視為事務的一部分。
• 在事務中發生的DDL操作或調優表操作可以創建并運行臨時例程。 這個臨時例程與緩存查詢一樣被處理。 也就是說,臨時例程的創建、編譯和刪除不被視為事務的一部分。 臨時例程的執行被認為是事務的一部分。

回滾日志

提示回滾發生的消息和回滾操作中遇到的錯誤都記錄在MGR目錄下的Messages.log文件中。 您可以通過“管理門戶系統操作”、“系統日志”、“消息日志”選項查看“Messages.Log”。

事務掛起

%SYSTEM.Process類的TransactionsSuspending()方法可用于掛起和恢復系統范圍內的所有當前事務。掛起事務會掛起更改的日志記錄。因此,如果在當前事務期間發生事務掛起,則ROLLBACK不能回滾在事務掛起期間所做的任何更改;但是,回滾將回滾在事務掛起生效之前或之后在當前事務期間所做的任何更改。

ObjectScript事務命令

ObjectScript和SQL TRANSACTION命令完全兼容且可互換,但以下情況除外:

如果沒有當前事務,ObjectScript TSTART和SQL START TRANSACTION都會啟動事務。但是,START TRANSACTION不支持嵌套事務。因此,如果需要(或可能需要)嵌套事務,最好使用TSTART啟動事務。如果需要與SQL標準兼容,請使用START TRANSACTION。

ObjectScript事務處理為嵌套事務提供有限的支持。SQL事務處理為事務內的保存點提供支持。

ClassMethod ROLLBACK(){    &sql(SET TRANSACTION %COMMITMODE EXPLICIT)    w !,"Set transaction mode, SQLCODE=",SQLCODE    w !,"Transaction level=",$TLEVEL    &sql(START TRANSACTION)    w !,"Start transaction, SQLCODE=",SQLCODE    w !,"Transaction level=",$TLEVEL    &sql(SAVEPOINT a)    w !,"Set Savepoint a, SQLCODE=",SQLCODE    w !,"Transaction level=",$TLEVEL    &sql(SAVEPOINT b)    w !,"Set Savepoint b, SQLCODE=",SQLCODE    w !,"Transaction level=",$TLEVEL    &sql(SAVEPOINT c)    w !,"Set Savepoint c, SQLCODE=",SQLCODE    w !,"Transaction level=",$TLEVEL    &sql(ROLLBACK)    w !,"Rollback transaction, SQLCODE=",SQLCODE    w !,"Transaction level=",$TLEVEL}

DHC-APP>d ##class(PHA.TEST.SQLCommand).ROLLBACK() Set transaction mode, SQLCODE=0Transaction level=0Start transaction, SQLCODE=0Transaction level=1Set Savepoint a, SQLCODE=0Transaction level=2Set Savepoint b, SQLCODE=0Transaction level=3Set Savepoint c, SQLCODE=0Transaction level=4Rollback transaction, SQLCODE=0Transaction level=0

以下嵌入式SQL示例演示了回滾到保存點名稱如何將事務級別($TLEVEL)恢復到緊靠指定保存點之前的級別:

ClassMethod ROLLBACK1(){    &sql(SET TRANSACTION %COMMITMODE EXPLICIT)    w !,"Set transaction mode, SQLCODE=",SQLCODE    w !,"Transaction level=",$TLEVEL    &sql(START TRANSACTION)    w !,"Start transaction, SQLCODE=",SQLCODE    w !,"Transaction level=",$TLEVEL    &sql(SAVEPOINT a)    w !,"Set Savepoint a, SQLCODE=",SQLCODE    w !,"Transaction level at a=",$TLEVEL    &sql(SAVEPOINT b)    w !,"Set Savepoint b, SQLCODE=",SQLCODE    w !,"Transaction level at b=",$TLEVEL    &sql(ROLLBACK TO SAVEPOINT b)    w !,"Rollback to b, SQLCODE=",SQLCODE    w !,"Rollback transaction level=",$TLEVEL    &sql(SAVEPOINT c)    w !,"Set Savepoint c, SQLCODE=",SQLCODE    w !,"Transaction level at c=",$TLEVEL    &sql(SAVEPOINT d)    w !,"Set Savepoint d, SQLCODE=",SQLCODE    w !,"Transaction level at d=",$TLEVEL    &sql(COMMIT)    w !,"Commit transaction, SQLCODE=",SQLCODE    w !,"Transaction level=",$TLEVEL}

DHC-APP>d ##class(PHA.TEST.SQLCommand).ROLLBACK1() Set transaction mode, SQLCODE=0Transaction level=0Start transaction, SQLCODE=0Transaction level=1Set Savepoint a, SQLCODE=0Transaction level at a=2Set Savepoint b, SQLCODE=0Transaction level at b=3Rollback to b, SQLCODE=0Rollback transaction level=2Set Savepoint c, SQLCODE=0Transaction level at c=3Set Savepoint d, SQLCODE=0Transaction level at d=4Commit transaction, SQLCODE=0Transaction level=0