SET XACT_ABORT (Transact-SQL)

  • Artikel

Berlaku untuk:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics AnalyticsPlatform System (PDW)

Catatan

Pernyataan THROW menghormati SET XACT_ABORT. RAISERROR tidak. Aplikasi baru harus menggunakan THROW alih-alih RAISERROR.

Menentukan apakah SQL Server secara otomatis mengembalikan transaksi saat ini ketika pernyataan Transact-SQL menimbulkan kesalahan run-time.

Konvensi sintaks transact-SQL

Sintaksis

SET XACT_ABORT { ON | OFF }

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 (12.x) dan versi yang lebih lama, lihat Dokumentasi versi sebelumnya.

Keterangan

Ketika SET XACT_ABORT AKTIF, jika pernyataan Transact-SQL menimbulkan kesalahan run-time, seluruh transaksi dihentikan dan digulung balik.

Ketika SET XACT_ABORT NONAKTIF, dalam beberapa kasus hanya pernyataan Transact-SQL yang memunculkan kesalahan digulung balik dan transaksi terus diproses. Tergantung pada tingkat keparahan kesalahan, seluruh transaksi dapat digulung balik bahkan ketika SET XACT_ABORT NONAKTIF. OFF adalah pengaturan default dalam pernyataan T-SQL, sementara AKTIF adalah pengaturan default dalam pemicu.

Mengkompilasi kesalahan, seperti kesalahan sintaksis, tidak dipengaruhi oleh SET XACT_ABORT.

XACT_ABORT harus diatur AKTIF untuk pernyataan modifikasi data dalam transaksi implisit atau eksplisit terhadap sebagian besar penyedia OLE DB, termasuk SQL Server. Satu-satunya kasus di mana opsi ini tidak diperlukan adalah jika penyedia mendukung transaksi berlapis.

Saat ANSI_WARNINGS=NONAKTIF, pelanggaran izin menyebabkan transaksi dibatalkan.

Pengaturan SET XACT_ABORT diatur pada waktu eksekusi atau run time dan bukan pada waktu penguraian.

Untuk menampilkan pengaturan saat ini untuk pengaturan ini, jalankan kueri berikut.

DECLARE @XACT_ABORT VARCHAR(3) = 'OFF';
IF ( (16384 & @@OPTIONS) = 16384 ) SET @XACT_ABORT = 'ON';
SELECT @XACT_ABORT AS XACT_ABORT;

Contoh

Contoh kode berikut menyebabkan kesalahan pelanggaran kunci asing dalam transaksi yang memiliki pernyataan Transact-SQL lainnya. Dalam serangkaian pernyataan pertama, kesalahan dihasilkan, tetapi pernyataan lain berhasil dijalankan dan transaksi berhasil dilakukan. Dalam kumpulan pernyataan kedua, SET XACT_ABORT diatur ke ON. Ini menyebabkan kesalahan pernyataan mengakhiri batch dan transaksi digulung balik.

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

Lihat Juga