Yoyo-migrations

Yoyo-migraciones es una utilidad de migración de esquema de base de datos utilizando SQL normal y el DB-API.
¿Qué-migraciones Yoyo hacer?
Como las aplicaciones de bases de datos evolucionan, a menudo se requieren cambios en el esquema de base de datos. Estos por lo general se pueden escribir como scripts SQL puntuales que contienen CREATE / ALTER TABLE (aunque cualquier secuencia de comandos SQL o pitón se puede usar con yoyo-migraciones).
YOYO-migraciones proporciona una herramienta de línea de comandos para la lectura de un directorio de tales secuencias de comandos y su aplicación a la base de datos según se requiera.
Soporte Base de datos
Bases de datos PostgreSQL, MySQL y SQLite son compatibles.
Uso
Yoyo-migraciones generalmente se invoca como un script de línea de comandos.
Ejemplos:
Leer todas las migraciones de las migraciones de directorio y aplicarlos a una base de datos PostgreSQL:
yoyo-migrate aplica ./migrations/ postgres: // usuario: contraseña @ localhost / base de datos
Migraciones Rollback aplicados previamente a una base de datos MySQL:
yoyo-migrate rollback ./migrations/ mysql: // usuario: contraseña @ localhost / base de datos
Vuelva a aplicar (es decir rollback a continuación, aplicar de nuevo) las migraciones a una base de datos SQLite en la ubicación /home/sheila/important-data.db:
yoyo-migrar sqlite reaplicar ./migrations/: ////home/sheila/important-data.db
Por defecto, yoyo-migraciones comienza en modo interactivo, que le pide para cada archivo de migración antes de aplicarlo, por lo que es fácil elegir las que las migraciones de aplicar y reversión.
El directorio de las migraciones debe contener una serie de scripts de migración. Cada script de migración es un archivo Python (.py) que contiene una serie de pasos. Cada paso debe comprender una consulta migración y (opcionalmente) una consulta de reversión. Por ejemplo:
#
# Archivo: migraciones / 0001.create-foo.py
#
el paso (
& Nbsp; "CREATE foo MESA (int id, bar VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
)
El nombre de archivo de cada archivo (sin la extensión .py) se utiliza como el identificador para cada migración. Migraciones se aplican en orden de nombre de archivo, por lo que es útil para nombrar sus archivos usando una fecha (por ejemplo, '20090115-xyz.py') o con otro número incremental.
yoyo-migrate crea una tabla en la base de datos de destino, _yoyo_migration, el seguimiento de las migraciones que se han aplicado.
Pasos también pueden tomar un ignore_errors argumento opcional, que debe ser uno de aplicar, reversión, o todos. Si en el ejemplo anterior, la tabla foo ya podría haber sido creado por otro medio, podríamos añadir ignore_errors = 'aplicar' al paso para permitir que las migraciones a continuar independientemente:
#
# Archivo: 0001.create-foo.py
#
el paso (
& Nbsp; "CREATE foo MESA (int id, bar VARCHAR (20), PRIMARY KEY (id))",
& Nbsp; "DROP TABLE foo",
& Nbsp; ignore_errors = 'aplicar',
)
Pasos también pueden ser objetos de Python no desembolsadas que tengan una conexión de base de datos como su único argumento. Por ejemplo:
#
# Archivo: 0002.update_keys.py
#
do_step def (conn):
& Nbsp; cursor = conn.cursor ()
& Nbsp; cursor.execute (
& Nbsp; "INSERT INTO sysinfo"
& Nbsp; "(osname, nombre de host, la liberación, la versión, el arco)"
& Nbsp; "VALUES (% s,% s,% s,% s,% s% s)",
& Nbsp; os.uname ()
& Nbsp;)
el paso (do_step)
La seguridad de contraseña
Normalmente especificar su nombre de usuario y la contraseña de base de datos como parte de la cadena de conexión de base de datos en la línea de comandos. En una máquina multi-usuario, otros usuarios pueden ver su contraseña de base de datos en la lista de procesos.
La bandera -p o --prompt-password causa yoyo-migrate para que solicite una contraseña, ignorando cualquier contraseña especificada en la cadena de conexión. Esta contraseña no estará disponible para otros usuarios a través de la lista de procesos del sistema.
Conexión cadena caché
La primera vez que ejecute yoyo-migra con una nueva serie de migraciones, se le preguntará si desea almacenar en caché la cadena de conexión de base de datos en un archivo llamado .yoyo-migrar en el directorio de las migraciones.
Esta caché es local en el directorio de las migraciones, así ejecuciones posteriores sobre el mismo conjunto de migración no necesitan la cadena de conexión de base de datos que se determine.
Esto ahorra escribir, evita su nombre de usuario de base de datos y muestra la contraseña en los listados de procesos y disminuye el riesgo de ejecutar accidentalmente yoyo-migrar la base de datos incorrecto (es decir, volver a ejecutar una entrada yoyo-migrar antes en su historia de comandos cuando se ha mudado a un diferente directorio).
Si no desea que este archivo de caché para ser utilizado, agregue el parámetro --no-cache para las opciones de línea de comandos

¿Qué hay de nuevo en esta versión:.

• Arreglo para el administrado mal lanzamiento 4.2.3

¿Cuál es nuevo en la versión 4.2.1:

• Solución de error de la versión anterior, que omite los archivos críticos.

¿Cuál es nuevo en la versión 4.1.6:

• Se ha añadido soporte de Windows (gracias a Peter Shinners)

¿Cuál es nuevo en la versión 4.1.5:

• Configurar controladores de registro para que las causas del interruptor -v salida vaya a la consola (gracias a Andrew Nelis).
• `` interruptor de línea de comandos -v`` ya no toma un argumento, pero puede especificarse varias veces en lugar (es decir, el uso `` -vvv`` en lugar de `` -v3``). `` --verbosity`` Conserva el antiguo comportamiento.

¿Cuál es nuevo en la versión 4.1.3:

• Se ha cambiado el nombre por defecto tabla de migración de vuelta a '_yoyo_migration'

Requisitos :

• Python