文本函数

concat

语法	concat(S1,S2,S3...)
参数说明	字符串类型参数；参数个数是可变的，至少需要1个参数
返回值类型	字符串
描述	将多个参数作为文本拼接到一起。例如：concat('abc', 123)，返回字符串类型：'abc123'
例子	concat('abc', 123, 'hello')，返回：'abc123hello' concat('abc', 123)，返回：'abc123'

initcap

语法	initcap(S)
参数说明	字符串类型参数
返回值类型	字符串
描述	对指定字符串做格式化操作，将字符串中的每个单词首字母变为大写，其他字母变为小写
例子	initcap('hello world')，返回：'Hello World'
不支持的数据源	tidb、mongodb

length

语法	length(S)
参数说明	字符串类型参数
返回值类型	数字
描述	计算字符串的长度
例子	length('hello')，返回：5

like

语法	like(S,LITERAL_PATTERN)
参数说明	1. 字符串类型参数，可选类型：STRING； 2. 指定模式，可选类型：字符串
返回值类型	布尔
描述	指定字段包含特定字符串
例子	like('hello world', 'world')，返回：TRUE

like_all

语法	like_all(S,LITERAL_PATTERN_LIST)
参数说明	1. 字符串类型参数，可选类型：STRING； 2. 指定模式列表，可选类型：字符串列表
返回值类型	布尔
描述	指定字段包含特定字符串列表中的所有项
例子	like_all('hello world', ['world','ello'])，返回：TRUE

like_any

语法	like_any(S,LITERAL_PATTERN_LIST)
参数说明	1. 字符串类型参数，可选类型：STRING； 2. 指定模式列表，可选类型：字符串列表
返回值类型	布尔
描述	指定字段包含特定字符串列表中的任意一项
例子	like_any('hello world', ['world','abcd'])，返回：TRUE

like_ci

语法	like_ci(S,LITERAL_PATTERN)
参数说明	1. 字符串类型参数，可选类型：STRING； 2. 指定模式，可选类型：字符串
返回值类型	布尔
描述	指定字段包含特定字符串，不区分大小写
例子	like_ci('hello world', 'World')，返回：TRUE

like_ci_all

语法	like_ci_all(S,LITERAL_PATTERN_LIST)
参数说明	1. 字符串类型参数，可选类型：STRING； 2. 指定模式列表，可选类型：字符串列表
返回值类型	布尔
描述	指定字段包含特定字符串列表中的所有项，不区分大小写
例子	like_ci_all('hello world', ['World','ello'])，返回：TRUE

like_ci_any

语法	like_ci_any(S,LITERAL_PATTERN_LIST)
参数说明	1. 字符串类型参数，可选类型：STRING； 2. 指定模式列表，可选类型：字符串列表
返回值类型	布尔
描述	指定字段包含特定字符串列表中的任意一项，不区分大小写
例子	like_ci_any('hello world', ['World','abcd'])，返回：TRUE

lower

语法	lower(S)
参数说明	字符串类型参数
返回值类型	字符串
描述	将指定字符串的所有字符修改为小写
例子	lower('HELLO')，返回：'hello'

ltrim

语法	ltrim(s1, s2)
参数说明	1. 字符串类型参数； 2. 指定要删除的字符串
返回值类型	字符串
描述	从s1字符串起始位置查找与s2字符串相同的内容，当内容与s2字符串不符时停止查找，并删除查找到的内容。示例：ltrim('abcbabca','ab')，返回结果为 cbabca
例子	ltrim('abcbabca','ab')，返回：'cbabca'

position

语法	position(S,PATTERN)
参数说明	1. 要搜索的字符串； 2. 子字符串
返回值类型	数字
描述	获取子字符串在指定字符串中第一次出现的位置
例子	position('hello world', 'world')，返回：7

regexp_extract

语法	regexp_extract(s, regexp, index)
参数说明	1. 字符串类型参数； 2. 正则表达式，可选类型：字符串； 3. 需要的字符串索引，可选类型：数字
返回值类型	字符串
描述	将字符串s按照正则表达式regexp的规则拆分，返回index指定的字符
例子	regexp_extract('hello123world', '(\d+)', 1)，返回：'123'
不支持的数据源	无（支持的数据源:Athena、Doris、Postgresql、Spark、Hive、Hologres、Impala、Presto）

regexp_match

语法	regexp_match(s, regexp)
参数说明	1. 字符串类型参数； 2. 正则表达式，可选类型：字符串
返回值类型	布尔
描述	判断字符串s是否匹配正则表达式regexp模式。匹配成功返回TRUE，匹配失败返回FALSE
例子	regexp_match('hello123', '\d+')，返回：TRUE

regexp_replace

语法	regexp_replace(s, regexp, replacement)
参数说明	1. 字符串类型参数； 2. 正则表达式，可选类型：字符串； 3. 新的字符串
返回值类型	字符串类型
描述	将字符串s中匹配正则表达式regexp的字符替换为指定字符串replacement
例子	regexp_replace('hello123world', '\d+', '')，返回：'helloworld'

replace

语法	replace(s,s1,s2)
参数说明	1. 字符串类型参数； 2. 原来的字符串； 3. 新的字符串
返回值类型	字符串
描述	替换字符串。用法 replace(s, s1, s2)，s2替换s中出现的所有s1
例子	replace('hello world', 'world', 'there')，返回：'hello there'

rtrim

语法	rtrim(s1, s2)
参数说明	1. 字符串类型参数； 2. 指定要删除的字符串
返回值类型	字符串
描述	从s1字符串结束位置开始往前查找与s2字符串相同的内容，当内容与s2字符串不符时停止查找，并删除查找到的内容。示例：rtrim('abadcdabab','ab')返回值为 abadcd
例子	rtrim('abadcdabab','ab')，返回：'abadcd'

split

语法	split(s, delimiter, n)
参数说明	1. 字符串类型参数； 2. 分隔符，可选类型：字符串； 3. 需要的字符串索引，可选类型：数字
返回值类型	字符串
描述	将字符串s按分隔符delimiter切分，并返回切分后的第n个（n从1开始）字符串。如 split('abc,abc,abcdef',',',3)，返回字符串是 abcdef
例子	split('abc,abc,abcdef',',',3)，返回：'abcdef'

to_string

语法	to_string(ARG)
参数说明	任意类型的参数
返回值类型	字符串
描述	把输入的字段或者值转换成字符串
例子	to_string(123)，返回：'123'

trim

语法	trim(S)
参数说明	字符串类型参数
返回值类型	字符串
描述	去掉字符串首尾的空格
例子	trim(' hello ')，返回：'hello'

upper

语法	upper(S)
参数说明	字符串类型参数
返回值类型	字符串
描述	将指定字符串的所有字符修改为大写
例子	upper('hello')，返回：'HELLO'

unlike

语法	unlike(S,LITERAL_PATTERN)
参数说明	1. 字符串类型参数； 2. 指定模式，可选类型：字符串
返回值类型	布尔
描述	指定字段不包含特定字符串
例子	unlike('hello world', 'test')，返回：TRUE

unlike_ci

语法	unlike_ci(S,LITERAL_PATTERN)
参数说明	1. 字符串类型参数； 2. 指定模式，可选类型：字符串
返回值类型	布尔
描述	指定字段不包含特定字符串，不区分大小写
例子	unlike_ci('hello world', 'HE')，返回：FALSE