Actualizar a la 0.8.0¶
La 0.8.0 cambia el comportamiento del cliente generado en cinco sitios donde antes hacía
otra cosa de la pedida sin avisar. Casi todos los cambios convierten un silencio en un error;
dos de ellos —la lista vacía y las agregaciones— cambian lo que devuelve una llamada que antes
funcionaba. El schema, el DDL y el push no cambian.
Los pasos¶
pip install -U 'tai-sql==0.8.0'
tai-sql generate -s <schema> # por cada schema: el cliente generado es el que cambia
tai-sql rules install # las reglas del asistente, si las usas
Después, revisa en tu código lo que dice cada apartado de abajo.
Lo que rompe¶
Una lista vacía en in_<campo> es «ninguna fila»¶
find_many(in_id=[]) devuelve [], count(in_id=[]) 0, y delete_many(in_id=[]) o un
update_many cuyo Filter lleva in_<campo>=[] no tocan nada. Hasta la 0.7.21 la lista vacía
se ignoraba: devolvía todas las filas y delete_many(in_id=[]) vaciaba la tabla.
Qué hacer: busca las llamadas que pasan [] para decir «todos» y pasa None, o no pases el
filtro. Ver lectura.
Las escrituras anidadas de un update se acotan al padre y no se saltan¶
- Un
updateodeleteanidado solo alcanza a los hijos del registro que se actualiza, con las mismas reglasrlsque recibeupdate(). Lo que no casa —no existe, es de otro registro o la regla no lo alcanza— lanzaNestedRowNotFoundy no se escribe nada, padre incluido. Antes se podía borrar el hijo de otro registro, y un hijo que no se encontraba se ignoraba. - Un
updateanidado que cambia la FK al padre lanzaNestedParentMismatch. - Se aplican en orden
delete→update→create(antes, al revés). Unupdatey undeletede la misma fila en el mismo payload son unNestedRowNotFound, y unupdateya no alcanza a una fila que el mismo payload crea. - Un hijo anidado no puede traer la relación con su padre:
ValidationError.
Qué hacer: un formulario que reenvía borrados de filas ya borradas, o claves de otro
registro, ahora falla entero; captura NestedWriteError donde lo necesites. Ver
escritura.
update_many rechaza las escrituras anidadas¶
<Modelo>Update no se construye con relaciones anidadas en values (ValidationError), y
update_many lo comprueba otra vez (ValueError). Antes se descartaban sin error, o se
aplicaban una vez por cada fila que casara.
Qué hacer: update() por cada registro, o el DAO de la tabla hija.
Un update() sin columnas del padre ya no es un no-op¶
En una tabla sin campos operativos, un update() solo con anidados —o vacío— sobre una fila que
existe devuelve 1 y dispara los triggers de update del padre que no filtran por fields. Antes
devolvía 0 sin escribir nada.
Las columnas bytes viajan en base64¶
En JSON, una columna bytes se lee y se escribe en base64 (estándar o URL-safe al leer;
estándar con relleno al escribir). Antes iba en UTF-8: el base64 se guardaba como texto y un
binario de verdad no se podía serializar. Las filas antiguas no hay que migrarlas.
Qué hacer: el frontend manda el base64 sin el prefijo data:…;base64, —con él es un
bytes_invalid_encoding— y puede decodificar lo que recibe con atob() sin normalizarlo. Ver
las columnas bytes en JSON.
Una agregación imposible es success=False¶
sum, mean, max, min y agg deciden por el tipo de cada columna qué se puede agregar.
Lo que no se puede —un campo que no existe, sum de un texto, un trunc sobre un date—
hace fallar la petición entera: success=False, sin filas y el motivo en errors. Antes se
descartaba con un aviso y la clave faltaba en data, con success=True. A cambio, max y
min de un texto pasan a valer, y count de un bytes, dict o vector.
Qué hacer: comprueba success antes de leer rows. Ver
agregaciones.
Lo que se añade¶
in_<pk>en la clave primaria autoincremental:find_many(in_id=[3, 7]). Antes no tenía ningún filtro. Igualdad y rango siguen sin existir: para un registro,find(id).
Si usas tai-api¶
Los errores nuevos llevan lo que tai-api necesita para responder bien —NestedRowNotFound como
404, NestedParentMismatch y los ValidationError como 422, success=False como 422—, pero
solo una versión de tai-api que los conozca los traduce: con una anterior, un
NestedRowNotFound sale como un 500. Regenera la API después del cliente.