1.1 函数作用

数据集函数 能够从数据集中直接进行条件取数，但是有的时候用户希望某个单元格能够直接获取到数据库中的某个值，而不是先要定义一个数据集后，再去取数据。

这时就可以用 SQL 函数。

1.2 函数解释

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

1.3 注意事项

仅支持查询 sql 语句。

1.4 视频教程

示例数据：内置数据库 FRDemo 中的 STSCORE 数据表。

从内置数据库「FRDemo」里的 STSCORE 表取第三行第三列数据值。

从表 STSCORE 中，可看到第 3 行第 3 列的值为 Alex，如下图所示：

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

示例数据：内置数据库 FRDemo 中的 STSCORE 数据表。

3.1 SQL 参数为普通参数

需要取出班级为 Class1 的第 3 列所有值。

在单元格中输入：=sql("FRDemo","SELECT * FROM STSCORE where CLASSNO = 'Class1' ",3)，显示效果（班级为 Class1 的第 3 列所有值），如下图所示：

公式说明：

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

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

3.2 SQL 参数为变量

若参数值为变量如为报表参数或者是某个单元格，则写法如下：=sql("FRDemo","SELECT * FROM STSCORE where CLASSNO = '"+$class+"' ",3,4) 或=sql("FRDemo","SELECT * FROM STSCORE where CLASSNO = '"+A1+"' ",3,4)

例如希望过滤控件选择不同班级，显示不同班级下所有的同学的名字。

首先设置模板参数「class」，然后在单元格中输入公式：=sql("FRDemo","SELECT * FROM STSCORE where CLASSNO = '"+$class+"' ",3)，如下图所示：

显示效果如下图所示：

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

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

注1：如果参数或者单元格值有多个，那么 SQL 函数的写法如下：=sql("FRDemo","SELECT * FROM STSCORE where CLASSNO in ('"+$class+"') and COURSE  in ('"+$COURSE+"') ",3,4)

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

3.3 SQL 参数为变量且需要拼接

在 SQL 中还可以使用 IF 函数进行判断并拼接模板参数，例如希望实现当参数 class 为空时，选择全部学生姓名，可输入公式：

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

公式说明：

如果在 SQL 中参数为模糊查询时，可使用如下公式：

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