auth-migrate¶
tai-sql auth-migrate pasa el schema auth de la plantilla por nombre (hasta la 0.8.4) a la de
ids (desde la 0.8.5).
Hasta la 0.8.4, la identidad de un usuario era su nombre en su realm, (username, realm_name), y las
relaciones iban por nombres. Borrar a «ana» y crear otra «ana» daba la misma clave, y la nueva
heredaba lo que otros schemas guardaban de la primera. Desde la 0.8.5 cada tabla tiene un id —el de
user, un UUID que pone la base de datos—, un unique con su clave natural y relaciones por id.
push no puede hacer ese paso: los ids nuevos hay que rellenarlos cruzando por nombre antes de
quitar las columnas por nombre. Eso es lo que hace este comando.
tai-sql backup -s auth # antes de nada: cambia las claves de todo auth
tai-sql auth-migrate --dry-run # qué haría, sin escribir
tai-sql auth-migrate # lo aplica, después de confirmar
tai-sql generate -s auth # el cliente, con los ids
No lleva --schema: migra siempre el schemas/auth.py del proyecto, y la conexión es la de su
datasource(). Solo PostgreSQL.
Qué hace¶
En una transacción, con las tablas de auth bloqueadas:
- Comprueba que cada fila tiene pareja: un usuario, su realm; una asignación, su usuario y su rol en el mismo realm… Si hay alguna suelta, se para sin escribir nada y dice cuántas.
- Añade los ids. El del usuario lo genera la base de datos; los demás van por orden de su clave
natural, salvo los que fija el
feed()de la plantilla —el realmmain, el rolAdministradory los permisossudoymain-admin—, que se quedan con el suyo. Así untai-sql feedposterior reconoce lo que ya hay. - Rellena las relaciones por id (
realm_id,parent_id,user_id,role_id,permission_id), cruzando por nombre dentro de cada realm. - Cierra las sesiones abiertas: los tokens de antes identifican al usuario por su nombre, y todo el mundo vuelve a entrar una vez.
- Quita las columnas por nombre y crea las claves de la plantilla nueva, con los mismos nombres que
les daría
push.
Si algo falla, no queda nada a medias. Después:
- Reescribe
schemas/auth.pycon la plantilla nueva, conservando sudatasource()y sugenerate(). Solo si es la plantilla anterior sin cambios: si el proyecto le añadió una columna, una tabla o unfeed()propio, no lo toca y dice qué tiene distinto, para pasarlo a mano. - Compara la base de datos con el schema nuevo. Normalmente coinciden. Si la base de datos venía
de una plantilla aún más antigua (sin las columnas de la sesión con cookie, por ejemplo), lo que
falte lo añade
tai-sql push -s auth.
Lo que se lleva por delante¶
Una vista de otro schema que use una columna por nombre (auth."user".realm_name…) se elimina
con ella, y una clave ajena de otro schema que apunte a la clave por nombre, también. El comando
las lista antes de pedir confirmación. Las vistas las vuelve a crear el push de su schema, con su
SQL ya por id.
Si ya está migrada¶
No hace nada con la base de datos: lee su forma, no la del fichero. Se puede lanzar dos veces.
| Opción | |
|---|---|
-d, --dry-run |
Hace todo en una transacción que se deshace: comprueba que se puede aplicar y cuenta lo que haría |
-f, --force |
No pide confirmación |