如何在mlflow中重命名已记录参数且不丢失历史数据

问题1：能否通过MLflow重命名已记录的历史参数？ #

MLflow没有提供直接的API或工具来重命名已记录的历史参数——因为MLflow的Run元数据设计为**不可变（immutable）**的，一旦参数被记录到Run中，就无法通过官方途径直接修改或重命名。

不过可以通过两种间接方式实现类似效果：

• 查询时映射：在自己的数据分析或展示代码中，手动将old_param_name的查询结果映射为new_param_name，比如读取Run数据后做字段替换，不改动原始存储。
• 复制并更新Run：通过MLflow API读取历史Run的所有数据，创建新的Run并使用新参数名记录，同时标记旧Run为废弃。但这种方式会生成重复的Run记录，适合对历史数据需要严格规范的场景，但会增加数据量。

问题2：若日志存在数据库，能否直接修改参数的列名？ #

首先纠正一个误解：MLflow的参数不是以"列"的形式存储的，而是存在params表中，每条参数是一行数据，其中key字段存储参数名，value字段存储参数值。所以你需要修改的是params表中key字段的值，而非列名。

直接修改数据库是可行的，但不推荐：

1. 操作步骤：先停止MLflow服务，备份数据库，然后执行SQL更新语句（以PostgreSQL为例）：

UPDATE params SET key = 'new_param_name' WHERE key = 'old_param_name';

完成后重启MLflow服务。
2. 风险：MLflow的元数据模型依赖固定的表结构和数据逻辑，直接修改底层数据可能导致UI显示异常、后续API查询出错，甚至数据不一致。官方明确不建议直接修改MLflow的存储数据库。

更稳妥的方案 #

同时修改代码中的参数名（改为mlflow.log_param("new_param_name", new_variable_name)），并在查询历史数据时做字段映射，既不破坏原始数据，也能统一新老数据的参数名显示。

内容的提问来源于stack exchange，提问作者DataJanitor