BIEE内置函数参考手册.docx

BIEE内置函数参考手册.docx

《BIEE内置函数参考手册.docx》由会员分享，可在线阅读，更多相关《BIEE内置函数参考手册.docx（32页珍藏版）》请在冰豆网上搜索。

BIEE内置函数参考手册

BIEE内置函数参考手册

版本：

V1.0

文档变更记录

版本

修订人

修订日期

修订内容

审核人

批准人

V1.O

刘翠、卢学静、王丽

2012-11-19

内置函数

1.聚合

1.1.AggregateAt

说明：

此函数根据指定的级别累计列。

语法：

AGGREGATE（measureATlevel[,level1,levelN]）

measure是度量列的名称。

level是要在其上进行累计的级别。

可以选择指定多个级别。

示例：

AGGREGATE（"回收情况"."回款合同数"AT"-时间"."H1Time"."Month"）

注意：

level指的是rpd中设置的维度层次，需要手写，格式为"表名"."hierarchy名"."level名"

1.2.Avg（平均值）

说明：

计算结果集中表达式的平均值。

语法：

Avg（expr）

expr是任意求值结果为数值的表达式。

示例：

Avg（"回收情况"."回款合同数"）

1.3.AvgDistinct（去重平均值）

说明：

计算表达式中所有不同值的平均值。

语法：

Avg（DISTINCTexpr）

示例：

Avg（DISTINCT"回收情况"."回款合同数"）

1.4.Mavg（移动平均值）

说明：

计算最后n行数据（包括当前行）的移动平均值。

语法：

MAVG（expr,integer）

expr是任意求值结果为数值的表达式。

integer是任意正整数。

它表示最后n行数据的平均值。

示例：

MAVG（"回收情况"."回款合同数",3）

合同数列红框内的平均值对应第三列红框值

合同数列黄框内的平均值对应第三列黄框值

合同数列绿框内的平均值对应第三列绿框值

1.5.BottomN

说明：

按从1到n的顺序依次排列表达式参数中最小的n个值，该函数返回的是排序之后的序号，1对应于最小的数值。

语法：

BottomN（expr,integer）

expr是任意求值结果为数值的表达式。

integer是任意正整数。

它表示结果集中显示的最低排名的数字,1为最低排名。

示例：

BottomN（"回收情况"."回款合同数",1）

1.6.Count（非空值行数）

说明：

计算表达式中包含非空值的行数。

语法：

COUNT（expr）

expr是任意表达式。

示例：

COUNT（"回收情况"."回款合同数"）

1.7.CountDistinct（去重去空行行数）

说明：

对计数函数进行直接处理。

语法：

COUNT（DISTINCTexpr）

expr是任意表达式。

示例：

COUNT（DISTINCT"回收情况"."回款合同数"）

1.8.Count*（）

说明：

计算行数。

语法：

COUNT（*）

示例：

例如，如果名为Facts的表包含200000000行，示例请求将返回显示的结果

Selectcount（*）fromfacts

结果：

200000000

1.9.Max（最大值）

说明：

计算符合数值表达式参数要求的行的最大值。

语法：

MAX（expr）

expr是任意求值结果为数值的表达式。

示例：

MAX（"回收情况"."回款合同数"）

1.10.Min（最小值）

说明：

计算符合数值表达式参数要求的行的最小值。

语法：

MIN（expr）

expr是任意求值结果为数值的表达式。

示例：

MIN（"回收情况"."回款合同数"）

1.11.Median（中位数）

说明：

计算符合数值表达式参数要求的行的中间值。

如果有偶数个行，则中间值为两

个中间行的平均值，此函数始终返回双精度值。

语法：

MEDIAN（expr）

expr是任意求值结果为数值的表达式。

示例：

MEDIAN（"回收情况"."回款合同数"）

补充：

Median含义为中位数

中位数计算规则：

首先要先进行数据的排序（从小到大），然后计算中位数的序号，分数据为奇数与偶数两种来求。

排序时，相同的数字不能省略）。

如果总数个数是奇数的话，按从小到大的顺序,取中间的那个数。

