Blocos atômicos nos procedimentos nativos

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

BEGIN ATOMIC não faz parte do padrão ANSI SQL. O SQL Server é compatível com blocos atômicos no nível superior de procedimentos armazenados compilados nativamente e também com funções escalares definidas pelo usuário compiladas nativamente. Para obter mais informações sobre essas funções, consulte Funções escalares definidas pelo usuário para OLTP in-memory.

  • Cada procedimento armazenado compilado nativamente contém exatamente um bloco de instruções Transact-SQL. Esse é um bloco ATOMIC.

  • Procedimentos armazenados do Transact-SQL não nativos interpretados e lotes ad hoc não são compatíveis com blocos atômicos.

Os blocos atômicos são executados (atomicamente) na transação. Todas as instruções no bloco foram bem-sucedidas ou o bloco inteiro será revertido para o ponto de salvamento criado no início do bloco. Além disso, as configurações da sessão são corrigidas para o bloco atômico. A execução do mesmo bloco atômico nas sessões com diferentes configurações resultará no mesmo comportamento, independentemente das configurações da sessão atual.

Transações e tratamento de erros

Se uma transação já existir em uma sessão (porque um lote executou uma instrução BEGIN TRANSACTION e a transação permanece ativa), iniciar um bloco atômico criará um ponto de salvamento na transação. Se o bloco sair sem uma exceção, um novo ponto de salvamento criado para o bloco é confirmado, mas a transação não será confirmada até que isso ocorra no nível da sessão. Se o bloco lançar uma exceção, os efeitos do bloco serão revertidos, mas a transação no nível da sessão continuará, a menos que a exceção seja decretada por transação. Por exemplo, um conflito de gravação é decretado por transação, mas não um erro de conversão de tipo.

Se não houver transação ativa em uma sessão, BEGIN ATOMIC iniciará uma nova transação. Se nenhuma exceção for lançada fora do escopo do bloco, a transação será confirmada no fim do bloco. Se o bloco lançar uma exceção (ou seja, se a exceção não for capturada e tratada no bloco), a transação será revertida. Para transações que abrangem um único bloco atômico (um único procedimento armazenado compilado nativamente), você não precisa gravar instruções BEGIN TRANSACTION e COMMIT ou ROLLBACK explícitas.

Os procedimentos armazenados compilados nativamente oferecem suporte às construções TRY, CATCHe THROW para tratamento de erros. Não há suporte paraRAISERROR .

O exemplo a seguir ilustra o comportamento de tratamento de erros com blocos atômicos e procedimentos armazenados compilados nativamente:

-- sample table  
CREATE TABLE dbo.t1 (  
  c1 int not null primary key nonclustered  
)  
WITH (MEMORY_OPTIMIZED=ON)  
GO  
  
-- sample proc that inserts 2 rows  
CREATE PROCEDURE dbo.usp_t1 @v1 bigint not null, @v2 bigint not null  
WITH NATIVE_COMPILATION, SCHEMABINDING, EXECUTE AS OWNER  
AS  
BEGIN ATOMIC  
WITH (TRANSACTION ISOLATION LEVEL = SNAPSHOT, LANGUAGE = N'us_english', DELAYED_DURABILITY = ON)  
  
  INSERT dbo.t1 VALUES (@v1)  
  INSERT dbo.t1 VALUES (@v2)  
  
END  
GO  
  
-- insert two rows  
EXEC dbo.usp_t1 1, 2  
GO  
  
-- verify we have no active transaction  
SELECT @@TRANCOUNT  
GO  
  
-- verify the rows 1 and 2 were committed  
SELECT c1 FROM dbo.t1  
GO  
  
-- execute proc with arithmetic overflow  
EXEC dbo.usp_t1 3, 4444444444444  
GO  
-- expected error message:  
-- Msg 8115, Level 16, State 0, Procedure usp_t1  
-- Arithmetic overflow error converting bigint to data type int.  
  
