# Transacciones Una transacción agrupa varias sentencias para que se apliquen **todas o ninguna**. Úsela siempre que una operación toque más de una fila o tabla: un traspaso entre cuentas, una venta con sus partidas y su movimiento de inventario, un folio y el documento que lo usa. | Función | Qué hace | |---|---| | `dbr.begin(db)` | Inicia una transacción. Si ya hay una en curso en esa conexión, **continúa la misma** (no anida ni falla) | | `dbr.commit(db)` | Confirma los cambios. Error si no hay transacción en curso | | `dbr.rollback(db)` | Deshace los cambios desde `dbr.begin`. Error si no hay transacción en curso | | `dbr.in_transaction(db)` | `@true` si hay una transacción en curso en la conexión | - La transacción es **de la conexión**: todas las sentencias deben ir por el mismo `db`. - Cerrar la conexión con una transacción abierta la deshace. - En MySQL, las sentencias DDL (`CREATE`, `ALTER`, `DROP`) confirman la transacción de forma implícita: no las mezcle con datos dentro de una transacción. Las tablas deben ser InnoDB. - Como `dbr.begin` continúa una transacción existente, una función que abre su propia transacción puede llamarse desde otra que ya la abrió; pero el **primer** `dbr.commit` confirma todo. Si arma funciones que se llaman entre sí, deje el `begin`/`commit` en la función de más afuera. ## Patrón recomendado Inicie, haga el trabajo, confirme; ante cualquier error, deshaga **si sigue abierta** y reporte: ```dkl #include "dkli.dkh" #! program "transacciones" { #include "functions.dkh" #include "dbr.dkh" traspaso :: &db, origen, destino, importe { new p { @"o": origen @"d": destino @"imp": importe } do dbr.begin(db) do dbr.execute(db, "UPDATE cuenta SET saldo = saldo - @imp WHERE id = @o", p) if dbr.num(db, "SELECT saldo FROM cuenta WHERE id = @o", p) < 0 { do dbr.rollback(db) return "rechazado: saldo insuficiente" } if dbr.execute(db, "UPDATE cuenta SET saldo = saldo + @imp WHERE id = @d", p) != 1 { do dbr.rollback(db) return "rechazado: cuenta destino inexistente" } do dbr.commit(db) return "aplicado" exception { msg = last_error() do clear_exceptions() if dbr.in_transaction(db) { do dbr.rollback(db) } return "error: " + msg } } ref db = dbr.open("principal@tienda") do dbr.execute(db, "DROP TABLE IF EXISTS cuenta", @null) do dbr.execute(db, "CREATE TABLE cuenta (id INT PRIMARY KEY, saldo DECIMAL(12,2) NOT NULL) ENGINE=InnoDB", @null) do dbr.execute(db, "INSERT INTO cuenta VALUES (1, 1000), (2, 0)", @null) do print(traspaso(db, 1, 2, 300)) do print(traspaso(db, 1, 2, 5000)) do print(traspaso(db, 1, 9, 100)) do print(dbr.str(db, "SELECT CONCAT(GROUP_CONCAT(saldo ORDER BY id SEPARATOR ' / '), '') FROM cuenta", @null)) do print(dbr.in_transaction(db)) do dbr.begin(db) do dbr.begin(db) do print(dbr.in_transaction(db)) do dbr.commit(db) do print(dbr.in_transaction(db)) do dbr.commit(db) exception { do print(last_error()) do clear_exceptions() } do dbr.execute(db, "DROP TABLE cuenta", @null) do dbr.close(db) } ``` ```text aplicado rechazado: saldo insuficiente rechazado: cuenta destino inexistente 700.00 / 300.00 0 1 0 {1} Error en 'dbr.commit. (No se ha iniciado ninguna transacciónException has been thrown by the target of an invocation.) [transacciones.dkl][Ln= 51] ``` El segundo y el tercer traspaso se deshicieron completos: el saldo final (700 / 300) refleja solo el primero. Las últimas líneas muestran que un segundo `dbr.begin` no abre otra transacción y que después del `commit` ya no hay nada que confirmar. ## Lo que pasa si no confirma ```dkl #include "dkli.dkh" #! program "tx2" { #include "functions.dkh" #include "dbr.dkh" ref db = dbr.open("principal@tienda") do dbr.rollback(db) exception { do print(last_error()) do clear_exceptions() } do dbr.execute(db, "DROP TABLE IF EXISTS t_tx", @null) do dbr.execute(db, "CREATE TABLE t_tx (a INT)", @null) do dbr.begin(db) do dbr.execute(db, "INSERT INTO t_tx VALUES (1)", @null) do dbr.close(db) ref db2 = dbr.open("principal@tienda") do print(dbr.num(db2, "SELECT COUNT(*) FROM t_tx", @null)) do dbr.execute(db2, "DROP TABLE t_tx", @null) } ``` ```text {1} Error en 'dbr.rollback. (No se ha iniciado ninguna transacciónException has been thrown by the target of an invocation.) [tx2.dkl][Ln= 8] 0 ``` El `INSERT` se perdió al cerrar la conexión sin `dbr.commit`. ## Con el modelo de Devkron `dbr.save`, `dbr.erase`, `dbr.lock` y las demás funciones del [modelo de datos](/es/devkron/2.0/bibliotecas/motor/dbr/modelo.md) respetan la transacción en curso de la sesión: abra `dbr.begin(ses)` antes de guardar el encabezado y las partidas de un documento y confirme al final. Un orden que funciona bien: validaciones previas → `begin` → trabajo → procesos posteriores que deben quedar en la misma transacción → `commit` → avisos a otros sistemas (correos, llamadas a API), siempre fuera de la transacción. ## Errores típicos | Mensaje | Causa | Solución | |---|---|---| | `No se ha iniciado ninguna transacción` | `dbr.commit` o `dbr.rollback` sin `dbr.begin`, o después de otro `commit` | Compruebe con `dbr.in_transaction` | | `Lock wait timeout exceeded` / `Deadlock found` | Otra transacción tiene bloqueadas las filas | Transacciones cortas; en MySQL el adaptador reintenta estos errores antes de reportarlos | | Los cambios aparecen aunque se hizo `rollback` | Hubo un DDL dentro de la transacción (MySQL confirma implícitamente), o la tabla no es InnoDB | Saque el DDL de la transacción; use InnoDB | [Regresar a dbr.dkh](/es/devkron/2.0/bibliotecas/motor/dbr/)