如果总数个数是偶数的话，按从小到大的顺序,取中间那两个数的平均数。

1.12.Ntile

说明：

根据用户指定的范围确定值的等级。

它返回整数,表示任意等级范围。

numTiles=100的NTile返回的结果一般称为“百分比段”（数值从1到100,

100表示最高等级）。

语法：

NTILE（expr,numTiles）

expr是任意求值结果为数值的表达式。

numTiles是非空值正整数,表示维片数量。

示例：

NTILE（"回收情况"."回款合同数",4）

1.13.Percentile（百分位数）

说明：

计算符合数值表达式参数要求的每个值的百分比段等级。

百分比段等级范围介于0（第0个百分比段）和1（第100个百分比段）之间。

语法：

PERCENTILE（expr）

expr是任意求值结果为数值的表达式。

示例：

PERCENTILE（"回收情况"."回款合同数"）

补充：

Percentile含义为：

百分位数

统计学术语，如果将一组数据从小到大排序，并计算相应的累计百分位，则某一百分位所对应数据的值就称为这一百分位的百分位数。

可表示为：

一组n个观测值按数值大小排列如，处于p%位置的值称第p百分位数。

1.14.Rank（排序）

说明：

计算符合数值表达式参数条件的每个值的等级。

等级1分配给最大的数字,下一个连续的整数（2,3,4,...）依次分配给后面的每个等级。

如果某些值相等,则分配相同的等级（例如,1,1,1,4,5,5,7...）。

语法：

RANK（expr）

expr是任意求值结果为数值的表达式。

示例：

Rank（"回收情况"."回款合同数"）

1.15.TopN（排序）

说明：

按从1到n的顺序依次排列表达式参数中最大的n个值,1对应于最大的数值。

语法：

TOPN（expr,integer）

expr是任意求值结果为数值的表达式。

integer是任意正整数。

它表示结果集中显示的最高排名的数字,1为最高排名。

示例：

TOPN（"回收情况"."回款合同数",5）

->

1.16.StdDev（标准差）

说明：

返回一组值的标准差。

语法：

STDDEV（expr）

expr是任意求值结果为数值的表达式。

示例：

STDDEV（"回收情况"."回款合同数"）

标准差计算公式：

方差s^2=[（x1-x）^2+（x2-x）^2+......（xn-x）^2]/n

（x为平均数）

例如：

4,8,6,2，方差为5

标准差=方差的算术平方根=s=@sqrt（（（x1-x）^2+（x2-x）^2+......（xn-x）^2）/n）

1.17.Sum（求和）

说明：

计算通过累加符合数值表达式参数要求的所有值得出的总和。

语法：

SUM（expr）

expr是任意求值结果为数值的表达式。

示例：

sum（"回收情况"."回款合同数"）

1.18.SumDistinct（去重求和）

说明：

计算通过累加符合数值表达式参数要求的所有不同值得出的总和。

语法：

Sum（DISTINCTexpr）

expr是任意求值结果为数值的表达式。

示例：

Sum（DISTINCT"回收情况"."回款合同数"）

2.运行聚合

2.1.MAVG

同聚合里的Mavg

2.2.MSUM

说明：

此函数计算最后n行数据（包括当前行）的移动总和。

语法：

MSUM（expr,integer）

expr是任意求值结果为数值的表达式。

integer是任意正整数。

它表示最后n行数据之和。

示例：

MSUM（"回收情况"."回款合同数",2）

合同数列红框内的平均值对应第三列红框值

合同数列黄框内的平均值对应第三列黄框值

合同数列绿框内的平均值对应第三列绿框值

2.3.RSUM

说明：

此函数根据迄今为止出现的记录来计算运行总和。

语法：

RSUM（expr）

expr是任意求值结果为数值的表达式。

示例：

RSUM（"回收情况"."回款合同数"）

2.4.RCOUNT

说明：

此函数采用记录集作为输入,并计算迄今为止出现的记录数量。

语法：

RCOUNT（expr）

expr是任意数据类型的表达式。

示例：

RCOUNT（"回收情况"."回款合同数"）

2.5.RMAX

说明：

