自助数据集

使用场景

凡通过一条SQL能获取到数据的地方都可以使用，可以是单表的操作也可以是多表联合查询，如果一条SQL无法查询所需要的数据，那么可以通过脚本数据集完成。

需求描述

我有一份系统操作日志表gc_log，里面记录的信息为：谁在什么时间操作了什么模块，我想统计每个模块被使用的次数，数据格式如下，其中 module 为模块字段。

需求分析

由上面的需求可知，需要用到数据库的分组命令，编写的SQL如下:

SELECT module ,count(1) as num FROM gc_log group by module

数据集配置

找到并点击顶部【数据集管理】标签页，在右侧页面点击【新增】按钮

点击【自助数据集】选项

名称输入：模块操作统计，数据源：选择正确的数据源，SQL直接复制使用上面的即可，然后点击【解析并运行】按钮，可在【数据预览】看到数据，在右侧【输出字段】可看到查询语句中的字段信息。

点击【输出字段】右侧的【配置】按钮，填写对应字段的描述信息，点击【确定】按钮

点击页面右上角【保存】按钮即可
接下来在大屏设计器中使用上面开发好的自助数据集了😄，使用方式上没有区别

数据集参数

自助数据集的输入为SQL语句Where条件，点击页面右上角【SQL参数】右侧【配置】按钮，进行参数新增或修改，如下：直接在SQL脚本中设置参数 username，使用规范为${变量名}

select * from gc_log where username=${username}

点击【解析并运行】按钮，右上角【SQL参数】可看到SQL自动解析出来的参数，点击【SQL参数】右侧【配置】按钮，可设置参数的类型是 否 必填 默认值 ，在布局运行时，可通过 自定义数据集。可与业务相结合填充参数值，如: 根据当前登录系统的用户自动修改username参数值。

开发规范

开发规范

• 数据必须是数组类型
• 数据仅第一层有效，子节点无效

正确响应格式

[
    {
        "key1": "value1",
        "key2": "value2",
        "key3": "value3"
    },
     {
        "key1": "value1",
        "key2": "value2",
        "key3": "value3"
    },
     {
        "key1": "value1",
        "key2": "value2",
        "key3": "value3"
    }
]

错误响应格式

返回的数据非集合

{
        "key1": "value1",
        "key2": "value2",
        "key3": "value3"
}

返回的有效数据不在第一层

[
    {
        "data": [
            {
                "key1": "value1",
                "key2": "value2",
                "key3": "value3"
            },{
                "key1": "value1",
                "key2": "value2",
                "key3": "value3"
            }
        ]
    }
]