可用函数.docx

1、可用函数可用函数数学运算函数abs命令格式double abs(double number)bigint abs(bigint number)用途 返回绝对值，若输入为NULL，返回NULL参数说明 number: double或bigint类型，输入为bigint时返回bigint，输入为double时返回double类型。若输入为string类型会隐式转换到double类型后参与运算，其它类型抛异常。Note当输入bigint类型的值超过bigint的最大表示范围时，会返回double类型，这种情况下可能会损失精度。示例 abs(-1) 返回 1 abs(-9223372036854775

2、808) 返回9223372036854776000.0，因为9223372036854775808超出了bigint能表达的最大值范围。acos命令格式double acos(double number)用途 反余弦函数。参数说明 number: double类型， -1number1。若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值 double类型，值域在0 之间。若number为NULL，返回NULL。示例 acos(1) 返回 0.0 acos(-1) 返回 3.141592653589793asin命令格式double asi

3、n(double number)用途 反正弦函数。参数说明 number: double类型， -1number1。若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值 double类型，值域在-/2 /2之间。若number为NULL，返回NULL。示例 asin(1) 返回 1.5707963267948966 asin(-1) 返回 -1.5707963267948966atan命令格式：double atan(double number)用途 反正切函数。参数说明number: double类型，若输入为string类型或bigint

4、类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值 double类型，值域在-/2 /2之间。若number为NULL，返回NULL。示例 atan(1) 返回 0.7853981633974483 atan(-1) 返回 -0.7853981633974483ceil命令格式：bigint ceil(double value)用途 返回不小于输入值的最小整数参数说明value: double类型，接受bigint,double的隐式转换。返回值 bigint类型。任一输入为NULL，返回NULL。示例 ceil(1.1) 返回2 ceil(-1.1) 返回 -1conv命令格

5、式string conv(string input, bigint from_base, bigint to_base)用途 进制转换函数参数说明 input: 以string表示的要转换的整数值，接受bigint, double的隐式转换。 from_base,to_base，以十进制表示的进制的值，可接受的的值为2,8,10,16。接受string,double的隐式转换。返回值 string类型。任一输入为NULL，返回NULL。 转换过程以64位精度工作，溢出时报异常。 输入如果是负值，即以-开头，报异常。Note如果输入的是小数，则会转为整数值后进行进制转换，小数部分会被舍弃。示例

6、conv(1100,2,10) 返回 12 conv(1100,2,16) 返回 ccos命令格式double cos(double number)用途 余弦函数，输入为弧度值。参数说明number: double类型。若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值 double类型。若number为NULL，返回NULL。示例 cos(3.1415926/2)=2.6794896585028633e-8 cos(3.1415926)=0.9999999999999986cosh命令格式double cosh(double number

7、)用途 双曲余弦函数。参数说明number: double类型。若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值 double类型。若number为NULL，返回NULL。cot命令格式double cot(double number)用途 余切函数，输入为弧度值。参数说明number: double类型。若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值 double类型。若number为NULL，返回NULL。exp命令格式double exp(double number)用途 指

8、数函数。参数说明number: double类型。若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值 double类型。若number为NULL，返回NULL。rand命令格式double rand(seed)用途 返回double类型的随机数，返回值区间是的01.参数说明seed:bigint类型， 随机数种子， 决定随机数序列的起始值round命令格式round(number, decimal_places)用途 四舍五入到指定小数点位置。参数说明number: double类型，若输入为string类型或bigint类型会隐式转换到d

9、ouble类型后参与运算，其他类型抛异常。decimal_place: bigint类型常量，四舍五入计算到小数点后的位置，其他类型参数会引发异常. 如果省略表示四舍五入到个位数。返回值 返回四舍五入的结果, double类型。若number或decimal_places为NULL，返回NULL。Notedecimal_places可以是负数。负数会从小数点往左开始round，并且不保留小数部分；如果decimal_places超过了整数部分长度，返回0.示例 round(125.315) 返回 125 round(125.315, 0) 返回125 round(125.315, 1) 返回

10、125.3 round(125.315, 2) 返回 125.32 round(125.315, 3) 返回 125.315 round(-125.315, 2) 返回 -125.32 round(null) 返回nullfloor命令格式bigint floor(double number)用途 向下取整，返回比number小的整数值。参数说明number: double类型，若输入为string类型或bigint型会隐式转换到double类型后参与运算，其他类型抛异常返回值 返回向下取整的结果, bigint类型。若number为NULL，返回NULL。示例 floor(1.2)=1 fl

11、oor(1.9)=1 floor(0.1)=0 floor(-1.2)=-2 floor(-0.1)=-1 floor(0.0)=0 floor(-0.0)=0sin命令格式double sin(double number)用途 正弦函数，输入为弧度值。参数说明number: double类型。若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值 double类型。若number为NULL，返回NULL。sinh命令格式double sinh(double number)用途 双曲正弦函数。参数说明number: double类型。若输入为s

