Error al actualizar a
SYSplus por dependencia UDF no eliminada
1. Error:
Descripción:
Durante el proceso de actualización de la base de datos a SYSplus ERP 2026,
al ejecutar el script 2026FB5, el sistema puede presentar un error
similar al siguiente:
Error
while parsing procedure XXXXX's BLR. Invalid request BLR. Function BIN_AND is
not defined
El error
se presenta durante la ejecución de los scripts de actualización y está
relacionado con una UDF (User Defined Function) que aún permanece
registrada en la base de datos.
Aunque el
caso de referencia corresponde a la función BIN_AND, el mismo
comportamiento puede presentarse con cualquiera de las 10 UDF que deben
ser eliminadas durante el proceso de actualización.
2. Diagnóstico:
Causa
Raíz:
El error se genera porque una de las UDF utilizadas en versiones anteriores no
fue eliminada correctamente mientras la base de datos todavía se encontraba en
Firebird 3.
Para la
actualización a la versión 2026 con Firebird 5, estas dependencias ya no
deben permanecer registradas en la base de datos.
Cuando
alguna UDF no se elimina correctamente, puede quedar una dependencia en
procedimientos almacenados u otros objetos de la base de datos. Al ejecutar el
script 2026FB5, Firebird intenta interpretar nuevamente dicha
dependencia y genera el error:
Function
BIN_AND is not defined
Cómo
identificarlo:
- Confirme que el error se
presenta durante la ejecución del script 2026FB5.
- Revise el nombre de la
función indicado en el mensaje de error.
- Si el mensaje menciona una
función como BIN_AND, valide que dicha UDF haya sido eliminada
durante la preparación de la base de datos en Firebird 3.
- Tenga presente que BIN_AND
es únicamente un ejemplo; el error puede generarse por cualquiera de
las 10 UDF que no hayan sido eliminadas correctamente.
Ejemplo:
3. Solución:
Pasos a seguir:
- No continuar con la
actualización a Firebird 5 mientras exista una UDF pendiente de
eliminación.
- Retornar a la base de datos
en Firebird 3, si el proceso de actualización aún lo permite. De lo
contrario instalar Firebird en otra maquina de manera provisional y pasar
la base de datos SYSPLUS.FDB antes de hacer el backup
- Ejecutar correctamente los
scripts de preparación correspondientes:
- Verificar que, al finalizar
la ejecución de estos scripts, se hayan eliminado correctamente las 10
UDF requeridas.
- En caso de que alguna UDF
permanezca registrada, realizar la corrección correspondiente antes de
continuar con el proceso de actualización.
- Una vez confirmada la
eliminación de las UDF, realizar nuevamente el backup de la base de
datos desde Firebird 3.
- Posteriormente, continuar
con el proceso de restauración/migración hacia Firebird 5 y
ejecutar el script 2026FB5.
- Validar que la actualización
finalice correctamente y que no se presenten nuevamente errores
relacionados con funciones UDF.
Importante
Se debe
validar que las UDF hayan sido efectivamente eliminadas antes de generar el
backup que será utilizado para la migración a Firebird 5.
Notas / Prevención:
- La validación de las UDF
debe realizarse antes de generar el backup en Firebird 3 que
posteriormente será utilizado en Firebird 5.
- Si una UDF no fue eliminada
correctamente, no se recomienda continuar directamente con Firebird 5,
ya que pueden aparecer errores de dependencias al ejecutar los scripts de
actualización.
- El nombre BIN_AND
corresponde al caso identificado; el mismo error puede presentarse con
cualquiera de las 10 UDF que debían ser eliminadas.
- Ante un error de este tipo,
se recomienda conservar el mensaje completo indicando el nombre de la
función y el procedimiento afectado, ya que esta información permite
identificar la dependencia que está ocasionando el inconveniente.
- La revisión y corrección de
la estructura de la base de datos debe ser realizada por personal técnico
autorizado.
Resultado
esperado: La base
de datos debe quedar, antes de generar el backup desde Firebird 3, sin las
UDF correspondientes a la versión anterior. De esta manera, al restaurarla
en Firebird 5 y ejecutar 2026FB5, no se presentarán errores de
dependencias relacionadas con funciones como BIN_AND.