En este artículo quiero compartir una inducción que realicé para un nuevo integrante de nuestro equipo de desarrollo, donde explico cómo usamos Liquibase en nuestros proyectos empresariales.
Durante la sesión repasamos la estrategia que seguimos para gestionar las migraciones de base de datos y las buenas prácticas que aplicamos en nuestro flujo de trabajo. Entre los puntos más importantes se incluyen:
Migraciones masivas en producción
Usamos un archivo personalizado llamado migraciones.sh, encargado de aplicar de manera ordenada y centralizada los cambios a todas las bases de datos en los entornos productivos.
Ventaja: reduce el riesgo de errores manuales, garantiza consistencia entre múltiples instancias y facilita la automatización del despliegue.
Sintaxis en nombre de archivos SQL
Seguimos un estándar que incluye la fecha, versión del día y número de historia de usuario. Ejemplo:
250922.0_US345.sql # primera actualización sql el 22-09-25 de la US 345 por Diego
250922.1_US345.sql # segunda actualización sql el 22-09-25 de la misma US 345 por DiegoVentaja: asegura trazabilidad clara, permite identificar rápidamente la procedencia de cada cambio y evita duplicidad o confusión en ambientes con múltiples migraciones diarias.
Identificación o auditoría de archivo SQL
Cada desarrollador trabaja exclusivamente en una historia de usuario, y cada archivo changelog sql tiene el nombre del autor junto con el número de la historia como identificador. Ejemplo:
--liquibase formatted sql
--changeset diego:250922.0_US345
ALTER TABLE entidad_contacto ADD eco_nombres varchar(200) NOT NULL;
ALTER TABLE entidad_contacto ADD eco_movil varchar(20) NULL;
ALTER TABLE entidad_contacto ADD eco_correo varchar(200) NULL;Ventaja: asegura responsabilidad clara sobre cada cambio, facilita auditorías y permite mantener trazabilidad entre desarrollador, historia de usuario y alteraciones en la base de datos.
Commits semánticos integrados con nuestra herramienta scrum
Utilizamos la convención de semantic commits, integrando el módulo y la historia de usuario de nuestra herramienta de gestión Scrum Kados. Ejemplo:
feat(CRM,US345): se agregaron nuevos campos a tabla entidad_contactoVentaja: mantenemos un historial de cambios estandarizado, fácil de auditar, y con una conexión directa entre la gestión de tareas en Kados y la evolución de la base de datos.
Este material está pensado no solo como guía para nuevos integrantes, sino también como una referencia práctica para todo el equipo, asegurando consistencia, trazabilidad y calidad en la gestión de cambios de nuestras bases de datos.
