ATOMIC ブロック

BEGIN ATOMIC は ANSI SQL 標準の一部です。 SQL Server では、ネイティブ コンパイル ストアド プロシージャの最上位レベルでのみアトミック ブロックがサポートされます。

• 各ネイティブ コンパイル ストアド プロシージャには、Transact-SQL ステートメントが正確に 1 ブロックずつ含まれています。 これが ATOMIC ブロックです。

• ネイティブでない、解釈された Transact-SQL ストアド プロシージャおよびアドホック バッチでは、ATOMIC ブロックはサポートされません。

ATOMIC ブロックはトランザクション内部で (自動的に) 実行されます。 ブロック内のすべてのステートメントが成功するか、またはブロック全体がブロックの先頭で作成したセーブポイントまでロールバックされます。 また、ATOMIC ブロックのセッション設定は固定されています。 同じ ATOMIC ブロックを異なる設定のセッションで実行しても、現在のセッション設定とは関係なく動作は同じになります。

トランザクションとエラー処理

トランザクションがセッションに既に存在する場合 (バッチが BEGIN TRANSACTION ステートメントを実行し、トランザクションがアクティブなままであるため)、アトミック ブロックを開始すると、トランザクションにセーブポイントが作成されます。 ブロックが例外なしで終了すると、ブロックに対して作成されたセーブポイントがコミットされますが、セッション レベルでコミットされるまでトランザクションはコミットされません。 ブロックで例外がスローされるとブロックの結果はロールバックされますが、例外によってトランザクションの失敗が決定的にならない限り、セッション レベルのトランザクションは続行されます。 たとえば、書き込みの競合によってトランザクションの失敗は決定的になりますが、型キャスト エラーの場合はそうではありません。

セッションにアクティブなトランザクションがない場合、 BEGIN ATOMIC は新しいトランザクションを開始します。 ブロックのスコープ外でスローされる例外が存在しない場合、トランザクションはブロックの末尾でコミットされます。 ブロックで例外がスローされた場合 (つまり、ブロック内で例外をキャッチして処理できなかった場合)、トランザクションはロールバックされます。 1 つのアトミック ブロック (ネイティブ コンパイル ストアド プロシージャ) にまたがるトランザクションの場合、明示的な BEGIN TRANSACTION および COMMIT ステートメントや ROLLBACK ステートメントを記述する必要はありません。

ネイティブ コンパイル ストアド プロシージャは、エラー処理用の TRY、 CATCH、および THROW コンストラクトをサポートします。 RAISERROR はサポートされません。

次の例は、ATOMIC ブロックおよびネイティブ コンパイル ストアド プロシージャでのエラー処理動作を示しています。

-- 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  

メモリ最適化テーブルに固有の次のエラー メッセージは、トランザクションの失敗が決定的であることを示しています。 アトミック ブロックのスコープで発生した場合、トランザクションは中止されます:10772、41301、41302、41305、41325、41332、41333。

セッションの設定

ATOMIC ブロックのセッション設定は、ストアド プロシージャのコンパイル時に固定されます。 一部の設定は BEGIN ATOMIC で指定できますが、他の設定は常に同じ値に固定されます。

BEGIN ATOMICでは、次のオプションが必要です。

必須の設定	説明
TRANSACTION ISOLATION LEVEL	サポートされている値は SNAPSHOT、REPEATABLEREAD、SERIALIZABLE です。
LANGUAGE	日付と時刻の形式とシステム メッセージが決まります。 sys.syslanguages (Transact-SQL) のすべての言語とエイリアスがサポートされます。

次の設定は省略可能です。

省略可能な設定	説明
DATEFORMAT	SQL Server のすべての日付形式がサポートされています。 指定すると、 DATEFORMAT は、 LANGUAGEに関連付けられている既定の日付形式をオーバーライドします。
DATEFIRST	指定すると、 DATEFIRST は、 LANGUAGEに関連付けられている既定値をオーバーライドします。
DELAYED_DURABILITY	サポートされている値は、OFF と ONです。 によるトランザクションのコミットには、完全持続性、既定値、または遅延持続性が適用されます。詳細については、「トランザクションの持続性の制御」を参照してください。

次の SET オプションには、すべてのネイティブ コンパイル ストアド プロシージャのすべての ATOMIC ブロックについて同じシステム既定値が設定されます。

SET オプション	ATOMIC ブロックのシステム既定値
ANSI_NULLS	オン
ANSI_PADDING (ANSIのパディング)	オン
ANSI_WARNING	オン
ARITHABORT	オン
ARITHIGNORE	オフ
CONCAT_NULL_YIELDS_NULL	オン
IDENTITY_INSERT（データベースに挿入時、IDフィールドを指定するためのSQLコマンド）	オフ
NOCOUNT	オン
数値丸め中止	オフ
QUOTED_IDENTIFIER（引用された識別子）	オン
ROWCOUNT	0
テキストサイズ	0
XACT_ABORT	オフ 処理できない例外により ATOMIC ブロックはロールバックされますが、そのエラーが致命的でない限りトランザクションは中止されません。

こちらもご覧ください

ネイティブ コンパイル ストアド プロシージャ