此函数采用记录集作为输入,并根据迄今为止出现的记录显示最大值。

语法：

RMAX（expr）

示例：

RMAX（"回收情况"."回款合同数"）

2.6.RMIN

说明：

此函数采用记录集作为输入,并根据迄今为止出现的记录显示最小值。

语法：

RMIN（expr）

expr是任意数据类型的表达式。

示例：

RMIN（"回收情况"."回款合同数"）

3.字符串

3.1.ASCII（美国信息交换标准代码）

说明：

将单个字符串转换成介于0与255之间的相应ASCII代码。

语法：

ASCII（expr）

expr是任意求值结果为字符串的表达式.

示例：

ASCII（'A'）

补充：

美国信息交换标准代码是一种用于信息交换的美国标准代码。

7位字符集广泛用于代表标准美国键盘上的字符或符号。

通过将这些字符使用的值标准化，ASCII允许计算机和计算机程序交换信息。

ASCII字符集是与ANSI字符集中的前面128个（0-127）字符相同。

3.2.Char（与ASCII相反）

说明：

将介于0与255之间的数值转换成与ASCII代码相对应的字符值。

语法：

CHAR（expr）

expr是任意求值结果为介于0和255之间的数值的表达式。

示例：

CHAR（65）

3.3.Bit_Length

说明：

返回指定字符串的长度,以位为单位。

每个Unicode字符长度为2个字节,相当于16位。

语法：

BIT_LENGTH（expr）

expr是任意求值结果为字符串的表达式。

示例：

BIT_LENGTH（'ABC'）

3.4.Char_Length（返回字符串长度）

说明：

返回指定字符串的长度,以字符数为单位。

语法：

CHAR_LENGTH（expr）

expr是任意求值结果为字符串的表达式。

示例：

CHAR_LENGTH（"-产品"."产品名称"）

3.5.Concat（连接）

说明：

连接两个字符串。

语法：

CONCAT（expr1,expr2）

exprs是求值结果为逗号分隔字符串的表达式。

示例：

CONCAT（"-产品"."产品大类","-产品"."产品名称"）

3.6.Insert（改写）

说明：

将指定的字符串插入到另一个字符串的指定位置。

语法：

INSERT（expr1,integer1,integer2,expr2）

expr1是任意求值结果为字符串的表达式。

它标识目标字符串。

integer1是任意正整数,它表示从目标字符串开头数起的第几个字符处插入第二个字符串。

示例：

INSERT（'12345',2,3,'abc'）

备注：

从第二个位置开始改写，改写3个字符，值为’abc’.

3.7.Left（从左侧截取）

说明：

返回从字符串左侧算起的指定字符数。

语法：

LEFT（expr,integer）

expr是任意求值结果为字符串的表达式

integer是任意正整数,它表示从字符串左侧开始返回的字符数。

示例：

LEFT（"-城市地区"."城市名称",2）

3.8.Right（从右侧截取）

说明：

返回从字符串右侧算起的指定字符数。

语法：

RIGHT（expr,integer）

expr是任意求值结果为字符串的表达式。

integer是任意正整数,它表示从字符串右侧返回的字符数。

示例：

RIGHT（'abcde',2）

3.9.Substring（字符串截取）

说明：

从固定字符数开始在原始字符串中创建新字符串。

语法：

SUBSTRING（exprFROMstartPosFORlength）

expr是任意求值结果为字符串的表达式。

startPos是任意正整数,它表示从字符串左侧数起的第几个字符处开始生成结果。

示例：

SUBSTRING（'adcbefg'FROM4）

3.10.Length（长度）

说明：

返回指定字符串的长度,以字符数为单位。

返回的长度不包括任何尾随空白字符。

语法：

LENGTH（expr）

示例：

LENGTH（"-城市地区"."城市名称"）

3.11.Locate（字符串位置）

说明：

返回字符串在另一个字符串中的位置,以数字表示。

语法：

LOCATE（expr1,expr2）

expr1是任意求值结果为字符串的表达式。

它标识要搜索的字符串。

expr2是任意求值结果为字符串的表达式。

它标识要在其中执行搜索的字符串。

示例：

