本文介绍字符串函数的基本语法和示例。

日志服务支持如下字符串函数。

注意 在日志服务分析语句中,表示字符串的字符必须使用单引号('')包裹,无符号包裹或被双引号("")包裹的字符表示字段名或列名。例如:'status'表示字符串status,status"status"表示日志字段status。
函数名称 语法 说明
chr函数 chr(x) 将ASCII码转换为字符。
codepoint函数 codepoint(x) 将字符转换为ASCII码。
concat函数 concat(x, y...) 将多个字符串拼接成一个字符串。
from_utf8函数 from_utf8(x) 将二进制字符串解码为UTF-8编码格式,并使用默认字符U+FFFD替换无效的UTF-8字符。
from_utf8(x, replace_string) 将二进制字符串解码为UTF-8编码格式,并使用自定义字符串替换无效的UTF-8字符。
length函数 length(x) 计算字符串的长度。
levenshtein_distance函数 levenshtein_distance(x, y) 计算xy之间的最小编辑距离。
lower函数 lower(x) 将字符串转换为小写形式。
lpad函数 lpad(x, length, lpad_string) 在字符串的开头填充指定字符,直到指定长度后返回结果字符串。
ltrim函数 ltrim(x) 删除字符串开头的空格。
normalize函数 normalize(x) 使用NFC格式将字符串格式化。
position函数 position(sub_string in x) 返回目标子串在字符串中的位置。
replace函数 replace(x, sub_string ) 删除字符串中匹配的字符。
replace(x, sub_string, replace_string) 将字符串中所匹配的字符替换为其他指定字符。
reverse函数 reverse(x) 返回反向顺序的字符串。
rpad函数 rpad(x, length, rpad_string) 在字符串的尾部填充指定字符,直到指定长度后返回结果字符串。
rtrim函数 rtrim(x) 删除字符串中结尾的空格。
split函数 split(x, delimeter) 使用指定的分隔符拆分字符串,并返回子串集合。
split(x, delimeter, limit) 通过指定的分隔符拆分字符串并使用limit限制字符串拆分的个数,然后返回拆分后的子串集合。
split_part函数 split_part(x, delimeter, part) 使用指定的分隔符拆分字符串,并返回指定位置的内容。
split_to_map函数 split_to_map(x, delimiter01, delimiter02) 使用指定的第一个分隔符拆分字符串,然后再使用指定的第二个分隔符进行第二次拆分。
strpos函数 strpos(x, sub_string) 返回目标子串在字符串中的位置。与position(sub_string in x)函数等价。
substr函数 substr(x, start) 返回字符串中指定位置的子串。
substr(x, start, length) 返回字符串中指定位置的子串,并指定子串长度。
to_utf8函数 to_utf8(x) 将字符串转换为UTF-8编码格式。
trim函数 trim(x) 删除字符串中开头和结尾的空格。
upper函数 upper(x) 将字符串转化为大写形式。

chr函数

CHR函数用于将ASCII码转换为字符。

语法

chr(x)

参数说明

参数 说明
x ASCII码。

返回值类型

varchar类型。

示例

判断region字段值的首字母是否是c开头,其中99为ASCII码,代表小写字母c。
  • 字段样例
    region:cn-shanghai
  • 查询和分析语句
    * | SELECT substr(region, 1, 1)=chr(99)
  • 查询和分析结果chr

codepoint函数

codepoint函数用于将字符转换为ASCII码。

语法

codepoint(x)

参数说明

参数 说明
x 参数值为varchar类型。

返回值类型

integer类型。

示例

判断region字段值的首字母是否是c开头,其中99为ASCII码,代表小写字母c。
  • 字段样例
    upstream_status:200
  • 查询和分析语句
    * | SELECT codepoint(cast (substr(region, 1, 1) AS char(1))) =99
  • 查询和分析结果codepoint

concat函数

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

语法

concat(x, y...)

参数说明

