Saltar a contenido

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 update o delete anidado solo alcanza a los hijos del registro que se actualiza, con las mismas reglas rls que recibe update(). Lo que no casa —no existe, es de otro registro o la regla no lo alcanza— lanza NestedRowNotFound y 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 update anidado que cambia la FK al padre lanza NestedParentMismatch.
  • Se aplican en orden delete → update → create (antes, al revés). Un update y un delete de la misma fila en el mismo payload son un NestedRowNotFound, y un update ya 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.