# DDM en producción Procedimientos recomendados para usar `install-model` sobre bases de datos en producción. Se derivan de las [reglas de actualización](/es/devkron/2.0/bibliotecas/ddm/herramientas.md). Pruebe cada procedimiento en una **copia** de la base antes de aplicarlo. ## Adoptar DDM sobre una base existente 1. Obtenga el modelo actual: `dkl dbgen db=miconexion@grupoapps fmt=json out=./actual.json` (el modo `fmt=ddm` no funciona en la versión actual; escriba el `.ddm` tomando el JSON como guía). 2. Escriba y complete el `.ddm`: índices de una sola columna, llaves foráneas cuyo campo clave no sea la clave primaria, atributos de columna. 3. Haga el ensayo previo (en esta página) **antes** de la primera instalación. Esa primera instalación infiere la base real como línea base, y cualquier diferencia de tipo (`bigint`, `char`…), nulabilidad o unicidad contra el `.ddm` aparece como `MODIFY COLUMN` o como incompatibilidad. 4. Si la base nunca usó `install-model`, verifique que no existan solo `sys_model_log` y `sys_model_ddl_log` sin `sys_packs`: la herramienta exige las tres y, si falta alguna, intenta crearlas todas y falla porque la tabla ya existe. En ese caso cree `sys_packs` a mano. ## Ensayo previo de un cambio ```bash # 1. JSON del modelo vigente (si es la primera vez, quite del archivo los mensajes previos al JSON) dkl install-model db=miconexion@grupoapps action=show-model > a.json # 2. JSON del modelo nuevo (la carpeta de salida debe existir) dkl dbgen src=nuevo.ddm out=./b.json # 3. Script con el cambio dkl dbgen a=a.json b=b.json fmt=gen_mysql.dkl out=./cambio.sql ``` Revise `cambio.sql` y la consola: cualquier incompatibilidad impresa abortaría `install-model`. Pruebe el script en una copia antes de instalar. ## Agregar una columna obligatoria a una tabla con datos DDM no puede crearla ya `required` ni endurecer después una columna existente: 1. Agregue la columna **sin** `required` en el `.ddm` e instale. 2. Rellene los datos existentes. 3. Aplique a mano `ALTER TABLE … MODIFY COLUMN … NOT NULL` con la definición completa de la columna. 4. Ejecute `dkl install-model db=… action=infer-model` para que el modelo registrado refleje la base. 5. Marque la columna como `required` en el `.ddm` y repita el ensayo previo hasta que no queden diferencias. El paso 4 reemplaza toda la línea base por lo inferido de la base real; cualquier otra diferencia entre la inferencia y el `.ddm` (tipos como `bigint` o `char`, `unique`) saldrá en la siguiente instalación. ## Ampliar una columna obligatoria Es compatible, pero el `MODIFY COLUMN` generado no incluye `NOT NULL` ni `AUTO_INCREMENT` y MySQL reemplaza la definición completa: la columna queda **admitiendo nulos** (ver limitaciones). Después de instalar, vuelva a aplicar `NOT NULL` a mano y verifique `IS_NULLABLE` en `information_schema.COLUMNS`. ## Retirar una columna Quitarla del `.ddm` no la elimina. Si es obligatoria, la aplicación debe seguir llenándola o hacerla nullable a mano. Use `strict compatibility` en esa entidad para que DDM avise antes de que se retire del modelo. Para eliminarla, SQL manual y luego `infer-model`. ## Renombrar una columna o una tabla DDM no renombra: un nombre nuevo es una columna (o tabla) **nueva** y la anterior permanece. Renombre con SQL manual y re-sincronice con `infer-model`. ## Cambiar índices o llaves foráneas de tablas existentes Con SQL manual; después, `infer-model` si quiere que el modelo registrado lo refleje. Los de tablas nuevas sí los crea DDM. ## Después de un fallo 1. Lea la consola: el motivo de una incompatibilidad solo aparece ahí. 2. Revise `sys_model_ddl_log` (filas con `success = 0`) o ejecute `show-last-error`. 3. Si falló un índice o una llave foránea de una tabla nueva, créelo a mano: una nueva ejecución no lo reintentará. 4. Corrija la causa y vuelva a ejecutar; lo ya aplicado no se repite. ## Limitaciones conocidas Corresponden a la rama `main` del repositorio, commit `2770168`. Los puntos 1 y 3 describen lo que hace MySQL con el SQL que genera la herramienta; verifíquelos en una copia. 1. **Ampliar una columna quita `NOT NULL` y `AUTO_INCREMENT`.** `UNIQUE` y `PRIMARY KEY` se conservan (son índices aparte). El modelo registrado no registra la pérdida. Aplique `NOT NULL` a mano. Pasa también con acciones de cambio que no modifican nada real (un tamaño menor en el modelo nuevo, o `char` contra `string` en una línea base inferida). 2. **Un fallo no cambia el código de salida** de `dkl` (verificado con Devkron 2.0: la incompatibilidad `{99}` termina con código 0) y el detalle de una incompatibilidad solo va a la consola. En ejecuciones desatendidas, capture y revise la salida. 3. **Un índice o llave foránea de una tabla nueva que falla** queda registrado como instalado y no se reintenta. 4. **`decimal` sin `(precisión, escala)`** no recibe los valores por omisión previstos. 5. **El campo `compatible` de `sys_model_log`** se toma solo de la primera tabla comparada. 6. **`dbgen db=… fmt=ddm` falla** con `La variable 'output' ya fué inicializada con un tipo diferente…`; use `fmt=json`. 7. **SQL Server:** `memo` y `mmemo` se generan como `VARCHAR(65535)` y `VARCHAR(16777215)`, que SQL Server no acepta. ## Resumen rápido | Quiero… | ¿Con DDM? | |---|---| | Crear tablas, índices y llaves foráneas nuevas | Sí | | Agregar una columna opcional a una tabla existente | Sí | | Agregar una columna `required` o `key` a una tabla existente | No directamente: procedimiento (en esta página) | | Ampliar un `string` o un `decimal`, o pasar a un tipo más amplio | Sí (revise `NOT NULL` después) | | Reducir tamaños o cambiar a un tipo incompatible | No | | Cambiar `required`, `unique`, `key` o `autoincrement` de una columna existente | No (manual) | | Eliminar o renombrar columnas y tablas | No (manual) | | Cambiar índices o llaves foráneas de tablas existentes | No (manual) | | Valores por omisión, `CHECK`, motor, juego de caracteres, acciones de llave foránea, clave compuesta | No hay sintaxis | | Saber si un modelo se instalaría sin aplicarlo | Ensayo previo (en esta página) | | Re-sincronizar el modelo registrado tras un cambio manual | `install-model … action=infer-model` | [Regresar a DDM](/es/devkron/2.0/bibliotecas/ddm/)