tai-sql feed¶
Ejecuta los métodos feed() de las tablas, en orden topológico por claves
foráneas y en una sola transacción: si falla una tabla, no queda aplicada ninguna.
Las opciones¶
| Opción | Qué hace |
|---|---|
-t, --table |
Alimenta solo esa tabla |
--clean |
Vacía las tablas antes de alimentarlas, con la sentencia de cada motor |
-d, --dry-run |
Muestra qué se insertaría sin ejecutar |
-f, --force |
Ejecuta aunque haya cambios pendientes o tablas sin clave de conflicto |
--continue-on-error |
Sigue con las demás tablas si una falla, en vez de deshacer el feed |
-v, --verbose |
Detalle de cada paso |
--clean borra más de lo que parece
Vacía las tablas indicadas y las que dependan de ellas. No es «volver al estado inicial»: es borrar datos.
Idempotencia: la clave natural¶
El feed hace upsert usando la clave natural de la tabla, que es una unique_constraint.
Una tabla sin ninguna, con clave primaria autoincremental, no tiene clave de conflicto: cada ejecución insertaría las mismas filas otra vez. El plan lo decide antes de ejecutar y, si alguna tabla no tiene identidad, corta con un error que dice cómo dársela.
class Rol(Table):
__tablename__ = 'rol'
__constraints__ = unique_constraint('nombre', 'tenant_id') # ← esto
--force salta esa comprobación. Es lo que quieres en una tabla de log, y lo que no quieres en
ninguna otra.
En una fila que ya existía, el upsert actualiza lo que declara el feed() salvo tres cosas: la
clave generada, las columnas hasheadas —lo que declara un feed() es la contraseña inicial, no
la vigente— y created_at/created_by, que dicen cuándo se creó la fila. updated_at sí
avanza en cada ejecución. Hasta la 0.8.7, cada tai-sql feed movía la fecha de creación.
Ids fijados y secuencias¶
Un feed() puede escribir la clave autoincremental a mano (Role(id=1)) para que filas de otros
feed() la referencien por su valor (User(realm_id=1)). Lo anidado no lo necesita —el hijo recibe
la clave que genere la base—, pero lo que viene de otra tabla sí.
Escribir el id a mano no avanza la secuencia de la columna, y la siguiente fila que creara la aplicación sacaría ese mismo id y chocaría con la clave primaria. Por eso el feed, después de escribir una tabla con ids fijados, pone su secuencia detrás del mayor. Solo la sube: si la aplicación ya había ido más allá, la deja donde estaba, para que un id que fue de una fila borrada no se reutilice.
Es cosa de PostgreSQL: MySQL y SQL Server ajustan su contador solos y BigQuery no tiene secuencias.
SQL Server pide otra cosa: no deja escribir un id en una columna IDENTITY sin IDENTITY_INSERT, y
el feed lo activa solo mientras escribe esa tabla.
Si la fila ya existía —la reconoce su clave natural—, el feed actualiza sus demás columnas pero no
su id: el que trae el feed() sirve para crearla, no para cambiarle la identidad a una fila que ya
tiene la suya y quizá hijos que la referencian.
Qué no hace¶
- No codifica vectores: una columna vectorial con encoder y sin valor es un error con su solución. Codificar es trabajo del cliente generado, en runtime.
- No ejecuta los triggers del cliente generado: el feed inserta contra la base de datos.
Dentro de un push¶
Ejecuta el feed entre la creación de las tablas y la aplicación de las claves foráneas. Sirve cuando los datos iniciales son necesarios para que las FKs se puedan aplicar sin filas huérfanas.