SET XACT_ABORT (Transact-SQL)
適用対象: SQL Server
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Analytics Platform System (PDW)
Note
THROW ステートメントは SET XACT_ABORT に従いますが、 RAISERROR は従いません。 新しいアプリケーションでは、RAISERROR の代わりに THROW を使ってください。
SQL Server ステートメントによって実行時エラーが発生した場合に、Transact-SQL によって自動的に現在のトランザクションをロールバックするかどうかを指定します。
構文
SET XACT_ABORT { ON | OFF }
Note
SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。
解説
SET XACT_ABORT が ON の場合は、Transact-SQL ステートメントで実行時エラーが発生すると、トランザクション全体が終了し、ロールバックされます。
SET XACT_ABORT が OFF の場合は、エラーが発生した Transact-SQL ステートメントのみがロールバックされ、トランザクションの処理は継続される場合があります。 SET XACT_ABORT が OFF であっても、エラーの重大度によってはトランザクション全体がロールバックされる場合があります。 OFF は T-SQL ステートメントの既定の設定で、ON はトリガーの既定の設定です。
構文エラーなどのコンパイル エラーは、SET XACT_ABORT の影響を受けません。
SQL Server などのほとんどの OLE DB プロバイダーに対する、明示的または暗黙的なトランザクションのデータ変更ステートメントでは、XACT_ABORT は必ず ON にします。 このオプションが要求されないのは、入れ子になったトランザクションをプロバイダーがサポートしている場合のみです。
ANSI_WARNINGS=OFF の場合、権限違反によってトランザクションは中止されます。
SET XACT_ABORT は、解析時ではなく実行時に設定されます。
この設定の現在の設定を表示するには、次のクエリを実行します。
DECLARE @XACT_ABORT VARCHAR(3) = 'OFF';
IF ( (16384 & @@OPTIONS) = 16384 ) SET @XACT_ABORT = 'ON';
SELECT @XACT_ABORT AS XACT_ABORT;
例
次の例では、他の Transact-SQL ステートメントを含むトランザクションで、外部キー違反エラーが発生します。 最初のステートメント セットでは、エラーが生成されますが、他のステートメントは正常に実行され、トランザクションは正常にコミットされます。 2 番目のステートメントでは、SET XACT_ABORT
は ON
に設定されます。 このため、ステートメント エラーが発生すると、バッチが終了し、トランザクションはロールバックされます。
IF OBJECT_ID(N't2', N'U') IS NOT NULL
DROP TABLE t2;
GO
IF OBJECT_ID(N't1', N'U') IS NOT NULL
DROP TABLE t1;
GO
CREATE TABLE t1
(a INT NOT NULL PRIMARY KEY);
CREATE TABLE t2
(a INT NOT NULL REFERENCES t1(a));
GO
INSERT INTO t1 VALUES (1);
INSERT INTO t1 VALUES (3);
INSERT INTO t1 VALUES (4);
INSERT INTO t1 VALUES (6);
GO
SET XACT_ABORT OFF;
GO
BEGIN TRANSACTION;
INSERT INTO t2 VALUES (1);
INSERT INTO t2 VALUES (2); -- Foreign key error.
INSERT INTO t2 VALUES (3);
COMMIT TRANSACTION;
GO
SET XACT_ABORT ON;
GO
BEGIN TRANSACTION;
INSERT INTO t2 VALUES (4);
INSERT INTO t2 VALUES (5); -- Foreign key error.
INSERT INTO t2 VALUES (6);
COMMIT TRANSACTION;
GO
-- SELECT shows only keys 1 and 3 added.
-- Key 2 insert failed and was rolled back, but
-- XACT_ABORT was OFF and rest of transaction
-- succeeded.
-- Key 5 insert error with XACT_ABORT ON caused
-- all of the second transaction to roll back.
SELECT *
FROM t2;
GO