Envolver automaticamente em uma transação
funcionalColoque o trabalho que não é somente leitura dentro de uma transação que você pode inspecionar e reverter antes que ele se torne permanente.
Com o encapsulamento automático ativado, qualquer coisa além de uma simples leitura é executada dentro de uma transação externa que o SQLly reverte para você. A instrução realmente é executada - você vê a contagem de linhas, a violação da restrição, o disparo do trigger, e então o banco de dados fica exatamente como estava.
O que realmente é enviado
O SQLly reescreve o lote na própria sintaxe de transação do seu mecanismo:
| Motor | Entre aspas |
|---|---|
| SQL Server | SET XACT_ABORT ON; BEGIN TRANSACTION; …; ROLLBACK TRANSACTION; |
| MySQL / MariaDB | START TRANSACTION; …; ROLLBACK; |
| PostgreSQL, SQLite, libSQL / Turso, DuckDB | BEGIN; …; ROLLBACK; |
| Oracle | …; ROLLBACK; - não BEGIN, o que abriria um bloco PL/SQL; o driver desativa o autocommit sob essa política e o ROLLBACK fecha a transação que o Oracle abriu implicitamente |
| ClickHouse | Recusado desde o início - o ClickHouse não tem transações, então não há nada que o wrapper possa reverter |
| Redis | Não aplicável - comandos Redis não são instruções transacionais; use somente leitura ou à confirmação de comandos destrutivos |
XACT_ABORT ON no SQL Server importa: faz com que o servidor abandone toda a transação no primeiro erro em vez de continuar com parte do lote aplicado. Um lote que não é nada além de USE <database> fica sozinho, não há nada a desfazer, e envolvê-lo apenas confundiria o contexto da sessão.
Os casos que ele recusa em vez de falsificar
- DDL do MySQL e Oracle. Ambos fazem commit implicitamente
CREATE,ALTER,DROP,TRUNCATE,RENAME,GRANT, eREVOKE. Dentro do wrap, essas mudanças - e tudo o que veio antes, seriam silenciosamente persistir, o que anula toda a promessa da configuração. O SQLly recusa o lote e avisa, indicando o mecanismo e o verbo, em vez de fingir que reverteu. (CREATE/DROP TEMPORARY TABLEé isento no MySQL; ele não faz commit desses.) - ClickHouse, sempre. Não há transações em que envolver o código, então uma conexão com essa configuração ativada se recusa a executar qualquer coisa sob ela e pede que você desligue a configuração nessa conexão, em vez de fingir.
- Definições de rotina T-SQL.
CREATE/ALTER PROCEDURE,FUNCTION,TRIGGER, eVIEWdevem vir no início do lote, então umBEGIN TRANSACTIONna frente faria o SQL Server rejeitar tudo com o erro 111. Em vez disso, o SQLly dá à definição um lote próprio dentro a transação viaEXEC(N'…'), de modo que o deploy rode, possa ser observado e ainda assim reverta.
Coisas que o encapsulamento não consegue desfazer
Uma transação cobre apenas o que o mecanismo coloca dentro dela. Valores de sequência e identidade consumidos por um insert não são devolvidos, o trabalho feito por um servidor vinculado ou por uma transação autônoma fica fora do escopo, e qualquer mecanismo que faça commit de DDL implicitamente se comporta como esse mecanismo se comporta. O wrap é um excelente ensaio; não é uma máquina do tempo.