Skip to content

Commit 4ae250d

Browse files
committed
feat:更新 数据集新功能文档
1 parent 4aef68f commit 4ae250d

File tree

4 files changed

+2
-1
lines changed

4 files changed

+2
-1
lines changed
229 KB
Loading
855 KB
Loading

docs/user_manual/dashboard_basicfunctions.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -144,6 +144,7 @@
144144

145145
![仪表板_过滤组件](../img/dashboard_generation/2.0查询组件样式.png){ width="900px" }
146146

147+
147148
## 6 外部参数设置
148149

149150
!!! Abstract ""

docs/user_manual/dataset_design.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
## 1 数据集预览!!! Abstract "" 点击左侧数据表,右侧默认展示预览数据。切换 Tab 页,可切换至结构预览、行权限、列权限(行列权限为 X-Pack 功能)。![数据集界面](../../img/dataset_configuration/数据集界面.png){ width="900px" } ## 2 数据集编辑!!! Abstract "" 点击右上角【编辑】按钮。进入数据编辑界面。切换到【批量管理】可对数据集字段进行批量操作。![数据集编辑界面](../../img/dataset_configuration/数据集编辑界面.png){ width="900px" }## 3 字段管理### 3.1 字段重命名!!! Abstract "" 如下图所示,切换到【批量管理】,可修改字段名。![数据集字段重命名](../../img/dataset_configuration/数据集字段重命名.png){ width="900px" }### 3.2 字段选中!!! Abstract "" 字段显示支持全选/全不选,也可单独勾选。![数据集字段选中](../../img/dataset_configuration/数据集字段选中.png){ width="900px" }### 3.3 更换字段类型!!! Abstract "" 如下图所示,支持更换字段类型。可全选后统一进行修改。![数据集字段更改类型](../../img/dataset_configuration/数据集字段更改类型.png){ width="900px" }### 3.4 日期字段解析!!! Abstract "" 示例:数据库中以 2000/01/01 文本存储的数据,由于格式差异性,日期类过滤组件无法过滤出来这些数据; 可将该文本字段改为时间类型,并选择 Y/m/d 格式(具体格式看数据源),则日期类过滤组件可以过滤出来这些数据。 ![字段时间解析](../../img/dataset_configuration/字段时间解析.png){ width="900px" }### 3.5 URL 字段使用!!! Abstract "" 数据集字段类型支持“URL”类型。URL 字段数据在明细表中会自动展示为图片。![字段时间解析](../../img/dataset_configuration/支持图片url.png){ width="900px" }![更新1](../../newimg/1.7%20明细表支持显示图片2.png){ width="900px" }!!! Abstract "" 图片展示高度根据所设置单元格行高自适应。鼠标悬浮在单元格上,会出现图片原始链接。鼠标点击单元格图片,图片会放大展示。![更新1](../../newimg/1.7%20明细表支持显示图片3.png){ width="900px" }![更新1](../../newimg/1.7%20明细表支持显示图片4.png){ width="900px" }### 3.6 更换指标维度!!! Abstract "" 如下图所示,支持将字段转换为维度或指标。![切换维度](../../img/dataset_configuration/切换维度.png){ width="900px" }### 3.7 新建计算字段!!! Abstract "" 点击【新建计算字段】按钮,弹出新建计算字段页面,在此页面输入字段名,字段表达式,通过引用函数,生成新的数据集字段。![新建计算字段](../../img/dataset_configuration/新建计算字段.png){ width="900px" } !!! Abstract "" - 【序号 1】在此输入新建字段的名称; - 【序号 2】字段表达式由引用的字段和函数组成,也可手动添加四则运算符号; - 【序号 3】选择新建字段的数据类型,包括维度或指标; - 【序号 4】根据引用的字段及函数计算结果,调整新建字段的字段类型; - 【序号 5】引用字段栏,点击数据集原有的字段,字段表达式栏引用到对应的字段; - 【序号 6】函数栏,使用的函数支持对应数据集的数据库函数。![新建计算字段设计](../../img/dataset_configuration/新建计算字段设计.png){ width="900px" }!!! Abstract "" **请注意:** - 字段表达式不仅支持简单的加减乘除,还支持所对应的数据库函数。比如:数据源为 MySQL 数据库(或者 Excel 数据源),那么字段表达式中可输入所有 MySQL 数据库的函数,包括 IF、CASE WHEN 等用法。如果是关联数据集,对应使用的是 Calcite 的函数。 - 在图表中支持聚合作用。 - 已增加的计算字段支持二次计算。 - 桌面版使用的是 H2 数据库,需要使用 H2 的数据库函数!!! Abstract "" 在计算字段编辑页面新增校验按钮,用户可在保存前对计算字段的语法有效性进行校验,确保配置正确。![更新1](../../newimg/计算字段编辑页面支持语法校验功能1.png){ width="900px" }![更新1](../../newimg/计算字段编辑页面支持语法校验功能2.png){ width="900px" }### 3.8 字段分组功能!!! Abstract "" 【分组字段】功能支持用户通过可视化方式对字段值进行分类,无需编写 SQL 语法或使用函数,即可完成数据分组。例如,可将“广东省”归入“华南”区域,实现灵活的数据分类与分析。![更新1](../../newimg/新增数据集分组字段功能1.png){ width="900px" }!!! Abstract "" 【新建分组字段】设置: - 设置字段信息:输入新建分组字段名称(如“区域”)。选择需要分组的字段(如“province”)。 - 配置分组规则:添加分组类别(如“华北”“华南”),并将相应字段值拖入或选择归属类别。可添加默认“其他”类别,存放未分组的值。 创建分组字段后,可直接在数据预览界面查看分组结果,分组字段会新增至维度列表中。![更新1](../../newimg/新增数据集分组字段功能2.png){ width="900px" }### 3.9 复制字段!!! Abstract "" 支持对字段进行【复制】操作,复制后的字段相当于新建一个计算字段,复制后的字段,字段名:原字段名_Copy。 **注意:** 仅数据集字段管理的字段支持复制。![字段复制](../../img/dataset_configuration/字段复制.png){ width="900px" }### 3.10 删除字段!!! Abstract "" 支持对字段进行【删除】操作。 ![字段删除](../../img/dataset_configuration/字段删除.png){ width="900px" }## 4 数据关联!!! Abstract "" **注意:如果是跨数据库关联,对应的自定义 SQL 需要使用的是标准 SQL 语法。**### 4.1 左连接!!! Abstract "" 如下图,在关联数据集设置页面,选择左连接,即 LEFT JOIN,连接取左表所有数据记录,当关联字段中匹配到右表的字段,则检索出右表的数据记录,否则以 null 显示。 ![左连接](../../img/dataset_configuration/左连接.png){ width="900px" }### 4.2 右连接!!! Abstract "" 如下图,在关联数据集设置页面,选择右连接,即 RIGHT JOIN,连接取右表所有数据记录,当关联字段中匹配到左表的字段,则检索出左表的数据记录,否则以 null 显示。![右连接](../../img/dataset_configuration/右连接.png){ width="900px" } ### 4.3 内连接!!! Abstract "" 如下图,在关联数据集设置页面,选择内连接,即 INNER JOIN,当左表和右表的数据记录存在匹配时,数据记录才被检索出来。![内连接](../../img/dataset_configuration/内连接.png){ width="900px" }### 4.4 全连接!!! Abstract "" 数据集表关联时支持设置全连接。 - MySQL,API,Excel 数据源目前不支持全连接; - 由于交互问题,校验放在后端执行,若不支持全连接,会返回提示。![更新1](../../newimg/2.1 数据集表关联时支持设置全连接.png){ width="900px" }
1+
## 1 数据集预览!!! Abstract "" 点击左侧数据表,右侧默认展示预览数据。切换 Tab 页,可切换至结构预览、行权限、列权限(行列权限为 X-Pack 功能)。![数据集界面](../../img/dataset_configuration/数据集界面.png){ width="900px" } ## 2 数据集编辑!!! Abstract "" 点击右上角【编辑】按钮。进入数据编辑界面。切换到【批量管理】可对数据集字段进行批量操作。![数据集编辑界面](../../img/dataset_configuration/数据集编辑界面.png){ width="900px" }!!! Abstract "" 勾选排序后,导出数据集,对数据进行升序排列。![数据集排序](../../img/quick_start/数据集排序.png){ width="900px" }![数据集排序2](../../img/quick_start/数据集排序2.png){ width="900px" }## 3 字段管理### 3.1 字段重命名!!! Abstract "" 如下图所示,切换到【批量管理】,可修改字段名。![数据集字段重命名](../../img/dataset_configuration/数据集字段重命名.png){ width="900px" }### 3.2 字段选中!!! Abstract "" 字段显示支持全选/全不选,也可单独勾选。![数据集字段选中](../../img/dataset_configuration/数据集字段选中.png){ width="900px" }### 3.3 更换字段类型!!! Abstract "" 如下图所示,支持更换字段类型。可全选后统一进行修改。![数据集字段更改类型](../../img/dataset_configuration/数据集字段更改类型.png){ width="900px" }### 3.4 日期字段解析!!! Abstract "" 示例:数据库中以 2000/01/01 文本存储的数据,由于格式差异性,日期类过滤组件无法过滤出来这些数据; 可将该文本字段改为时间类型,并选择 Y/m/d 格式(具体格式看数据源),则日期类过滤组件可以过滤出来这些数据。 ![字段时间解析](../../img/dataset_configuration/字段时间解析.png){ width="900px" }### 3.5 URL 字段使用!!! Abstract "" 数据集字段类型支持“URL”类型。URL 字段数据在明细表中会自动展示为图片。![字段时间解析](../../img/dataset_configuration/支持图片url.png){ width="900px" }![更新1](../../newimg/1.7%20明细表支持显示图片2.png){ width="900px" }!!! Abstract "" 图片展示高度根据所设置单元格行高自适应。鼠标悬浮在单元格上,会出现图片原始链接。鼠标点击单元格图片,图片会放大展示。![更新1](../../newimg/1.7%20明细表支持显示图片3.png){ width="900px" }![更新1](../../newimg/1.7%20明细表支持显示图片4.png){ width="900px" }### 3.6 更换指标维度!!! Abstract "" 如下图所示,支持将字段转换为维度或指标。![切换维度](../../img/dataset_configuration/切换维度.png){ width="900px" }### 3.7 新建计算字段!!! Abstract "" 点击【新建计算字段】按钮,弹出新建计算字段页面,在此页面输入字段名,字段表达式,通过引用函数,生成新的数据集字段。![新建计算字段](../../img/dataset_configuration/新建计算字段.png){ width="900px" } !!! Abstract "" - 【序号 1】在此输入新建字段的名称; - 【序号 2】字段表达式由引用的字段和函数组成,也可手动添加四则运算符号; - 【序号 3】选择新建字段的数据类型,包括维度或指标; - 【序号 4】根据引用的字段及函数计算结果,调整新建字段的字段类型; - 【序号 5】引用字段栏,点击数据集原有的字段,字段表达式栏引用到对应的字段; - 【序号 6】函数栏,使用的函数支持对应数据集的数据库函数。![新建计算字段设计](../../img/dataset_configuration/新建计算字段设计.png){ width="900px" }!!! Abstract "" **请注意:** - 字段表达式不仅支持简单的加减乘除,还支持所对应的数据库函数。比如:数据源为 MySQL 数据库(或者 Excel 数据源),那么字段表达式中可输入所有 MySQL 数据库的函数,包括 IF、CASE WHEN 等用法。如果是关联数据集,对应使用的是 Calcite 的函数。 - 在图表中支持聚合作用。 - 已增加的计算字段支持二次计算。 - 桌面版使用的是 H2 数据库,需要使用 H2 的数据库函数!!! Abstract "" 在计算字段编辑页面新增校验按钮,用户可在保存前对计算字段的语法有效性进行校验,确保配置正确。![更新1](../../newimg/计算字段编辑页面支持语法校验功能1.png){ width="900px" }![更新1](../../newimg/计算字段编辑页面支持语法校验功能2.png){ width="900px" }### 3.8 字段分组功能!!! Abstract "" 【分组字段】功能支持用户通过可视化方式对字段值进行分类,无需编写 SQL 语法或使用函数,即可完成数据分组。例如,可将“广东省”归入“华南”区域,实现灵活的数据分类与分析。![更新1](../../newimg/新增数据集分组字段功能1.png){ width="900px" }!!! Abstract "" 【新建分组字段】设置: - 设置字段信息:输入新建分组字段名称(如“区域”)。选择需要分组的字段(如“province”)。 - 配置分组规则:添加分组类别(如“华北”“华南”),并将相应字段值拖入或选择归属类别。可添加默认“其他”类别,存放未分组的值。 创建分组字段后,可直接在数据预览界面查看分组结果,分组字段会新增至维度列表中。![更新1](../../newimg/新增数据集分组字段功能2.png){ width="900px" }### 3.9 复制字段!!! Abstract "" 支持对字段进行【复制】操作,复制后的字段相当于新建一个计算字段,复制后的字段,字段名:原字段名_Copy。 **注意:** 仅数据集字段管理的字段支持复制。![字段复制](../../img/dataset_configuration/字段复制.png){ width="900px" }### 3.10 删除字段!!! Abstract "" 支持对字段进行【删除】操作。 ![字段删除](../../img/dataset_configuration/字段删除.png){ width="900px" }## 4 数据关联!!! Abstract "" **注意:如果是跨数据库关联,对应的自定义 SQL 需要使用的是标准 SQL 语法。**### 4.1 左连接!!! Abstract "" 如下图,在关联数据集设置页面,选择左连接,即 LEFT JOIN,连接取左表所有数据记录,当关联字段中匹配到右表的字段,则检索出右表的数据记录,否则以 null 显示。 ![左连接](../../img/dataset_configuration/左连接.png){ width="900px" }### 4.2 右连接!!! Abstract "" 如下图,在关联数据集设置页面,选择右连接,即 RIGHT JOIN,连接取右表所有数据记录,当关联字段中匹配到左表的字段,则检索出左表的数据记录,否则以 null 显示。![右连接](../../img/dataset_configuration/右连接.png){ width="900px" } ### 4.3 内连接!!! Abstract "" 如下图,在关联数据集设置页面,选择内连接,即 INNER JOIN,当左表和右表的数据记录存在匹配时,数据记录才被检索出来。![内连接](../../img/dataset_configuration/内连接.png){ width="900px" }### 4.4 全连接!!! Abstract "" 数据集表关联时支持设置全连接。 - MySQL,API,Excel 数据源目前不支持全连接; - 由于交互问题,校验放在后端执行,若不支持全连接,会返回提示。![更新1](../../newimg/2.1 数据集表关联时支持设置全连接.png){ width="900px" }

0 commit comments

Comments
 (0)