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 ('" + 店性质 + "')")}
则设置了店性质参数,如下图所示:
2)${} 中除了 FineBI 内置的函数名、常量外,还支持自定义的参数;
例如输入如下 SQL 语句
SELECT * FROM 订单 where 1=1 ${if(len(area) == 0,"","and 货主地区 = '" + area + "'")} ${if(len(province) == 0,"","and 货主省份 = '" + province + "'")}
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。