1.1 版本

注：JDK 版本：JDK 1.8 且小版本需在 JDK8u102 以上。

1.2 应用场景

FineReport 提供了简单方便的连接各方数据的能力，要求客户有基础的 SQL 使用知识，通常的使用场景是客户从其他地方获取测试有效的 SQL 语句粘贴到 FineReport ，比较麻烦。该插件提供了简化 SQL 输入，无缝对接 SQL 可视化编辑工具的能力。

1.3 功能介绍

• 支持语法提示、自动补全(支持字段名)和代码美化。

• 优化在 SQL 中加入帆软公式支持。

• 支持可视化的 SQL Builder。(只支持 mysql mssql oracle 等常用数据库)

• 可视化生成参数过滤语句

2.1 插件安装

点击下载插件：高级数据库查询

设计器插件安装方法参照 设计器插件管理

服务器安装插件方法参照 服务器插件管理

2.2 操作方法

在插件商店安装「高级数据库查询」后，新建「数据库查询」类型的数据集，数据库查询界面会默认替换为高级数据库查询。

在菜单栏「服务器 -> 高级数据库」中取消勾选 使用高级sql编辑器直接替代fr自带编辑器 则可还原为FR默认的编辑器。

2.2.1 定义数据连接按钮

可直接点击点击下图的第一步骤按钮，进行添加定义数据连接。如下图所示：

2.2.2 查看数据连接下的数据表

①为数据源，②为数据连接刷新按钮，③数据连接下的数据表。

2.2.3 自动补全介绍

• 点击①所在的按钮，会跳出自动补全设置

• 其中③设置自动补全快捷键

•  ④，⑤添加高亮函数名和高亮关键字

• ⑥，⑦可自定义添加自动补全函数名，自动补全关键字。

• ②为是否开启自动补全

2.2.4 可视化 SQL 编辑器

点击①可进入可视化编辑器，如下图：

②为数据表，双击数据表可将此数据表的字段添加到⑤中。

点击⑤中的勾选，可选用此字段进行查询。

点击⑥可对⑤所选的字段进行重新命名，汇总，以及排序等。

③为设计界面，可直接点击进行选择操作。

④为语法选择界面，可写 SQL 语句进行操作，以及查看③操作过后的 SQL语句 。

2.2.5 参数注入

先书写参数语句如①，然后再点击②刷新显示注入的参数。可在③查看参数是否添加成功，以及参数添加默认值。

可视化插入参数注入

通过在②输入[列名],[参数名]并选择[控件类型]和是否[参数为空选择全部]来生成参数注入语句,生成规则如下(会当前语句末尾是否有where或and来判断是否生成and)

单选场景：

简单参数筛选 列名='${参数名}'

参数为空选择全部 ${if(len(参数名) == 0,"","and 列名 = '" + area + "'")}

多选场景：

简单参数筛选 列名 in ('${replace(参数名,",","','")}')

参数为空选择全部 ${if(len(参数名) == 0,"","and 列名 in ('" + replace(参数名,",","','") + "')")}

参数注入工具栏②默认显示,可以通过点击①来显示或隐藏

2.2.6 插入函数

点击①，进入②，使用 FR 的公式进行计算，点击确定后会将公式计算结果返回给你数据集直接使用，如③。

2.2.7 其他按钮介绍

①为SQL美化，②为使用分页 SQL 编辑，③为查看执行SQL，④为 SQL 预览按钮，⑤为高级数据库查询最大化。

报表美化点击后 SQL 如下图：

3.1 自动补全

3.2 参数注入和插入函数

4.1 操作问题

1）双击表名会显示字段名然后自动补全中可以使用字段名。

2）当自动补全不出现的时候按下 ctrl + space。

3）远程设计时，非root用户看不到所有的数据连接下的所有表，需要超管打开设计器的服务器-高级数据库查询-然后手动分配权限才能看到