字符串函数

函数列表

lpad函数

在字符串的开头填充指定字符，直到指定长度后返回结果字符串。如果未指定填充字符，则使用“ ”进行填充。

语法：lpad(str, len, lpadStr)

返回值类型：String类型

示例：SELECT LPAD('hello world', 10), LPAD('hello', 10, 'e')

rpad函数

在字符串的结尾填充指定字符，直到指定长度后返回结果字符串。如果未指定填充字符，则使用“ ”进行填充。

语法：rpad(str, len, rpadStr)

返回值类型：String类型

示例：SELECT RPAD('hello world', 10), RPAD('hello', 10, 'e')

replace函数

将字符串中的匹配字符串替换成指定的字符串，如果未指定替换字符串，则将匹配的字符串从原来的字符串中删除。

语法：replace(str, subStr, replaceStr)

返回值类型：String类型

示例：SELECT REPLACE('hello world', 'o'), REPLACE('hello world', 'w', 'new w')

reverse函数

将字符串转换成反向顺序的字符串。

语法：reverse(str)

返回值类型：String类型

示例：SELECT REVERSE('hello world')

repeat函数

将字符串重复指定次数。

语法：repeat(str, num)

返回值类型：String类型

示例：SELECT REPEAT('hello world', 2), REPEAT('hello world', 0)

contains_string函数

判断字符串是否包含指定字符串。

语法：contains_string(str, containsStr)

返回值类型：Boolean类型

示例：SELECT CONTAINS_STRING('hello world', 'llo')

icontains_string函数

判断字符串是否不包含指定字符串。

语法：icontains_string(str, containsStr)

返回值类型：Boolean类型

示例：SELECT ICONTAINS_STRING('hello world', 'llo')

textcat函数

将两个字符串拼接起来，返回拼接后的结果。

语法：textcat(str1, str2)

返回值类型：String类型

示例：SELECT TEXTCAT('hello ', 'world')

btrim函数

删除字符串左右两侧的空格。

语法：btrim(str)

返回值类型：String类型

示例：SELECT BTRIM(' hello world ')

parse_long函数

将字符串转换成基于指定基数的Long型，如果未指定基数，则基于十进制对原始字符串进行转换。

语法：parse_long(str, radix)

返回值类型：Long类型

示例：SELECT PARSE_LONG('-1234', 8), PARSE_LONG('1234')

split函数

使用指定的分隔符拆分字符串，并返回子字符串的集合。如果设置了limit，则使用limit限制拆分字符串的数量。

语法：split(str, splitStr, limit)

返回值类型：ARRAYS<STRING>类型

示例：SELECT SPLIT('helloworld', 'o'), SPLIT('helloworld', 'o', 2)

split_part函数

使用指定的分隔符拆分字符串，并返回指定位置的字符串。如果拆分后指定的位置超过数组的长度，则返回“”。

语法：split_part(str, splitStr, position)

返回值类型：STRING类型

示例：SELECT SPLIT_PART('helloworld', 'o', 2), SPLIT_PART('helloworld', 'o', 4)

split_to_map函数

使用指定的第一个分隔符拆分字符串，然后使用指定的第二个分隔符第二次拆分字符串。返回第二次拆分后的结果。

语法：split_to_map(str, splitStr1, splitStr2)

返回值类型：ARRAY类型

示例：SELECT SPLIT_TO_MAP('upstream_response_time:123, request_time:456', ',', ':')

string_format函数

返回以Java的String.format方式格式化的字符串。

语法：string_format(str, Object... args)

返回值类型：String类型

示例：SELECT STRING_FORMAT('My name is %s and I am %d years old.', 'name', age)

• %d：Output integer.
• %f：Output floating point number.
• %s：Output character string.
• %n：Output newline character.
• %c：Output Characters
• %b：Output bool type
• %e：Output Exponential Type
• %tc：Output Date and time information
• %tF：Output format is YYY-MM-DD.
• %tr：Output in HH:MM:SS PM format

可以参考Java的String.format获取更多的细节。

strpos函数

查询目标子串初次出现在字符串中的位置，如果目标子串未出现在字符串中，则返回0。

语法：strpos(str, subStr)

返回值类型：Integer类型

示例：SELECT STRPOS('hello world', 'llo'), STRPOS('llo', 'hello world')

substr函数

使用起始位置和长度返回子字符串。如果没有长度参数，则返回从起始位置开始的整个字符串，同substring。

语法：substr(str, start, length)

返回值类型：String类型

示例：SELECT SUBSTR('helloworld', 5), SUBSTR('helloworld', 5, 3)

substring函数

使用起始位置和长度返回子字符串。如果没有长度参数，则返回从起始位置开始的整个字符串。

语法：substring(str, start, length)

返回值类型：String类型

示例：SELECT SUBSTRING('helloworld', 5), SUBSTRING('helloworld', 5, 3)

length函数

如果字符串表达式是字符数据类型，则返回输入的字符长度；否则，返回字符串表达式的字节长度（不小于位数除以8的最小整数）。

语法：length(str)

返回值类型：Integer类型

示例：SELECT LENGTH('HELLO WORLD')

char_length函数

与length函数功能一致，如果字符串表达式是字符数据类型，则返回输入的字符长度；否则，返回字符串表达式的字节长度（不小于位数除以8的最小整数）。

语法：char_length(str)

返回值类型：Integer类型

示例：SELECT CHAR_LENGTH('HELLO WORLD')

character_length函数

与length函数功能一致。

语法：character_length(str)

返回值类型：Integer类型

示例：SELECT CHARACTER_LENGTH('HELLO WORLD')

strlen函数

与length函数功能一致。

语法：strlen(str)

返回值类型：Integer类型

示例：SELECT STRLEN('HELLO WORLD')

levenshtein_distance函数

计算两个字符串str1和str2之间的最小编辑距离。

语法：levenshtein_distance(str1, str2)

返回值类型：Integer类型

示例：SELECT LEVENSHTEIN_DISTANCE('horse', 'ros')

normalize函数

格式化字符串str。

• 使用NFC格式格式化字符串str。

  语法：normalize(str)

• 使用给定格式格式化字符串str，支持的格式有NFC, NFD, NFKC, NFKD.

  语法：normalize(str, form)

返回值类型：String类型

示例：SELECT NORMALIZE('schön'), NORMALIZE('Henry \u2163', 'nfd')

to_utf8函数

将字符串转换为UTF-8编码格式。

语法：to_utf8(str)

返回值类型：Integer类型

示例：SELECT TO_UTF8('中')

chr函数

将ascii值转换成字符。

语法：chr(ascii)

返回值类型：String类型

示例：SELECT CHR(99)

concat函数

用于将多个参数拼接成一个字符串。

语法：concat(x, y...)

返回值类型：String类型

示例：select concat('1','+','1')