XACT_STATE (Transact-SQL)
更新日期: 2006 年 4 月 14 日
用于报告当前正在运行的请求的用户事务状态的标量函数。XACT_STATE 指示请求是否有活动的用户事务,以及是否能够提交该事务。
语法
XACT_STATE()
返回类型
smallint
备注
XACT_STATE 返回下列值。
返回值 | 含义 |
---|---|
1 |
当前请求有活动的用户事务。请求可以执行任何操作,包括写入数据和提交事务。 |
0 |
当前请求没有活动的用户事务。 |
-1 |
当前请求具有活动的用户事务,但出现了致使事务被归类为无法提交的事务的错误。请求无法提交事务或回滚到保存点;它只能请求完全回滚事务。请求在回滚事务之前无法执行任何写操作。请求在回滚事务之前只能执行读操作。事务回滚之后,请求便可执行读写操作并可开始新的事务。 当批处理结束运行时,数据库引擎将自动回滚所有不可提交的活动事务。如果事务进入不可提交状态时未发送错误消息,则当批处理结束时,将向客户端应用程序发送一个错误消息。该消息指示检测到并回滚了一个不可提交的事务。有关无法提交的事务的详细信息,请参阅在 Transact-SQL 中使用 TRY...CATCH。 |
XACT_STATE 和 @@TRANCOUNT 函数都可用于检测当前请求是否具有活动的用户事务。@@TRANCOUNT 不能用于确定事务是否已分类为不可提交的事务。XACT_STATE 不能用于确定是否有嵌套事务。
示例
以下示例使用 TRY…CATCH
构造的 CATCH
块中的 XACT_STATE
来确定是提交事务还是回滚事务。由于 SET XACT_ABORT
设置为 ON
,因此违反约束的错误将导致事务进入无法提交的状态。
USE AdventureWorks;
GO
-- SET XACT_ABORT ON will render the transaction uncommittable
-- when the constraint violation occurs.
SET XACT_ABORT ON;
BEGIN TRY
BEGIN TRANSACTION;
-- A FOREIGN KEY constraint exists on this table. This
-- statement will generate a constraint violation error.
DELETE FROM Production.Product
WHERE ProductID = 980;
-- If the delete operation succeeds, commit the transaction. The CATCH
-- block will not execute.
COMMIT TRANSACTION;
END TRY
BEGIN CATCH
-- Test XACT_STATE for 0, 1, or -1.
-- If 1, the transaction is committable.
-- If -1, the transaction is uncommittable and should
-- be rolled back.
-- XACT_STATE = 0 means there is no transaction and
-- a commit or rollback operation would generate an error.
-- Test whether the transaction is uncommittable.
IF (XACT_STATE()) = -1
BEGIN
PRINT 'The transaction is in an uncommittable state.' +
' Rolling back transaction.'
ROLLBACK TRANSACTION;
END;
-- Test whether the transaction is active and valid.
IF (XACT_STATE()) = 1
BEGIN
PRINT 'The transaction is committable.' +
' Committing transaction.'
COMMIT TRANSACTION;
END;
END CATCH;
GO
请参阅
参考
@@TRANCOUNT (Transact-SQL)
BEGIN TRANSACTION (Transact-SQL)
COMMIT TRANSACTION (Transact-SQL)
ROLLBACK TRANSACTION (Transact-SQL)
SAVE TRANSACTION (Transact-SQL)
TRY...CATCH (Transact-SQL)
其他资源
在 Transact-SQL 中使用 TRY...CATCH
事务(数据库引擎)
帮助和信息
更改历史记录
版本 | 历史记录 |
---|---|
2006 年 4 月 14 日 |
|