XACT_STATE (Transact-SQL)
適用於:SQL Server
Azure SQL 資料庫
Azure SQL 受控執行個體
Azure Synapse Analytics
Analytics Platform System (PDW)
這是報告目前正在執行之要求的使用者交易狀態的純量函數。 XACT_STATE 指出要求是否具有使用中的使用者交易,以及是否可以認可該交易。
Syntax
XACT_STATE()
注意
若要檢視 SQL Server 2014 (12.x) 和更早版本的 Transact-SQL 語法,請參閱舊版文件。
注意
Azure Synapse Analytics 的無伺服器 SQL 集區不支援此語法。
傳回類型
smallint
備註
XACT_STATE 會傳回下列值。
傳回值 | 意義 |
---|---|
1 | 目前的要求具有使用中的使用者交易。 要求可以執行任何動作,其中包括寫入資料和認可交易。 |
0 | 目前的要求沒有任何使用中的使用者交易。 |
-1 | 目前的要求有一項使用中的使用者交易,但發生錯誤,使交易被分類為無法認可的交易。 要求無法認可交易或回復到儲存點;它只能要求完整回復交易。 要求無法執行任何寫入作業,直到它回復交易為止。 要求只能執行讀取作業,直到它回復交易為止。 在交易回復之後,要求便可以執行讀取和寫入作業,且可以起始一項新交易。 當最外層的批次完成執行之後,資料庫引擎將自動復原任何作用中無法認可的交易。 如果在交易進入無法認可的狀態時沒有傳送任何錯誤訊息,則當批次完成時,就會將錯誤訊息傳送給用戶端應用程式。 此訊息表示偵測到無法認可的交易,並已回復。 |
XACT_STATE 和 @@TRANCOUNT 函數都可用來偵測目前的要求是否有使用中的使用者交易。 @@TRANCOUNT 無法用來判斷交易是否已分類為無法認可的交易。 XACT_STATE 無法用來判斷是否有巢狀交易。
範例
下列範例會在 XACT_STATE
建構之 CATCH
區塊中使用 TRY...CATCH
,來決定要認可或回復交易。 由於 SET XACT_ABORT
是 ON
,因此,條件約束違規錯誤會使交易進入無法認可的狀態。
USE AdventureWorks2022;
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)