Saltar a contenido

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:

  1. 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.
  2. 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 realm main, el rol Administrador y los permisos sudo y main-admin—, que se quedan con el suyo. Así un tai-sql feed posterior reconoce lo que ya hay.
  3. Rellena las relaciones por id (realm_id, parent_id, user_id, role_id, permission_id), cruzando por nombre dentro de cada realm.
  4. Cierra las sesiones abiertas: los tokens de antes identifican al usuario por su nombre, y todo el mundo vuelve a entrar una vez.
  5. 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.py con la plantilla nueva, conservando su datasource() y su generate(). Solo si es la plantilla anterior sin cambios: si el proyecto le añadió una columna, una tabla o un feed() 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