トランザクションの自動ラップ
実装済み読み取り以外の作業は、確定する前に確認やロールバックができるトランザクション内に置きます。
自動ラップがオンの場合、単純な読み取り以外の処理がすべて通るのは SQLly が自動的にロールバックする外側のトランザクション。ステートメントは実際に実行されます。行数、制約違反、トリガーの発火が確認でき、その後データベースは元のままに戻されます。
実際に送信される内容
SQLly は、お使いのエンジン固有のトランザクション構文でバッチを書き換えます:
| エンジン | ラップ |
|---|---|
| SQL Server | SET XACT_ABORT ON; BEGIN TRANSACTION; …; ROLLBACK TRANSACTION; |
| MySQL / MariaDB | START TRANSACTION; …; ROLLBACK; |
| PostgreSQL、SQLite、libSQL/Turso、DuckDB | BEGIN; …; 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。ラップの内側では、これらの変更と、その前にあるすべてが、黙って persist、設定の約束を根本から破ってしまいます。SQLly はロールバックしたふりをせず、エンジンと動詞を名指ししてバッチを拒否し、その旨を伝えます。(CREATE/DROP TEMPORARY TABLEは MySQL では対象外です。これらはコミットされません。) - ClickHouse なら常に対応しています。 ラップするトランザクションがないため、この設定をオンにした接続では何も実行できません。その場合、実行したふりをせず、その接続ではこの設定をオフにするよう案内します。
- T-SQL のルーチン定義。
CREATE/ALTER PROCEDURE,FUNCTION,TRIGGER、そしてVIEWバッチの先頭になければならないので、BEGIN TRANSACTIONその前に付けると、SQL Server はエラー 111 で全体を拒否します。そのため SQLly は定義に専用のバッチを与えます 内部の トランザクションを経由してEXEC(N'…')、そのため、デプロイは実行され、観測でき、それでもロールバックされます。
実行前にプレビューします。 同じロジックが、実行を伴わないプレビューにも使われます。ステージング接続や本番接続でも、サーバーに触れることなく、送信されるはずの正確な SQL(ラップされたか拒否されたか、その理由付き)を確認できます。
ラップでは元に戻せないもの
トランザクションがカバーするのは、エンジンがその内側に置くものだけです。INSERT で消費されたシーケンス値や ID 値は元に戻りません。リンクサーバーや自律トランザクションが行った処理は対象外です。DDL を暗黙的にコミットするエンジンでは、そのエンジンの動作に従います。ラップは優れたリハーサルですが、タイムマシンではありません。