什么是数据值映射

有时数据库中存储的数据可能是对用户不友好的代号值，数据值映射允许您配置一对一的映射，将这些不友好的值映射为可以展示给用户的可阅读性强的值。

比如数据库库中里存储的数据是：

但是我想展示的数据是（即：1代表 Android，2代表 IOS）：

创建数据值映射

空间的管理员可以从左侧边栏的管理中心进入数据值映射管理页面，这里可以看到每个数据映射值有几个 SQL 模型在使用。

顶部可以进行搜索和新建。

新建时需要指定数据值映射的名称。

每一组数据值映射由「原始值」和「映射值」组成，其中：

• 原始值对应的是数据库中不友好的代号等需要被映射的值
• 映射值对应的就是最终需要显示给用户的值

这里可以手动输入或者导入本地的 Excel 文件：

也可以使用数据模型来绑定数据值映射的本身数据：

当然，新建的数据值映射也可以再次编辑进行更改，或者删除。

SQL 模型中使用数据值映射

通过配置数据值映射就可以做到将数据中需要映射的值进行转换。在 SQL 模型中，对于需要数据值映射的字段，可以在编辑字段模型时进行选择，如下绑定某字段的数据值映射之后，在具体的图表上展示的数据就将是映射之后的值。

图表中禁用数据值映射

如果有这样的需求：在一个图表中，既需要映射前的数据做展示，也需要映射后的字段做展示，或者想套用一个已经配置好了映射的 SQL 模型，但是展示的时候就是希望只展示原始值，这时候就可以使用禁用数据值映射功能。

禁用数据值映射会在具体的图表的「控制面板」中配置，例如表格的控制面板的数据列配置最大化后如下：

这样就可以同时展示 type 字段映射前和映射后的值了。

数据值映射的下钻和联动兼容

由于使用数据值映射后，图表展示的就不再是原始的数据值了，那么下钻后向下层图表传递的下钻参数会不会受到影响呢？

答案是不会，对于使用了数据值映射的数据，Sugar BI会在下钻或联动参数中多加入对应的原始值数据，例如下图：

用户只需要在下钻参数信息中获取对应的 xxx_sugar_origin 字段即可获取重命名前的原始值。详见SQL 中关联下钻参数和SQL 中关联联动参数