参数 说明
x 参数值为varchar类型。
y 参数值为varchar类型。

返回值类型

varchar类型。

示例

region字段和request_method字段的值拼接为一个字符串。
  • 字段样例
    region:cn-shanghai
    time_local:14/Jul/2021:02:19:40
  • 查询和分析语句
    * | SELECT concat(region,'-',time_local)
  • 查询和分析结果concat函数

from_utf8函数

from_utf8函数用于将二进制字符串解码为UTF-8编码格式。

语法

  • 使用默认字符U+FFFD替换无效的UTF-8字符。
    from_utf8(x)
  • 使用自定义字符替换无效的UTF-8字符。
    from_utf8(x,replace_string)

参数说明

参数 说明
x 参数值为binary类型。
replace_string 用于替换的字符串。只能为单个字符或空格。

返回值类型

varchar类型。

示例

  • 将二进制字符串0x80解码为UTF-8编码格式,并使用默认字符U+FFFD替换返回结果中无效的UTF-8字符。U+FFFD显示形式为�。
    • 查询和分析语句
      * | SELECT from_utf8(from_base64('0x80'))
    • 查询和分析结果from_utf8
  • 将二进制字符串0x80解码为UTF-8编码格式,并使用0替换返回结果中无效的UTF-8字符。
    • 查询和分析语句
      * | SELECT from_utf8(from_base64('0x80'),'0')
    • 查询和分析结果from_utf8

length函数

length函数用于计算字符串的长度。

语法

length(x)

参数说明

参数 说明
x 参数值为varchar类型。

返回值类型

bigint类型。

示例

计算http_user_agent字段值的长度。
  • 字段样例
    http_user_agent:Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.2 (KHTML, like Gecko) Chrome/22.0.1216.0 Safari/537.2
  • 查询和分析语句
    * | SELECT length(http_user_agent)
  • 查询和分析结果length函数

levenshtein_distance函数

levenshtein_distance函数用于计算两个字符串的最小编辑距离。

语法

levenshtein_distance(x, y)

参数说明

参数 说明
x 参数值为varchar类型。
y 参数值为varchar类型。

返回值类型

bigint类型。

示例

查询instance_id字段值和owner_id字段值的最小编辑距离。
  • 字段样例
    instance_id:i-01
    owner_id:owner-01
  • 查询和分析语句
    * | SELECT levenshtein_distance(owner_id,instance_id)
  • 查询和分析结果levenshtein_distance

lower函数

lower函数用于将字符串转换为小写形式。

语法

lower(x)

参数说明

参数 说明
x 参数值为varchar类型。

返回值类型

varchar类型。

示例

request_method字段的值转换为小写形式。
  • 字段样例
    request_method:GET
  • 查询和分析语句
    * | SELECT lower(request_method)
  • 查询和分析结果lower函数

lpad函数

lpad函数用于在目标字符串的开头填充指定的字符,直到指定长度后返回结果字符串。

语法

lpad(x, length, lpad_string)

参数说明

参数 说明
x 参数值为varchar类型。
length 整数,用于指定结果字符串的长度。
  • 当字符串的长度小于length时,在字符串的开头填充指定的字符。
  • 当字符串的长度大于length时,只返回字符串中的length个字符。
lpad_string 新填充的字符。

返回值类型

varchar类型。

示例

instance_id字段值的长度补充到10位,不足10位时,在字段值的开头补充0。
  • 字段样例
    instance_id:i-01
  • 查询和分析语句
    * | SELECT lpad(instance_id,10,'0')
  • 查询和分析结果lpad

ltrim函数

ltrim函数用于删除字符串中开头的空格。

语法

ltrim(x)

参数说明

参数 说明
x 参数值为varchar类型。

返回值类型

varchar类型。

示例

删除region字段值开头的空格。
  • 字段样例
    region: cn-shanghai
  • 查询和分析语句
    * | SELECT ltrim(region)
  • 查询和分析结果ltrim

normalize函数