LOCATE（'市',"-城市地区"."城市名称"）

3.12.LocateN

注意：

此函数名有错误，实际应为“Locate”，“Locaten”函数测试有误。

说明：

返回字符串在另一个字符串中的位置,以数字表示。

此函数与Locate函数相同,不同之处在于搜索起始位置由整数参数指定。

语法：

LOCATE（expr1,expr2,integer）

expr1是任意求值结果为字符串的表达式。

它标识要搜索的字符串。

expr2是任意求值结果为字符串的表达式。

它标识要在其中执行搜索的字符串。

interger是任意非零正整数,它表示开始搜索字符串的位置。

示例：

LOCATE（'b','abcdef',3）

备注：

使用BIEE给出的函数名Locaten，测试始终报错，如下所示

3.13.Position（字符串位置）

说明：

返回expr1在字符表达式中的位置,以数字表示。

语法：

POSITION（expr1INexpr2）

expr1是任意求值结果为字符串的表达式。

它标识要在目标字符串中搜索的字符串。

expr2是任意求值结果为字符串的表达式。

它标识要在其中执行搜索的目标字符串。

示例：

POSITION（'a'IN'bacde'）

3.14.Lower（转换小写）

说明：

将字符串转换成小写字母。

语法：

LOWER（expr）

expr是任意求值结果为字符串的表达式。

示例：

LOWER（'ABCDE'）

3.15.Upper（转换大写）

说明：

将字符串转换成大写字母。

语法：

UPPER（expr）

expr是任意求值结果为字符串的表达式。

示例：

UPPER（'abcdefga'）

3.16.Octet_Length

说明：

返回指定字符串的位数,8个单位（字节数）一组。

语法：

OCTET_LENGTH（expr）

expr是任意求值结果为字符串的表达式。

示例：

OCTET_LENGTH（'HelloWorld'）

3.17.Repeat（复制）

说明：

将指定的表达式重复n次。

语法：

REPEAT（expr,integer）

expr是任意求值结果为字符串的表达式

integer是任意正整数,它表示字符串的重复次数。

示例：

REPEAT（'abcd',2）

3.18.Replace（替换）

说明：

将指定字符表达式中的一个或多个字符替换为一个或多个其他字符。

语法：

REPLACE（expr1,expr2,expr3）

expr1是任意求值结果为字符串的表达式。

这是要替换其中字符的字符串。

expr2是任意求值结果为字符串的表达式。

第二个字符串标识要从第一个字符串中替换掉的字符。

示例：

Replace（'abcd1234','123','zz'）

3.19.Space（插入空格）

说明：

插入空格。

语法：

SPACE（expr）

integer是任意正整数,它指示要插入的空格数.

示例：

INSERT（'12345',2,3,SPACE（3））

3.20.TrimBoth

说明：

从字符串中删除指定的前导和尾随字符。

语法：

TRIM（BOTHcharFROMexpr）

char是任意单个字符。

如果忽略此规范（以及所需的单引号）,则使用空白字符作为默认值。

expr是任意求值结果为字符串的表达式。

示例：

TRIM（BOTH'a'FROM'abcdefga'）

3.21.TrimLeading

说明：

从字符串中删除指定的前导字符。

语法：

TRIM（LEADINGcharFROMexpr）

char是任意单个字符。

如果忽略此规范（以及所需的单引号）,则使用空白字符作为默认值。

expr是任意求值结果为字符串的表达式。

示例：

TRIM（LEADING'a'FROM'abcdefga'）

3.22.TrimTrailing

说明：

从字符串中删除指定的尾随字符。

语法：

TRIM（TRAILINGcharFROMexpr）

char是任意单个字符。

如果忽略此规范（以及所需的单引号）,则使用空白字符作为默认值。

expr是任意求值结果为字符串的表达式。

示例：

TRIM（TRAILING'a'FROM'abcdefga'）

4.数字

4.1.Abs（绝对值）

说明：

计算数值表达式的绝对值。

语法：

ABS（expr）

expr是任意求值结果为数值的表达式。

示例：

ABS（-123）

4.2.Acos（反余弦）

说明：

计算数值表达式的反余弦。

