轻易云数据集成平台函数使用指南

轻易云数据集成平台的函数基于MySQL，允许用户像使用MySQL函数一样编写字段属性值。自定义函数需通过_function声明。

动态值在函数中的使用

动态值变量应以{value}形式插入。处理字符串时需用单引号包裹，例如'{value}'。以下是几个示例：

示例1：计算金额

_function{price}*{qty}

示例2：保留两位小数，四舍五入

_functionROUND({price}*{qty},2)

示例3：替换字符串中的特定字符

_functionREPLACE('{customer_name}','张三','李四')
// 将客户名称中的“张三”替换为“李四”。字符串需要用单引号包裹。

常用函数集合

用户可以自行编写自定义函数，轻易云集成平台也提供了大量预设函数供快速复用。

在字段属性配置页面有【函数助手】功能，提供大量预设函數支持。

向上取整

传入一个可计算变量%v，返回大于或等于x的最小整数。

_functionCEIL(%v)

向下取整

传入一个可计算变量%v，返回小于或等于x的最大整数。

_functionFLOOR(%v)

四舍五入

传入一个可计算变量%v和保留的小数位数。

_functionROUND(%v,2)

字符串长度

传入一个字符串变量%v，返回其长度。

_functionLENGTH('%v')

字符串转小写

将字符串转换为小写。

_functionLOWER('%v')

字符串转大写

将字符串转换为大写。

_functionUPPER('%v')

IF逻辑判断

MySQL的IF语句根据表达式结果执行不同的操作。语法如下：

IF(expr,v1,v2)

当expr为真时返回v1，否则返回v2。例如，当单价大于100时，将单价变为0：

_functionIF({price}>=100,0,{price})

CASE搜索

除了IF函数，还提供CASE条件语句，使代码更可读高效。CASE语句有简单和可搜索两种形式。

简单CASE语句

检查表达式与一组唯一值的匹配。语法如下：

CASE <表达式>
  WHEN <值1> THEN <操作>
  WHEN <值2> THEN <操作>
  ...
  ELSE <操作>
END CASE;

如果表达式与某个WHEN子句匹配，则执行相应操作；否则执行ELSE子句中的命令。

可搜索CASE语句

用于更复杂的匹配，如范围检查。语法如下：

CASE 
  WHEN <条件1> THEN <命令>
  WHEN <条件2> THEN <命令>
  ...
  ELSE commands 
END CASE;

MySQL会逐个评估WHEN子句条件，找到TRUE后执行THEN子句命令；若无匹配则执行ELSE子句。如果没有ELSE且无匹配项，将报错。