轻易云数据集成平台的自定义函数使用教程

  • 系统对接顾问

函数定义

轻易云数据集成平台的函数使用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 语句允许根据表达式条件执行不同操作。表达式可以结合文字、变量、运算符甚至其他函数来组合,并返回TRUE、FALSE或NULL之一。语法如下:

IF(expr,v1,v2)

其中,当表达式expr为真时返回v1,否则返回v2。
示例1:当单价大于100时,将单价设置为0。

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

CASE搜索

除了IF功能,还提供了CASE条件语句,使代码更加可读和高效。有两种形式:简单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子句中的命令;若无TRUE条件且省略ELSE子句,会发出错误消息。如不想处理ELSE逻辑,可在ELSE放置空BEGIN END块避免错误。