SET XACT_ABORT (Transact-SQL)

  • [アーティクル]

適用対象: SQL Server Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Note

THROW ステートメントは SET XACT_ABORT に従いますが、 RAISERROR は従いません。 新しいアプリケーションでは、RAISERROR の代わりに THROW を使ってください。

SQL Server ステートメントによって実行時エラーが発生した場合に、Transact-SQL によって自動的に現在のトランザクションをロールバックするかどうかを指定します。

Transact-SQL 構文表記規則

構文

SET XACT_ABORT { ON | OFF }

解説

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

参照