阿里云物联网平台：函数列表

函数名

函数说明

abs(number)

返回绝对值。

asin(number)

返回number值的反正弦。

attribute(key)

返回key所对应的设备标签。如果设备没有该key对应的标签，则返回值为空。使用SQL调试时，因为没有真实设备及对应的标签，返回值为空。

concat(string1, string2)

用于连接字符串。返回连接后的字符串。

示例：concat(field,'a')。

cos(number)

返回number值的余弦。

cosh(number)

返回number值的双曲余弦（hyperbolic cosine）。

crypto(field,String)

对field的值进行加密。

第二个参数String为算法字符串。可选：MD2、MD5、SHA1、SHA-256、SHA-384、SHA-512。

deviceName()

返回当前设备名称。使用SQL调试时，因为没有真实设备，返回值为空。

endswith(input, suffix)

判断input的值是否以suffix结尾。

exp(number)

返回以自然常数e为底的指定次幂。

floor(number)

返回一个最接近它的整数，它的值小于或等于这个浮点数。

log(n, m)

返回自然对数。

如果不传m值，则返回log(n)。

lower(string)

返回小写字符串。

mod(n, m)

n%m余数。

nanvl(value, default)

返回属性值。

若属性值为null，则返回default。

newuuid()

返回一个随机UUID字符串。

payload(textEncoding)

返回设备发布消息的payload转义字符串。

字符编码默认UTF-8，即payload()默认等价于payload(‘utf-8’)。

power(n,m)

返回n的m次幂。

rand()

返回[0~1)之间的一个随机数。

replace(source, substring, replacement)

对某个目标列值进行替换，即用replacement替换source中的substring。

示例：replace(field,’a’,’1’)。

sin(n)

返回n值的正弦。

sinh(n)

返回n值的双曲正弦（hyperbolic sine）。

tan(n)

返回n值的正切。

tanh(n)

返回n值的双曲正切（hyperbolic tangent）。

thingPropertyFlatMap(property)

获取物模型属性对应数值，并去掉item层级，value有多个时，使用“_”拼接。当物模型属性多于50个时，云产品流转无法流转全量物模型属性，使用该函数可以拉平物模型属性结构，实现全量物模型属性流转。

property为需要获取的属性，可以传入多个property，为空则表示提取所有属性。

示例：使用thingPropertyFlatMap('Power', 'Position')，将在消息体中添加"Power": "On", "Position_latitude": 39.9, "Position_longitude": 116.38。

timestamp(format)

返回当前系统时间，格式化后返回北京时间（GMT+8）。

format为可选。如果为空，则返回当前系统时间戳毫秒值，例如，使用timestamp()，返回的时间戳为1543373798943；如果指定format，则根据指定格式，返回当前系统时间，如timestamp('yyyy-MM-dd\'T\'HH:mm:ss\'Z\'')，返回的时间戳为2018-11-28T10:56:38Z。

timestamp_utc(format)

返回当前系统时间，格式化后返回UTC时间。

format为可选。如果format为空，则返回当前系统时间戳毫秒值，例如，使用timestamp_utc()，返回的时间戳为1543373798943；使用timestamp_utc('yyyy-MM-dd\'T\'HH:mm:ss\'Z\'')，返回的时间戳为2018-11-28T02:56:38Z。

topic(number)

返回Topic分段信息。

如，有一个Topic：/alDbcLe****/TestDevice/user/set。使用函数topic()，则返回整个Topic；使用topic(1)，则返回Topic的第一级类目alDbcLe****；使用topic(2)，则返回第二级类目TestDevice，以此类推。

upper(string)

将字符串中的小写字母转为大写字母。

示例：函数upper(alibaba)的返回结果是ALIBABA

to_base64(*)

当原始Payload数据为二进制数据时，可使用该函数，将所有二进制数据转换成base64String。

messageId()

返回物联网平台生成的消息ID。

substring(target, start, end)

返回从start（包括）到end（不包括）的字符串。

参数说明：

• target：要操作的字符串。必填。

• start：起始下标。必填。

• end：结束下标。非必填。

字符串截取示例：

• substring('012345', 0) = "012345"

• substring('012345', 2) = "2345"

• substring('012345', 2.745) = "2345"

• substring(123, 2) = "3"

• substring('012345', -1) = "012345"

• substring(true, 1.2) error

• substring('012345', 1, 3) = "12"

• substring('012345', -50, 50) = "012345"

• substring('012345', 3, 1) = ""

to_hex(*)

当原始Payload数据为二进制数据时，可使用该函数，将二进制数据转换成十六进制字符串。

user_property()

设备使用MQTT 5.0协议通信时，获取UserProperty列表中的属性数据。

• user_property()获取所有属性数据。

• user_property('${Key}')获取指定Key的数据。

例如设备上报的UserProperty为 {"a": "1", "b": "2"}：

• user_property()返回"{\"a\": \"1\", \"b\": \"2\"}"。

• user_property('a')返回"{\"a\": \"1\"}"。

things_function_type()

获取上报的物模型功能类型。仅对物模型事件和服务的消息生效。各功能返回值如下：

• 事件：返回事件的标识符。

• 服务：返回服务的标识符。

例如Topic：/SdfgeW***/device1/thing/event/BrokenInfo/post，流转事件BrokenInfo的数据，things_function_type()返回上报事件标识符BrokenInfo。

things_property('${参数名称}')

获取物模型属性、服务、事件中参数对应的值。仅对物模型消息生效。

例如Topic：/${productKey}/${deviceName}/thing/event/property/post，流转上报属性中CurrentTemperature（当前温度）数据，things_property('CurrentTemperature')返回CurrentTemperature上报的值。