# 可视化模块
# 一、可视化模块概述
可视化模块是为提供更丰富的数据展示形式，和更直观的数据分析能力而诞生的功能模块。
您可以通过拖拽字段的方式进行灵活高效的探索式分析；并能够基于实际场景的需要，对于图表类型，图表样式进行各种精细化的配置，实现高度自定义的图表构建。
可视化模块仅适用于SQL报表。
# 二、概念及流程简介
# 2.1 基本概念
报表构成：
一份报表由「结果数据」，和「可视化图表」两部分构成。如有添加图表，则保存/更新报表时将同时保存/更新这两部分的配置。
对于SQL查询结果，目前仅支持添加一张图表，且允许在不添加可视化图表的状态下保存为报表。
可视化数据来源：可视化图表的数据源为SQL查询结果中前1000条数据。进入可视化配置页时将按查询条件重新计算数据，可能存在与SQL页结果不完全一致的情况
# 2.2 操作流程
创建SQL报表基本流程如下：
1.新建查询 → 2. 添加图表 → 3. 配置图表 → 4. 保存图表配置 → 5. 保存报表
报表最多仅支持添加一张图表，且允许以未添加图表的状态保存。报表中可进行添加图表（未添加时），修改数据源，修改图表配置，移除图表等操作
# 2.2.1 新建查询
输入SQL语句并计算
# 2.2.2 添加图表
当SQL查询有结果，且未添加图表时，点击右上角【添加图表】可进入可视化配置页。查询无结果数据时将无法进入配置页。
# 2.2.3 配置图表
在可视化页面操作，包括图表数据，图表样式，图表类型三部分的配置，具体的操作方式会在第三章「可视化配置」中详细介绍
# 初始配置状态
未添加图表时进入可视化页面，默认展示为初始化状态：取结果字段中第一个数值类型字段填入指标项，第一个非数值类型字段填入分组项，展示为折线图。
查询结果字段数不足时取上限数量填入，缺少数值类型的字段将导致图表展示异常，异常状态下您可以调整配置使图表正常展示
# 2.2.4 保存图表配置
图表配置完毕后点击右上角【保存】按钮，可将图表配置添加至SQL结果页，该页面下可切换查看结果数据或图表：
# 2.2.5 保存报表
已添加图表状态下点击保存报表，将连同图表一起保存，如变更数据源导致图表展示为异常状态，则保存报表时将自动移除图表，仅保存数据结果表
- 如添加图表后未进行【保存报表】操作，离开报表页面时图表配置将被清除
# 三、可视化配置
# 3.1 配置页结构
# 1）图表配置区
下设两个标签页，【图表数据】可配置图表中需要展示的字段，【图表样式】进行样式细节的定义
# 2）图表类型选择
进行图表类型的切换，支持的图表类型有：折线图、柱图、堆叠柱图、组合图、环图、一维表、交叉表
# 3）图表展示区
展示图表最终呈现的效果，随配置区的操作即时响应
# 4）基础功能区
返回SQL页面，及保存/移除图表
# 3.2 图表构建
以拖拽方式将右侧字段添加到数据配置区域构建图表，也支持拖拽删除字段
当添加的字段满足构建图表的基本条件时，图表展示区将会进行展示。对图表做任何配置，展示区都将即时刷新图表效果
未添加图表时进入可视化页面，默认展示为初始化状态：取结果字段中第一个数值类型字段填入指标项，第一个非数值类型字段填入分组项，以折线图展示。
# 3.2.1 字段列表
数据配置标签页右侧为SQL查询结果中的所有字段，您可以通过字段前的标识进行字段类型的区分：
字段支持搜索和设置显示名，点击右上角图标可快速查看SQL结果数据
# 3.2.2 数据配置
图表数据配置项划分成【分组】，【子分组】，【指标】三个区域。部分图表或场景下不支持配置子分组。
- 【分组】
通常由非数值型字段担任，用来对数据进行分类展示。允许拖入多个字段，多个字段在图表中将合并成一个分组项。
- 【子分组】
通常由非数值类字段担任，用来进一步下钻细分类别，允许拖入多个字段，多个字段将合并展示。
组合图，簇状柱图（多指标场景），环图，一维表不支持设置子分组。
- 【指标】
通常由数值型字段担任，展示指标值。允许拖入多个字段。
【分组】和【子分组】允许填入数值型字段，此时将把该字段的值作为分组；【指标】也允许填入数值以外的字段，此时将默认以“计数”方式对该字段做聚合处理。
以垂直坐标系图表（单指标场景）为例，【分组】与【子分组】的区别可以简单理解为，分组代表X轴节点，而子分组代表图例，如下图：
# 3.2.3 双轴配置
支持双轴的图表类型：折线图，柱图（簇状），堆叠柱图，组合图
点击【Y轴/指标】右侧的“+”可以增加次Y轴。将字段拖入次轴可实现双轴图效果。如需调整指标所属轴，您可以通过调整字段位置，或在【图表样式】中设置指标的从属轴来实现
当次轴被删除，或切换至不支持双轴的图表时，次轴上的指标将被自动并入主轴。*目标图表允许的指标数量存在上限时，部分指标将被丢弃
# 3.3 数据字段配置
# 3.3.1 排序
- 【分组】字段
对分组项自身进行排序，支持多分组嵌套排序
- 【指标】字段
按指标值对全部分组进行排序。最多只允许一个指标有排序，对某指标做排序时将自动清空其他指标的排序
对【分组】做排序时，将自动清空【指标】的排序，反之亦然；切换图表类型将清空之前所有排序
# 3.3.2 聚合计算
- 【分组】/【子分组】字段
支持计数（默认），去重计数
- 【指标】字段
支持合计（默认），均值，计数，去重计数，最大值，最小值
非数值类型字段被添加至【指标】时，默认以计数方式聚合计算
# 3.3.3 数据展示格式
默认格式为开启千分位的两位小数，可自定义小数位数，百分数位数，数量单位，是否开启千分位
小数点后最多允许保留10位，小数末尾为零则不展示
# 3.3.4 图形标记
仅支持组合图，可自定义主/次轴上指标的图形样式：折线or柱状
# 3.4 图表样式配置
不同图表类型支持的配置项有差异，详细如下：
| X轴分组数/子分组数 | X轴显示轴标签 | X轴轴标签间隔 | X轴标签文字 | Y轴/次Y轴显示轴标签 | Y轴/次Y轴区间 | 指标选择 | 指标从属轴 | 显示数字标签 | 显示最值 | 显示色阶 | 显示星期 | |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 折线图 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | - | ✅ |
| 柱图（簇状） | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | - | ✅ |
| 堆叠柱图 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | - | ✅ |
| 环图 | ✅ | - | - | - | - | - | - | - | ✅ *注1 | - | - | ✅ |
| 组合图 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | - | ✅ |
| 一维表 | ✅ *注2 | - | - | - | - | - | - | - | - | - | ✅ | ✅ |
| 交叉表 | ✅ | - | - | - | - | - | - | - | - | - | ✅ | ✅ |
注1：环图数字包含分组项名称和百分比
注2：一维表展示为“行数”，默认1000，上限1000
- X轴分组数/子分组数
X轴分组数控制分组项展示数量，即X轴上的节点数，默认50，上限1000；子分组数控制子分组项展示数量，默认5，上限50
环图默认5+1（1为“其他”），上限为10+1；一维表展示为“行数”，默认1000，上限1000
- X轴轴标签、轴标签间隔、标签文字
控制X轴上分组项标签是否展示，展示间隔数，以及标签文字的截取规则
- Y轴/次Y轴显示轴标签、轴区间
控制Y轴/次Y轴标签是否展示，以及轴区间范围
- 指标选择、指标从属轴、显示数字标签
可对每个指标分别设置从属轴，以及是否展示数字标签，不同指标的设置可在图表上同时展示
- 显示最值
可对单个指标的最大值、最小值进行突出展示
- 显示色阶
将每个指标的值区间划分成12个色阶，数值越大，颜色越深
- 显示星期
仅对日期格式数据生效，在数据后标记星期
# 3.5 图表类型切换
V3.5版本提供折线图、柱图、堆叠柱图、环图、组合图、一维表、交叉表7种图表类型，通过图表类型切换按钮进行切换
切换图表类型时，将尽可能保留上一个图表类型下的图表字段配置，坐标轴样式，和指标样式，如切换前后图表类型支持的配置有区别，系统将自动调整，可能造成数据配置上的变更或部分字段被移除。
比如有子分组的柱图切换至组合图，由于组合图不支持子分组，原子分组的字段将被自动转移到分组中
# 四、更新图表
已被添加至SQL页面的图表允许被更新，有以下两种情况：
1）数据源不变，重新配置图表
可通过图表右上角的【配置】，重新进入可视化页，保存操作后新配置将覆盖原配置
2）变更数据源
修改SQL语句重新计算（包括查看历史查询），将会自动按照新数据源刷新图表，如新旧数据源中有相同的图表字段，则图表将尽量保留字段配置，否则图表将展示为异常状态，您可以【移除】图表，或再次进入可视化页面重新配置
# 五、移除图表
两种方式：
1）在SQL结果页，在图表视图下方可进行可视化图表的编辑和移除操作
2）进入可视化页面，点击页面右上角的【移除】
- 对于已保存的报表，移除图表操作将会直接生效，不需点击【更新报表】
# 六、看板展示
已添加图表的SQL报表，在看板中将默认以图表形式展示，可在看板上临时切换至明细数据，或在看板报表设置中设置为明细数据
# 七、探索模块
探索模块中可基于报表数据进行可视化探索，功能与可视化页面中完全一致
# 八、最佳实践
# 8.1 双轴图
当您希望将量级差异较大，或数字格式不同的两个指标（比如数值和百分比）放在同一张图表中进行展示时，您可以添加次轴，将不同的指标设置在不同的纵轴上，以达到合理的展示效果；您也可以使用组合图达到同样效果，甚至将不同指标设置为不同的图形（比如折线或柱状），来更好的区分它们