对象映射¶

对象映射是视图变量的配套优化功能，仅针对基础对象、资源目录等对象类数据，可将原始字段映射为更具可读性的展示名称。映射不改变原始数据与查询逻辑，仅优化前端可视化展示效果。

核心作用¶

• 提升可读性：将无意义的原始字段（如 container_id、host_id）映射为业务可识别名称；

• 统一展示：视图变量与图表可同步使用映射后名称，保障仪表板展示一致性；

• 不影响查询：仅改变前端显示，查询时仍传递原始字段值，无需修改已有查询语句。

配置前提¶

1. 仅支持对象类数据（基础对象、资源目录），不支持指标、日志、事件等其他数据；
2. 使用前需先创建基于对象类字段的视图变量；
3. 同一对象分类的查询字段不支持重复映射，已映射字段会从下拉列表中隐藏。

开始配置¶

1. 选择数据来源（基础对象 / 资源目录）；
2. 选择对象分类；
3. 配置原始查询字段与目标映射字段；
4. 保存。

例如：将 container_id 映射显示为 container_name。

那么在仪表板中，视图变量值将以 container_name (container_id) 的形式显示，但是在查询时，仍然会传递 container_id 的值。此外，如果在图表设置中启用了字段映射功能，图表的图例将显示映射后的字段值。

管理配置¶

• 编辑：修改原始字段与映射字段的对应关系，保存后实时生效。
• 删除：移除映射关系，前端恢复显示原始字段。

场景示例¶

对象映射可应用于两个场景：

视图变量的下拉显示

图表的展示

应用于视图变量¶

变量下拉选项以 “映射字段 (原始字段)” 形式展示，选择后查询仍使用原始字段值。

举例说明：

1. 在视图变量中添加了 container_id 变量；

2. 在对象映射中设置 container_id 映射为 container_name；

3. 此时在视图中变量显示为：container_name(container_id)。

应用于图表¶

在图表高级设置中开启字段映射字段映射功能，图表图例与数据将展示映射后名称。

举例说明：

1. 在对象映射中设置 host 映射为 name；
2. 在图表 > 高级设置中开启字段映射；
3. 最终在图表中显示格式为 name(host)。