normalize函数使用NFC格式将字符串格式化。

语法

normalize(x)

参数说明

参数 说明
x 参数值为varchar类型。

返回值类型

varchar类型。

示例

使用NFC格式将字符串schön格式化。

  • 查询和分析语句
    * | SELECT normalize('schön')
  • 查询和分析结果normalize

position函数

position函数用于查询目标子串在字符串中的位置。

语法

position(sub_string in x)

参数说明

参数 说明
sub_string 目标子串。
x 参数值为varchar类型。

返回值类型

int类型,从1开始。

示例

查询子串cnregion字段值中位置。
  • 字段样例
    region:cn-shanghai
  • 查询和分析语句
    * | SELECT position('cn' in region)
  • 查询和分析结果position函数

replace函数

replace函数用于删除字符串中所匹配的字符或者将字符串中所匹配的字符替换为其他指定字符。

语法

  • 删除字符串中所匹配的字符。
    replace(x, sub_string)
  • 将字符串中所匹配的字符替换为其他指定字符。
    replace(x, sub_string, replace_string)

参数说明

参数 说明
x 参数值为varchar类型。
sub_string 目标子串。
replace_string 用于替换的子串。

返回值类型

varchar类型。

示例

  • 示例1:将region字段值中的cn替换为中国
    • 字段示例
      region:cn-shanghai
    • 查询和分析语句
      * | select replace(region,'cn','中国')
    • 查询和分析结果replace
  • 示例2:删除region字段值中的cn-
    • 字段示例
      region:cn-shanghai
    • 查询和分析语句
      * | select replace(region,'cn-')
    • 查询和分析结果replace

reverse函数

reverse函数用于返回反向顺序的字符串。

语法

reverse(x)

参数说明

参数 说明
x 参数值为varchar类型。

返回值类型

varchar类型。

示例

request_method字段值反向排序。
  • 字段样例
    request_method:GET
  • 查询和分析语句
    * | SELECT reverse(request_method)
  • 查询和分析结果reverse

rpad函数

rpad函数用于在字符串的尾部填充指定的字符,直到指定长度后返回结果字符串。

语法

rpad(x, length, rpad_string)

参数说明

参数 说明
x 参数值为varchar类型。
length 整数,用于指定结果字符串的长度。
  • 当字符串的长度小于length时,在字符串的尾部填充指定的字符。
  • 当字符串的长度大于length时,只返回字符串中的length个字符。
lpad_string 新填充的字符。

返回值类型

varchar类型。

示例

instance_id字段值的长度补充到10位,不足10位时,在字段值的尾部补充0。
  • 字段样例
    instance_id:i-01
  • 查询和分析语句
    * | SELECT rpad(instance_id,10,'0')
  • 查询和分析结果rpad

rtrim函数

rtrim函数用于删除字符串中结尾的空格。

语法

rtrim(x)

参数说明

参数 说明
x 参数值为varchar类型。

返回值类型

varchar类型。

示例

删除instance_id字段值中结尾的空格。
  • 字段样例
    instance_id:i-01 
  • 查询和分析语句
    * | SELECT rtrim(instance_id)
  • 查询和分析结果rtrim

split函数

split函数用于通过指定的分隔符拆分字符串,并返回拆分后的子串集合。

语法

  • 通过指定的分隔符拆分字符串,并返回拆分后的子串集合。
    split(x, delimeter)
  • 通过指定的分隔符拆分字符串并使用limit限制字符串拆分的个数,然后返回拆分后的子串集合。
    split(x,delimeter,limit)

参数说明

参数 说明
x 参数值为varchar类型。
delimeter 分隔符。
limit 限制字符串拆分的个数,大于0的整数。

返回值类型

array类型。