12、tring类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值 double类型。若number为NULL，返回NULL。sqrt命令格式double sqrt(double number)用途 计算平方根。参数说明number: double类型，必须大于0。小于0时引发异常。若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值 平方根，double类型。若number为NULL，返回NULL。tan命令格式double tan(double number)用途 正切函数，输入为弧度值。参数说明number:

13、 double类型。若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值： double类型。若number为NULL，返回NULL。tanh命令格式double tanh(double number)用途： 双曲正切函数。参数说明：number: double类型。若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值: double类型。若number为NULL，返回NULL。trunc命令格式trunc(number, decimal_places)用途： 将输入值截取到指定小数点位置。

14、参数说明： number:double类型，若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。 decimal_places: bigint类型常量，要截取到的小数点位置，其他类型参数会隐式转为bigint，省略此参数时默认到截取到个位数。返回值： 返回值类型为double。若number或decimal_places为NULL，返回NULL。Note truncate掉的部分补0。 decimal_places可以是负数，负数会从小数点往左开始truncate，并且不保留小数部分；如果decimal_places超过了整数部分长度，返回0.示例

15、 trunc(125.815) 返回 125 trunc(125.815, 0) 返回125 trunc(125.815, 1) 返回 125.8 trunc(125.815, 2) 返回 125.81 trunc(125.815, 3) 返回 125.815 trunc(-125.815, 2) 返回 -125.81 trunc(125.815, -1) 返回 120 trunc(125.815, -2) 返回 100 trunc(125.815, -3) 返回 0ln命令格式double ln(double number)用途： 返回number的自然对数。参数说明number: doub

16、le类型，若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。若number为NULL返回NULL, 若number为负数或零，则抛异常。log命令格式double log(double base, double x)用途： 返回以base为底的x的对数。参数说明base: double类型, 若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。x: double类型，若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。返回值: double类型的对数值，若

17、base和x中存在NULL，则返回NULL；若base和x中某一个值为负数或0，会引发异常；若base为1（会引发一个除零行为）也会引发异常。pow命令格式double pow(double x, double y)用途： 返回x的y次方，即xy。参数说明： X: double类型, 若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。 Y: double类型, 若输入为string类型或bigint类型会隐式转换到double类型后参与运算，其他类型抛异常。若x或y为NULL，则返回NULL字符串处理函数char_matchcount命令格式ch

18、ar_matchcount(str1, str2)用途： 用于计算str1中的每个字符在str2中出现的次数总和，任一输入为NULL返回NULL。参数说明 str1, str2: string类型，必须为有效的UTF-8字符串，如果对比中发现有无效字符则函数返回负值。返回值： bigintchr命令格式chr(ascii)用途： 将给定ASCII转换成字符，参数范围是0255，超过此范围会引发异常。输入值为NULL返回NULL。参数说明： ascii: bigint类型ascii值,若输入为string类型或double类型会隐式转换到bigint类型后参与运算，其它类型抛异常。返回值： st

19、ringconcat命令格式concat(string A, string B.)用途： 返回值是将参数中的所有字符串连接在一起的结果。参数说明： A,B等为string类型，若输入为bigint, double, datetime类型会隐式转换为string后参与运算，其它类型报异常。返回值： stringNote如果没有参数或者某个参数为NULL，结果均返回NULLconcat(), concat(null, a), concat(a, null, b)返回值都是NULLis_encoding命令格式is_encoding(str, from_encoding, to_encoding)用

20、途： 判断输入字符串是否从指定的一个字符集转为另一个字符集，可用于判断输入是否为乱码, 通常的用法是将from_encoding设为utf-8,to_encoding设为gbk参数说明： str:string类型，输入为NULL返回NULL。空字符串则可以被认为属于任何字符集。 from_encoding, to_encoding: string类型，源及目标字符集。输入为NULL返回NULL。返回值： boolean类型, 如果str能够成功转换，则返回true，否则返回falseip2region命令格式ip2region(ip, region_level)用途： 根据ip地址取相应的城市

21、地址.参数说明： ip:string类型，其它类型报异常，ip格式如192.168.0.1，每段的值在0-255之间，非法的ip返回NULL。 region_level: string类型，指定返回地址的级别 * country 国家 * province 省 * city 市 * district 县/区 * school 学校，如果是教育网的IP，则返回学校返回值： string类型，地区名称。当给定IP找不到相应记录时，返回NULL。如果有符合条件的多条记录，只返回一条。Note此函数依赖于字典文件ip_region_dict,字典内容由PE维护。当前字典中是用”-“表示内容不存在，因此

