# 可视化模块

# 一、可视化模块概述

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

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

可视化模块仅适用于 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	-	-	-	-	-	-	-	-	-	✅	✅
交叉表	✅	-	-	-	-	-	-	-	-	-	✅	✅