示例

  • 示例1:使用正斜线(/)将request_uri字段的值拆分成4个子串,并返回子串的集合。
    • 字段样例
      request_uri:/request/path-1/file-9
    • 查询和分析语句
      * | SELECT split(request_uri,'/')
    • 查询和分析结果split
  • 示例2:使用正斜线(/)将request_uri字段的值拆分成3个子串,并返回子串的集合。
    • 字段样例
      request_uri:/request/path-1/file-9
    • 查询和分析语句
      * | SELECT split(request_uri,'/',3)
    • 查询和分析结果split

split_part函数

split_part函数通过指定的分隔符拆分字符串,并返回指定位置的内容。

语法

split_part(x, delimeter, part)

参数说明

参数 说明
x 参数值为varchar类型。
delimeter 分隔符。
part 大于0的整数。

返回值类型

varchar类型。

示例

使用英文问号(?)拆分request_uri字段的值并返回第一个子串(即文件路径部分),然后统计不同路径对应的请求数量。
  • 查询和分析语句
    * | SELECT count(*) AS PV, split_part(request_uri, '?', 1) AS Path GROUP BY Path ORDER BY pv DESC LIMIT 3
  • 查询和分析结果TOP3访问地址

split_to_map函数

split_to_map函数用于使用指定的第一个分隔符拆分字符串,然后再使用指定的第二个分隔符进行第二次拆分。

语法

split_to_map(x, delimiter01, delimiter02)

参数说明

参数 说明
x 参数值为varchar类型。
delimeter01 分隔符。
delimeter02 分隔符。

返回值类型

map类型。

示例

使用英文逗号(,)和英文冒号(:)拆分time字段的值,返回结果为MAP类型。
  • 字段样例
    time:upstream_response_time:"80", request_time:"40"
  • 查询和分析语句
    * | SELECT split_to_map(time,',',':')
  • 查询和分析结果split_to_map

strpos函数

strpos函数用于返回目标子串在字符串中的位置。与position函数等价。

语法

strpos(x, sub_string)

参数说明

参数 说明
x 参数值为varchar类型。
sub_string 目标子串。

返回值类型

int类型,从1开始。

示例

返回字母H在server_protocol字段值中的位置。
  • 查询和分析语句
    * | SELECT strpos(server_protocol,'H')
  • 查询和分析结果strpos

substr函数

substr函数用于返回字符串中指定位置的子串。

语法

  • 返回字符串中指定位置的子串。
    substr(x, start)
  • 返回字符串中指定位置的子串,并指定子串长度。
    substr(x,start,length)

参数说明

参数 说明
x 参数值为varchar类型。
start 开始提取子串的位置,从1开始。
length 子串的长度。

返回值类型

varchar类型。

示例

提取server_protocol字段值中的前4个字符(即HTTP部分),然后统计HTTP协议对应的请求数量。
  • 字段样例
    server_protocol:HTTP/2.0
  • 查询和分析语句
    * | SELECT substr(server_protocol,1,4) AS protocol, count(*) AS count GROUP BY server_protocol
  • 查询和分析结果substr

to_utf8函数

to_utf8函数用于将字符串转换为UTF-8编码格式。

语法

to_utf8(x)

参数说明

参数 说明
x 参数值为varchar类型。

返回值类型

varbinary类型。

示例

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

  • 查询和分析语句
    * | SELECT to_utf8('log')
  • 查询和分析结果to_utf8

trim函数

trim函数用于删除字符串中开头和结尾的空格。

语法

trim(x)

参数说明

参数 说明
x 参数值为varchar类型。

返回值类型

varchar类型。

示例

删除instance_id字段值的开头和结尾的空格。

  • 字段样例
    instance_id: i-01 
  • 查询和分析语句
    * | SELECT trim(instance_id)
  • 查询和分析结果rtrim

upper函数

upper函数用于将目标字符串转化为大写形式。

语法

upper(x)

参数说明

参数 说明
x 参数值为varchar类型。

返回值类型

varchar类型。

示例

region字段值转换为大写形式。
  • 字段样例
    region:cn-shanghai
  • 查询和分析语句
    * | SELECT upper(region)
  • 查询和分析结果upper函数