# SQL 编辑器
# SQL 数据资源
SQL 数据资源通过 SQL 语句查询数据库的方式获取数据资源。
# SQL 查询语句配置
1、数据源: 选择数据源。
2、工具栏: 提供 SQL 相关功能。
1、执行
:对 SQL 编辑框内的 sql 语句进行执行。2、参数列表
:对 sql 语句进行宏变量参数列表的展示,sql 变量使用参考宏变量。3、清空
:对 SQL 编辑框内的 sql 语句进行清空处理。4、美化
:对 SQL 编辑框内的 sql 语句进行格式化处理。5、上传
:仅支持格式为.sql
的 文件导入到 SQL 编辑框内,导入的 sql 语句默认添加到原 sql 语句的末尾处。6、切换主题
:对 SQL 编辑框内的主题进行切换,支持浅色
、暗色
两种模式。7、保存
:对 sql 资源进行保存,仅在 sql 执行成功后才可保存,一但 sql 语句变动,需要重新执行后方可再次保存。8、删除
:对 sql 资源进行删除,资源权限为所有者
、可管理
有删除权限,资源删除后进入到回收站。
3、数据源连接: 连接数据源。
数据源连接功能请参考数据源连接。
4、数据表: 加载数据源连接的数据表。
数据表功能请参考数据表。
5、SQL 编辑: 编辑 sql 语句。
sql 语句支持参数查询,sql 变量使用参考宏变量。
拖拽表到SQL编辑器
:需要保证当前表的数据源与 sql 资源的数据源一致,方可拖拽成功,如果 SQL 编辑框为空,拖拽表到 SQL 编辑器,默认显示是一条 sql 条查询语句,如果 SQL 编辑框已有 sql 语句,拖拽表到 SQL 编辑框,则是添加表名。
# 查询参数
# SQL 数据资源中参数查询的使用
sql 参数查询具体支持方式请参考宏变量。
# SQL 数据资源中 #{}
的使用
使用方式: 在
SQL
的WHERE
语句中添加#{字段名}
, 如SELECT * FROM CHAOSHI WHERE 子类别 = #{type}
。查询参数: 占位符中的字段名提取为查询参数, 可设置默认值。
替换逻辑
- 当参数接收到值非空时替换为
字段名=值
如:SELECT * FROM CHAOSHI WHERE 子类别 = 'a'
- 当参数接收到值为空字符串或为
null
或未接收到参数时- 默认值非空替换为:
SELECT * FROM CHAOSHI WHERE 子类别 = '默认值'
- 默认值为空字符串替换为:
SELECT * FROM CHAOSHI WHERE 子类别 = ''
- 默认值为
null
将舍弃查询条件, 替换为:SELECT * FROM CHAOSHI
- 默认值非空替换为:
提示:
注: 无法实现默认查询全部通过传递指定参数查询参数值为空字符串的数据
示例
序号 1: 配置数据资源,创建一个有
#{}
的数据资源。添加数据资源,给大屏组件提供数据来源。
SELECT * FROM CHAOSHI WHERE 子类别 = #{type}
- 序号 2: 创建大屏,配置组件。
新建大屏,添加饼图和按钮组。
- 序号 3: 配置组件数据资源。
给饼图、按钮组配置超市数据资源。
- 序号 4: 配置组件数据交互。
变量池新建字段 商品类型
goods_type
, 该字段用于后续变量绑定。按钮组配置切换按钮组事件,选择字段
子类别
, 绑定到变量goods_type
。饼图配置数据响应,选择变量
goods_type
, 绑定到 查询参数type
。- 序号 5: 预览,查看效果。
单击切换按钮组,将把该按钮中数据的
子类别
,传递给变量goods_type
。饼图将接收变量goods_type
中传递的数据,刷新该图表数据,实现组件交互效果。切换到美术时查询语句为:
SELECT * FROM CHAOSHI WHERE 子类别 = '美术'