22、当字典中的值为”-“时，会返回NULL.instr命令格式instr(string1, string2, start_position, nth_appearance)用途： 计算一个子串在字符串中的位置.参数说明： string1:string类型，搜索的字符串，若输入为bigint, double, datetime类型会隐式转换为string后参与运算，其它类型报异常。 string2:string类型， 要搜索的子串，若输入为bigint, double, datetime类型会隐式转换为string后参与运算, 其它类型报异常。 start_position:bigint类型，其它类

23、型会抛异常，表示从string1的第几个字符开始搜索，默认起始位置是第一个字符位置1。开始位置如果小于等于0会引发异常。 nth_appearance:bigint类型，大于0，表示子串在字符串中的第n次匹配的位置，如果nth_appearance为其它类型或小于等于0会抛异常。返回值： string2在string1中的出现的位置。Note如果在string1中未找到string2，返回0.任一输入参数为NULL返回NULL如果string2为空串时总是能匹配成功， 因此instr(abc,) 会返回1示例INSTR (Tech on the net, e) 返回 2INSTR (Tech

24、on the net, e, 1, 1)返回 2.INSTR (Tech on the net, e, 1, 2)返回 11.INSTR (Tech on the net, e, 1, 3)返回14.keyvalue命令格式keyvalue(string srcStr，string split1，string split2， string key)keyvalue(string srcStr， string key) /split1 = “;”，split2 = “:”用途: 将srcStr按split1分成key-value对，按split2将key-value对分开，返回key所对应的va

25、lue参数说明 srcStr 输入待拆分的字符串 key 指定返回第几个字符串 split1, split2 拆分的字符串， 只有两个参数时，默认split1 = ;, split2 = :返回值: string Split1或split2 为NULL时，返回NULL. srcStr,key为NULL或者没有匹配的key时，返回NULL 如果有多个key-value匹配，返回第一个匹配上的key对应的value示例keyvalue(”;decreaseStore:1;xcard:1;isB2C:1;tf:21910;cart:1;shipping:2;pf:0;market:shoes;ins

26、tPayAmount:0;”, ”;”,”:”,”tf”) 返回 “21910”Note如果从console输入时字符串中有分号，应该用;转义。该函数行为是实现成与taobao hive里的UDF一致，如果在taobao hive里的UDF行为有改动，请联系产品经理。length命令格式：length(string)用途： 返回一个字符串的长度。返回值为整型。若string是NULL返回NULL。如果string非UTF-8编码格式，返回-1。参数说明： string: string类型，若输入为bigint, double, datetime类型会隐式转换为string后参与运算，其它类型报

27、异常。返回值 bigint, 字符串的长度lengthb命令格式lengthb(string)用途： 返回一个字符串的以字节为单位的长度。返回值为整型。若string是NULL返回NULL。参数说明： string: string类型，若输入为bigint, double, datetime类型会隐式转换为string后参与运算，其它类型报异常。md5命令格式md5(value)用途: 计算输入字符串的md5值参数说明： value: string类型，如果输入类型是bigint, double, datetime会隐式转换成string类型参与运算，其它类型报异常。输入为NULL，返回NUL

28、L。返回值： 输入字符串的md5值regexp_extract命令格式regexp_extract(source, pattern,occurrence)用途: 将字符串source按照pattern正则表达式的规则拆分，返回第occurrence个group指字的字符。参数说明： source: string类型，待搜索的字符串。 pattern: string类型常量，pattern为空串时抛异常, pattern中如果没有指定group，抛异常。 occurrence: bigint类型常量，必须=0，其它类型或小于0时抛异常，不指定时默认为1，表示返回第一个group。若occurre

29、nce = 0， 返回满足整个pattern的子串。返回值： string类型，任一输入为NULL返回NULL。示例select regexp_extract(foothebar,foo(.*?)(bar), 1) from dual; theselect regexp_extract(foothebar,foo(.*?)(bar), 2) from dual; barselect regexp_extract(foothebar,foo(.*?)(bar), 0) from dual; foothebarregexp_instr命令格式：regexp_instr(source, patter

30、n, start_position,nth_occurrence,return_option)用途： 返回字符串source从start_position开始, 和pattern第n次（nth_occurrence）匹配的子串的 起始/结束 位置。 任一输入参数为NULL时返回NULL。参数说明 source: string类型，待搜索的字符串。 pattern: string类型常量，pattern为空串时抛异常。 start_position:bigint类型常量,搜索的开始位置。不指定时默认值为1，其它类型或小于等于0的值会抛异常。 nth_occurrence: bigint类型常量，不指定时默认值为1， 表示搜索第一次出现的位置。小于等于0或者其它类型抛异常。 return_option: bigint类型常量，值为0或1， 其它类型或不允许的值会抛异常。0表示返回匹配的开始位置，1表示返回匹配的结束位置。返回值： 视return_option指定的类型返回