finereport的 SQL函数

以你之姓@ 2021-12-17 04:35 942阅读 0赞

# #

## finereport SQL函数 ##

## 1. 公式解释 ##

有的时候希望某个单元格能够直接获取到数据库中的某个值，而不是先要定义一个数据集后，再去取数据。这时就可以用 SQL 函数，下面讲解下 SQL 函数的用法。

SQL(connectionName,sql,columnIndex,rowIndex)：返回的数据是从 connectionName 数据库中获取的 SQL 语句的表中的第 columnIndex 列第 rowIndex 行所对应的元素。

connectionName：数据库名，字符串形式，需要用引号如"FRDemo"；

sql：SQL 语句或者数据库存储过程，字符串形式，传参数、条件等可以在此拼接实现；

columnIndex：列序号，整型；

rowIndex：行序号，整型。

注：行序号可以不写，这样返回值为数据列。

## 2. 以我们提供的数据源 FRDemo 为例 ##

### 2.1 示例（就一般的只获取某个字段内容） ###

从表 STSCORE 中，我们可看到第 3 行第 3 列的值为 Alex，如下：

![20180725161348_9269.png][]

现在若要直接在报表的单元格中显示数据值：Alex，而不通过先定义一个数据集后，再去取数据的方式，这里就可以使用 sql() 公式，此时只需在单元格中输入：=sql("FRDemo","SELECT \* FROM STSCORE",3,3)即可，预览就可看到 Alex 值。

### 2.2 示例（带有参数时公式的使用） ###

带有参数形式的时候，直接在报表的单元格中获取数据值，写法如下：

=sql("FRDemo","SELECT \* FROM STSCORE where CLASSNO = 'Class1' ",3)

显示效果（班级为 Class1 的第 3 列所有值），如下：

![20180725161348_8205.png][]

若需要显示某个具体值，如：显示 Jonny 的效果（即班级为 Class1 的第 3 列第 4 行的值），写法如下：

=sql("FRDemo","SELECT \* FROM STSCORE where CLASSNO = 'Class1' ",3,4)

若参数值为变量如为报表参数或者是某个单元格，则写法如下：

=sql("FRDemo","SELECT \* FROM STSCORE where CLASSNO = '"+$class+"' ",3,4)

或

=sql("FRDemo","SELECT \* FROM STSCORE where CLASSNO = '"+A1+"' ",3,4)

如果传递的参数是获取当前单元格的值，即用 $$$ 作为参数时，字符串类型同样需要拼接单引号，如下：

=sql("FRDemo","SELECT \* FROM STSCORE where CLASSNO = '"+$$$+"' ",3,4)

注：如果参数或者单元格值有多个，那么 SQL 函数的写法如下：

=sql("FRDemo","SELECT \* FROM STSCORE where CLASSNO in ('"+$class+"') ",3,4)

注：并且 class 参数返回值的分隔符需为','，具体请查看[下拉复选框参数联动][Link 1]。

如果在 SQL 中还要用if进行判断并拼接模板参数时，如下：

=sql("FRDemo","SELECT \* FROM STSCORE where 1=1 "+if(len(p1)== 0,"","and CLASSNO = '"+p1+"'"),3,4)

以上内容就是有关 SQL 函数的介绍。

若是调用数据库存储过程取数，建议采用官方只支持查询语句 select 进行取数，其他写法（例如下面的写法）， 返回的结果不能保证，不建议使用 ：

=sql("dbname","\{call  存储过程名  (参数1,参数2,...)\}",1,1)

=sql("dbname","exec 存储过程名  参数1,参数2,...",1,1)

注：参数如果是字符串的话，参数需要用英文单引号引起来如：'参数1'。没有参数的需用?补全，例如=sql("140","\{call  SCOTT.P\_EMP (?) \}",2,2)

=================================================

# 2.finereport  select函数使用 #

## 1. 概述 ##

一般情况下，我们直接使用数据列的拖拽就能制作出想要的报表，但对于习惯编程的用户或者希望根据不同的条件控制某个单元使用哪个数据列时，我们也同样支持直接在单元格中使用来实现，这样的函数我们称为数据集函数。

