文档

字符串函数

更新时间:

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

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

重要 在日志服务分析语句中,表示字符串的字符必须使用单引号('')包裹,无符号包裹或被双引号("")包裹的字符表示字段名或列名。例如:'status'表示字符串status,status"status"表示日志字段status。

函数名称

语法

说明

支持SQL

支持SPL

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:14/Jul/2021:02:19:40
  • 查询和分析语句(调试

    * | SELECT
      concat(region, '-', time)
  • 查询和分析结果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开始。如果字符串中不存在目标子串,则返回0。

示例

查询子串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个字符。

rpad_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字段的值并返回第一个子串(即文件路径部分),然后统计不同路径对应的请求数量。

  • 字段样例

    request_uri: /request/path-2/file-6?name=value&age=18
    request_uri: /request/path-2/file-0?name=value&age=18
    request_uri: /request/path-3/file-2?name=value&age=18
  • 查询和分析语句(调试

    * | SELECT
      count(*) AS PV,
      split_part(request_uri, '?', 1) AS Path
    GROUP BY
      Path
    ORDER BY
      pv DESC
  • 查询和分析结果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开始。如果字符串中不存在目标子串,则返回0。

示例

返回字母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函数

  • 本页导读 (1)