语法：

ACOS（expr）

expr是任意求值结果为数值的表达式。

示例：

ACOS（-1）

补充：

expr是有范围的：

-1~1直接的数值。

4.3.Asin（反正弦）

说明：

计算数值表达式的反正弦。

语法：

ASIN（expr）

expr是任意求值结果为数值的表达式。

示例：

ASIN（-1）

补充：

expr是有范围的：

-1~1直接的数值。

4.4.Atan（反正切）

说明：

计算数值表达式的反正切。

语法：

ATAN（expr）

expr是任意求值结果为数值的表达式。

示例：

ATAN（-1）

4.5.Atan2

说明：

计算y/x的反正切,其中,y是第一个数值表达式,x是第二个数值表达式。

语法：

ATAN2（expr1,expr2）

expr是任意求值结果为数值的表达式。

示例：

备注：

1.49计算规则是：

1.57/1.05所得。

4.6.Cos（余弦）

说明：

计算数值表达式的余弦。

语法：

COS（expr）

expr是任意求值结果为数值的表达式。

示例：

COS（Radians（90））

备注：

expr指的是弧度数不是角度数。

4.7.Cot（余切）

说明：

计算数值表达式的余切。

语法：

COT（expr）

expr是任意求值结果为数值的表达式。

示例：

COT（Radians（90））

备注：

expr指的是弧度数不是角度数。

4.8.Tan（正切）

说明：

计算数值表达式的正切。

语法：

TAN（expr）

expr是任意求值结果为数值的表达式。

示例：

TAN（Radians（90））

备注：

expr指的是弧度数不是角度数。

4.9.Sin（正弦）

说明：

计算数值表达式的正弦。

语法：

SIN（expr）

expr是任意求值结果为数值的表达式。

示例：

SIN（Radians（90））

备注：

expr指的是弧度数不是角度数。

4.10.Ceilling（小数舍入到最大整数）

说明：

将一个非整数数值表达式的值舍入到最近的最大整数。

语法：

CEILING（expr）

expr是任意求值结果为数值的表达式。

示例：

CEILING（2.4544）

4.11.Floor（小数舍入到最小整数）

说明：

将一个非整数数值表达式的值舍入到最近的最小整数。

语法：

FLOOR（expr）

expr是任意求值结果为数值的表达式。

示例：

FLOOR（2.94）

4.12.Round（四舍五入）

说明：

将数值表达式的值四舍五入到n位精度。

语法：

ROUND（expr,integer）

expr是任意求值结果为数值的表达式。

integer是任意正整数,它表示精度的位数。

示例：

ROUND（2.166000,2）

4.13.Truncate（返回指定小数位）

说明：

截断小数,以返回从小数点开始算起的指定位数。

语法：

TRUNCATE（expr,integer）

expr是任意求值结果为数值的表达式。

integer是任意正整数,它表示从小数点位置右侧返回的字符数。

示例：

TRUNCATE（23.3232,2）

4.14.Degrees（角度）

说明：

将表达式的值从弧度转换为角度。

语法：

DEGREES（expr）

expr是任意求值结果为数值的表达式。

示例：

DEGREES（20）

4.15.Radians（弧度）

说明：

将表达式的值从角度转换为弧度。

语法：

RADIANS（expr）

expr是任意求值结果为数值的表达式。

示例：

RADIANS（1145.45）

4.16.Exp

说明：

将值发送给指定的幂。

语法：

EXP（expr）

expr是任意求值结果为数值的表达式。

示例：

EXP

（1）

4.17.Log（自然对数）

说明：

计算表达式的自然对数。

语法：

LOG（expr）

expr是任意求值结果为数值的表达式。

示例：

LOG（10）

4.18.Log10（对数）

说明：

计算表达式的常用对数。

语法：

LOG10（expr）

expr是任意求值结果为数值的表达式。

示例：

LOG10（10）

4.19.Mod（商的余数）

说明：

将第一个数值表达式除以第二个数值表达式,然后返回商的余数部分。

语法：

MOD（expr1,expr2）

expr是任意求值结果为数值的表达式。

示例：

MOD（