Partilhar via

SET XACT_ABORT (Transact-SQL)

Aplica-se a:Banco de Dados SQL doAzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)Banco de Dados SQL no Microsoft Fabric

Observação

A declaração THROW honra o CONJUNTO XACT_ABORT. O RAISERROR não. As novas aplicações devem usar THROW em vez de RAISERROR.

Especifica se o SQL Server reverte automaticamente a transação atual quando uma instrução Transact-SQL gera um erro em tempo de execução.

Transact-SQL convenções de sintaxe

Sintaxe

SET XACT_ABORT { ON | OFF }

Observações

Quando o XACT_ABORT SET está ON, se uma instrução Transact-SQL gerar um erro em tempo de execução, toda a transação é terminada e revertida.

Quando o XACT_ABORT SET está DESLIGADO, em alguns casos apenas a instrução Transact-SQL que gerou o erro é revertida e a transação continua a ser processada. Dependendo da gravidade do erro, toda a transação pode ser revertida mesmo quando o XACT_ABORT SET está DESLIGADO. DESLIGADO é a definição padrão numa instrução T-SQL, enquanto LIGADO é a definição padrão num trigger.

Erros de compilação, como erros de sintaxe, não são afetados pelo XACT_ABORT SET.

XACT_ABORT deve ser definido ON para instruções de modificação de dados numa transação implícita ou explícita contra a maioria dos fornecedores OLE DB, incluindo o SQL Server. O único caso em que esta opção não é necessária é se o fornecedor suportar transações aninhadas.

Quando ANSI_WARNINGS=DESLIGADO, violações de permissões fazem com que as transações abortem.

A definição de SET XACT_ABORT é definida em tempo de execução ou execução e não em tempo de análise sintética.

Para visualizar a definição atual desta definição, execute a seguinte consulta.

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

Examples

O seguinte exemplo de código causa um erro de violação de chave estrangeira numa transação que tem outras instruções Transact-SQL. No primeiro conjunto de instruções, o erro é gerado, mas as outras instruções executam-se com sucesso e a transação é confirmada com sucesso. No segundo conjunto de afirmações, SET XACT_ABORT é definido como ON. Isto faz com que o erro da instrução termine o lote e a transação seja revertida.

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

Ver também

  • Last updated on