自动在事务中执行

功能的

将非读取操作放入事务中,你可以在它变成永久操作之前进行检查和回滚。

开启自动包裹后,除纯读取之外的任何操作都会运行在 外部事务中运行,SQLly 会为你回滚该事务。这条语句会真正执行——你会看到行数、约束冲突和触发器触发,最后数据库恢复原样。

实际发送的内容

SQLly 会用你的引擎自己的事务语法重写批处理:

引擎包裹
SQL ServerSET XACT_ABORT ON; BEGIN TRANSACTION; …; ROLLBACK TRANSACTION;
MySQL / MariaDBSTART TRANSACTION; …; ROLLBACK;
PostgreSQL、SQLite、libSQL / Turso、DuckDBBEGIN; …; ROLLBACK;
Oracle…; ROLLBACK; - 不 BEGIN,这会打开一个 PL/SQL 块;在这种策略下,驱动程序会关闭自动提交,而尾随的 ROLLBACK 会关闭 Oracle 隐式打开的事务
ClickHouse提前拒绝——ClickHouse 没有事务,就算包一层事务也没有东西可回滚
Redis不适用 - Redis 命令不是事务性语句;请改用 只读 或改为破坏性命令的确认方式

XACT_ABORT ON 在 SQL Server 上很重要:它让服务器在遇到第一个错误时就放弃整个事务,而不是带着已应用的部分批处理继续跑。一个只包含 USE <database> 会被原样放过——本来就没有什么可撤销的,硬把它包进事务只会搅乱会话上下文。

宁可拒绝,也不假装

  • MySQL 和 Oracle 的 DDL。 两者都会隐式提交 CREATE, ALTER, DROP, TRUNCATE, RENAME, GRANT,以及 REVOKE。在回滚包裹之内,这些更改——连同它们之前的所有内容——都会悄无声息地 持久化,这就破坏了该设置的全部承诺。SQLly 会拒绝这个批次并明说,指出引擎和语句动词,而不是假装已经回滚。(CREATE/DROP TEMPORARY TABLE 在 MySQL 上是例外;它不会提交这些语句。)
  • 永远是 ClickHouse。 没有事务可供包裹,因此开启该设置的连接会拒绝执行其下的任何语句,并提示你为该连接关闭这一设置,而不是假装能行。
  • T-SQL 例程定义。 CREATE/ALTER PROCEDURE, FUNCTION, TRIGGER,以及 VIEW 必须位于其批处理的开头,所以 BEGIN TRANSACTION 会导致 SQL Server 以错误 111 拒绝整个操作。SQLly 会为该定义提供它自己的批处理 内部 事务,经由 EXEC(N'…'),因此部署照常运行、全程可观察,并且仍然能够回滚。
运行前先预览。 同样的逻辑还支撑着不执行的预览:暂存或生产连接可以把将要发送的确切 SQL 展示给你(会被包装或拒绝,并附带原因),而完全不碰服务器。

回滚包装无法撤销的事情

事务只覆盖引擎放进它里面的东西。插入所消耗的序列值和标识值不会归还,链接服务器或自主事务完成的工作不在其范围内,而任何隐式提交 DDL 的引擎都仍按该引擎自己的方式行事。这种包裹演练非常出色,但它不是时间机器。