历史版本5 :SQL 数据集定义参数 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 必须遵循的命名规则编辑

1)不能以数字$符号开头;

2)变量名只能是字母(a-z A-Z)数字(0-9)下划线(_)(@)中文的组合,并且之间不能包含空格;

3)变量名中不能含有? * . - 等字符和空格

4)变量名不能使用编程语言的保留字。比如小写的 true、false 等保留字。但大写的 TRUE、FALSE 可以。

2. 经典命名规则编辑

2.1 匈牙利命名法

该命名法是在每个变量名的前面加上若干表示数据类型的字符。基本原则是:变量名=属性+类型+对象描述

如i表示int,所有i开头的变量命都表示int类型。s表示String,所有变量命以s开头的都表示String类型变量。

2.2 骆驼命名法

正如它的名称所表示的那样,是指混合使用大小写字母来构成变量和函数的名字。

驼峰命名法跟帕斯卡命名法相似,只是首字母为小写,如userName。因为看上去像驼峰,因此而得名。

2.3 帕斯卡命名法

做法是首字母大写,如UserName。

3. 示例编辑

3.1 简单应用

在创建 添加 SQL 数据集 时,直接使用where条件定义参数,并过滤出需要的数据,缩短取数时间,例如:SELECT * FROM 销量 where 地区 = '${地区}'  

3.2 带公式的应用

数据集 SQL 中可以使用参数宏${}动态地生成过滤条件,${}中的语句在 FineBI 中执行,将${}的执行结果与 SQL 语句拼接起来形成最终的查询语句,传递给数据库执行,可以使用多个${}。

1)例如:SELECT * FROM new_dian where 1=1 ${if(len(店性质) == 0,"","and 店性质 in ('" + 店性质 + "')")}   

则设置了店性质参数,如下图所示:

58.png

2)${} 中除了 FineBI 内置的函数名、常量外,还支持自定义的参数;

例如输入如下 SQL 语句

SELECT * FROM 订单 where 1=1 ${if(len(area) == 0,"","and 货主地区 = '" + area + "'")} ${if(len(province) == 0,"","and 货主省份 = '" + province + "'")}  

731.png

IF 公式是 FineBI 内置的公式,area 和 province 都是自定义的参数。如果len(area)!=0,即 area 参数不为空,比如说 area 的值为华东,那么 IF 语句的执行结果为and 货主地区='华东',然后再把这句话拼接到 SQL 语句当中,SQL 语句就变成:

SELECT * FROM 订单 where 1=1 and 货主地区='华东' and 货主省份='江苏'

注:${} 中可以使用所有内置的 FineBI 公式,如 IF 函数。详情参见:函数 

4. 注意事项编辑

1)字符参数有英文单引号'${adce}',数字参数没有英文单引号${adce}。其中 adce 为参数。

2)参数值的引用格式为参数前面加$符号,如$adce