Автоматическое оборачивание в транзакцию

функциональный

Любую работу, кроме чтения, выполняйте в транзакции, которую можно проверить и откатить, пока изменения не стали окончательными.

С включенным автоматическим оборачиванием в транзакцию всё, что выходит за рамки обычного чтения, выполняется внутри внешней транзакции, которую 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'…'), так что деплой выполняется, наблюдаем и при этом откатывается.
Предпросмотр перед запуском. Та же логика питает предпросмотр без выполнения: подключение к staging- или продакшн-базе может показать вам точный SQL, который был бы отправлен (обёрнутый или отклонённый, с причиной), не трогая сервер.

Чего не может отменить обёртка

Транзакция охватывает только то, что движок помещает внутрь нее. Значения последовательностей и идентификаторов, израсходованные вставкой, не возвращаются, работа, выполненная через связанный сервер или автономную транзакцию, находится вне зоны действия, а любой движок, который неявно фиксирует DDL, ведет себя так, как ведет себя этот движок. Обертка — отличная репетиция, но не машина времени.