# 可视化模块

# 一、可视化模块概述

可视化模块是为提供更丰富的数据展示形式,和更直观的数据分析能力而诞生的功能模块。

您可以通过拖拽字段的方式进行灵活高效的探索式分析;并能够基于实际场景的需要,对于图表类型,图表样式进行各种精细化的配置,实现高度自定义的图表构建。

可视化模块仅适用于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 双轴图

当您希望将量级差异较大,或数字格式不同的两个指标(比如数值和百分比)放在同一张图表中进行展示时,您可以添加次轴,将不同的指标设置在不同的纵轴上,以达到合理的展示效果;您也可以使用组合图达到同样效果,甚至将不同指标设置为不同的图形(比如折线或柱状),来更好的区分它们