本机过程中的 ATOMIC 块
适用于: SQL Server Azure SQL 数据库 Azure SQL 托管实例
BEGIN ATOMIC 属于 ANSI SQL 标准。 SQL Server 支持顶级本机编译存储过程的原子块,以及本机编译的标量用户定义函数。 有关这些函数的详细信息,请参阅 内存中 OLTP 的标量用户定义函数。
每个本机编译的存储过程都恰好包含一个 Transact-SQL 语句块。 这个语句块是原子块。
非本机的解释型 Transact-SQL 存储过程和即席批处理不支持原子块。
原子块在事务内执行(以原子方式)。 或者块中的整个语句都成功,或者整个块都将回滚到在块的开始处创建的保存点。 此外,会话设置对于原子块而言是固定的。 以不同设置在会话中执行相同的原子块将导致相同的行为,与当前会话的设置无关。
如果某个事务已在会话上存在(因为某一批处理执行了 BEGIN TRANSACTION 语句并且该事务保持活动状态),则开始一个原子块将在该事务中创建一个保存点。 如果该原子块退出且没有异常,将创建用于块提交的保存点,但在该事务在会话级别提交前该事务将不提交。 如果该块引发一个异常,则该块的影响将被回滚,但处于会话级别的事务将继续,除非该异常是注定事务终止的。 例如,写入冲突是注定事务终止的,但不是类型转换错误。
如果在会话上没有处于活动状态的事务,则 BEGIN ATOMIC 将开始一个新事务。 如果在该块的作用域外未引发异常,则在该块的末尾将提交该事务。 如果该块引发异常(也就是说,未在该块内捕获和处理异常),则该事务将被回滚。 对于跨单个原子块的事务(单个本机编译的存储过程),你无需编写显式的 BEGIN TRANSACTION 和 COMMIT 或 ROLLBACK 语句。
本机编译的存储过程支持使用 TRY、 CATCH和 THROW 构造进行错误处理。 不支持RAISERROR 。
下面的示例说明针对原子块和本机编译存储过程的错误处理行为:
-- 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 和 41839。
在编译存储过程时原子块中的会话设置是固定的。 某些设置可使用 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。 SQL Server 事务提交可以是完全持久、默认或延迟的持久。有关详细信息,请参阅《控制事务持久性》。 |
下面的 SET 选项对于所有本机编译存储过程中的所有原子块具有相同的系统默认值:
Set 选项 | 原子块的系统默认值 |
---|---|
ANSI_NULLS | ON |
ANSI_PADDING | ON |
ANSI_WARNING | ON |
ARITHABORT | ON |
ARITHIGNORE | OFF |
CONCAT_NULL_YIELDS_NULL | ON |
IDENTITY_INSERT | OFF |
NOCOUNT | ON |
NUMERIC_ROUNDABORT | OFF |
QUOTED_IDENTIFIER | ON |
ROWCOUNT | 0 |
TEXTSIZE | 0 |
XACT_ABORT | OFF 未捕获的异常导致原子块回滚,但不会导致事务中止,除非错误是注定事务终止的。 |