以下列出所有的数据集函数及用法。

## 2. tablename.select ##

tablename.select(colname,筛选条件1&&筛选条件2&&......)

说明：选出数据集某列中符合条件的数据，返回结果是一个数组，相同数据不会合并。

其中 tablename 表示数据集名称，注意是报表数据集或者是服务器数据集名，而非数据库中的表名；

colname 表示列名，大小写不区分。

示例：

如数据集 ds1 取出内置 FRDemo 数据库中的销量表

*  在单元格中输入=ds1.select(销售员)，返回数据集ds1销售员列中的所有值。
 *  在单元格中输入=ds1.select(销售员,地区 = "华东"&&销量 > 200)，返回数据集 ds1 华东地区销售总额超过 200 的销售员。
 *  在单元格中输入=ds1.select(销售员,地区="华东"||地区="华北")，返回数据集 ds1 华东地区或华北地区的销售员。

注：筛选条件中的判断既可以使用单等号，也可以使用双等号；字符串也同时可以使用单引号或者是双引号，对结果均没有影响。

## 3. tablename.group ##

tablename.group(colname,筛选条件 1 && 筛选条件 2,升降序)

说明：选出数据集某列中符合条件的数据并分组，还可以按照该列进行升降序排列。

其中 tablename 表示数据集名称、colname 表示列名；

升降序为布尔值，true 表示升序，false 表示降序。

示例：

如数据集 ds1 取出内置 FRDemo 数据库中的销量表

在单元格中输入=ds1.group(销售员)，返回数据集 ds1 销售员列中的值，并且相邻数据若相同会进行合并。

在单元格中输入=ds1.group(销售员,true,false)或=ds1.group(销售员,,false)，返回数据集 ds1 销售员列中的值，并且其中只要相同就会进行合并，结果为降序排列，中间的参数为条件，若没有条件，可以不写或者使用 true，但是不能省略。

在单元格中输入=ds1.group(销售员,地区=="华东")，返回数据集 ds1 华东地区的销售员，并且相邻数据若相同会进行合并。

在单元格中输入=ds1.group(销售员,地区=="华东",true)，返回数据集 ds1 华东地区的销售员，并且会合并所有相同项，结果为升序排列。

## 4. tablename.select(\#0) ##

说明：返回数据集 ds1 中的行号。

示例：

如数据集 ds1 取出内置 FRDemo 数据库中的销量表

在单元格中输入=ds1.select(\#0)，数据集 ds1 中一共有 45 条数据，因此返回行号 1,2,3,......45。

## 5. tablename.value(row,col/colname) ##

说明：获取数据集 ds1 中某行某列的值。

示例：

如数据集 ds1 取出内置 FRDemo 数据库中的销量表

在单元格中输入=ds1.value(3,2)，返回数据集 ds1 中第 3 行第 2 列的值。

在单元格中输入=ds1.value(3,"销售员")，返回数据集 ds1 中第 3 行销售员列的值。

注：报表的图表标题不支持 value 函数

## 6. 实例 ##

### 6.1 实例 1：数据集函数返回的数据进行扩展 ###

直接将数据列拖拽到单元格时会自动从上到下扩展。但是使用数据集函数获得数据为一个数组，是显示在一个单元格中的，需要另外给单元格设置扩展属性，数据才会进行扩展。

### 6.2 实例 2：根据不同条件选择使用哪个字段 ###

在单元格中输入如下公式：

=if(条件,ds1.group(customerid),ds2.group(customerid))

并设置其扩展属性为从上到下。

说明条件为真，则单元格使用数据集 ds1 中的 customerid 列，否则使用 ds2 中的 customerid 列 。

### 6.3 实例 3：对数据集函数返回的数据再进行运算 ###

如公式=sum(ds1.select(销量))，返回数据集 ds1 销量列的总和。

sum 求和公式也可以换用其他如 count、max 等。

[20180725161348_9269.png]: /images/20211213/4eed65eb5b13475999a8aabcd2eeb341.png
[20180725161348_8205.png]: /images/20211213/36010b0843d04d34b78ea2dfe1ac86d7.png
[Link 1]: http://help.finereport.com/doc-view-1285.html