-- verify we have no active transaction  
SELECT @@TRANCOUNT  
GO  
  
-- verify rows 3 was not committed; usp_t1 has been rolled back  
SELECT c1 FROM dbo.t1  
GO  
  
-- start a new transaction  
BEGIN TRANSACTION  
  -- insert rows 3 and 4  
  EXEC dbo.usp_t1 3, 4  
  
  -- verify there is still an active transaction  
  SELECT @@TRANCOUNT  
  
  -- verify the rows 3 and 4 were inserted  
  SELECT c1 FROM dbo.t1 WITH (SNAPSHOT)   
  ORDER BY c1  
  
  -- catch the arithmetic overflow error  
  BEGIN TRY  
    EXEC dbo.usp_t1 5, 4444444444444  
  END TRY  
  BEGIN CATCH  
    PRINT N'Error occurred: ' + error_message()  
  END CATCH  
  
  -- verify there is still an active transaction  
  SELECT @@TRANCOUNT  
  
  -- verify rows 3 and 4 are still in the table, and row 5 has not been inserted  
  SELECT c1 FROM dbo.t1 WITH (SNAPSHOT)   
  ORDER BY c1  
  
COMMIT  
GO  
  
-- verify we have no active transaction  
SELECT @@TRANCOUNT  
GO  
  
-- verify rows 3 and 4 has been committed  
SELECT c1 FROM dbo.t1  
ORDER BY c1  
GO  

As mensagens de erro a seguir específicas de tabelas com otimização de memória são decretadas por transação. Se elas ocorrerem no escopo de um bloco atômico, a transação será anulada: 10772, 41301, 41302, 41305, 41325, 41332, 41333 e 41839.

Configurações da sessão

As configurações da sessão nos blocos atômicos são corrigidas quando o procedimento armazenado é compilado. Algumas configurações podem ser especificadas com BEGIN ATOMIC , enquanto outras configurações sempre são corrigidas para o mesmo valor.

As seguintes opções são necessárias com BEGIN ATOMIC:

Configuração necessária Descrição
TRANSACTION ISOLATION LEVEL Os valores com suporte são SNAPSHOT, REPEATABLEREADe SERIALIZABLE.
LANGUAGE Determina os formatos de data e hora, e as mensagens do sistema. Todos os idiomas e aliases em sys.syslanguages (Transact-SQL) são compatíveis.

As seguintes configurações são opcionais:

Configuração opcional Descrição
DATEFORMAT Todos os formatos de data do SQL Server são compatíveis. Quando especificado, DATEFORMAT substitui o formato de data padrão associado a LANGUAGE.
DATEFIRST Quando especificado, DATEFIRST substitui o padrão associado a LANGUAGE.
DELAYED_DURABILITY Os valores com suporte são OFF e ON.

As confirmações de transação do SQL Server podem ser completamente duráveis, padrão, ou duráveis atrasadas. Para obter mais informações, confira Controlar Durabilidade de Transação.

As opções SET a seguir têm o mesmo valor padrão de sistema para todos os blocos atômicos em todos os procedimentos armazenados compilados nativamente:

Opção Set Padrão do sistema para blocos atômicos
ANSI_NULLS ATIVADO
ANSI_PADDING ATIVADO
ANSI_WARNING ATIVADO
ARITHABORT ATIVADO
ARITHIGNORE OFF
CONCAT_NULL_YIELDS_NULL ATIVADO
IDENTITY_INSERT OFF
NOCOUNT ATIVADO
NUMERIC_ROUNDABORT OFF
QUOTED_IDENTIFIER ATIVADO
ROWCOUNT 0
TEXTSIZE 0
XACT_ABORT OFF

As exceções não capturadas fazem com que o bloco atômico seja revertido, mas não fazem com que a transação seja anulada, a menos que o erro seja decretado por transação.

Confira também

Procedimentos armazenados compilados nativamente