SET XACT_ABORT (Transact-SQL)

対象者:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analyticsアナリティクスプラットフォームシステム(PDW)Microsoft FabricにおけるSQLデータベース

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 文のみがロールバックされ、トランザクションは処理を継続します。 エラーの深刻さによっては、OFFであっても取引全体がロールバックされることがあります SET XACT_ABORT 。 OFF は T-SQL ステートメントの既定の設定で、ON はトリガーの既定の設定です。

構文エラーなどのコンパイル エラーは、SET XACT_ABORT の設定の影響を受けません。

XACT_ABORTほとんどのOLE DBプロバイダー(SQL Serverを含む)に対して、暗黙的または明示的なトランザクションにおけるデータ変更文に対して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

参照

  • Last updated on