阿里云日志服务SLS正则表达式函数-云淘科技

函数列表

regex_select

根据正则表达式提取符合条件的值。

• 函数格式

  regex_select(value, r"regular expression", mi=None, gi=None)

• 参数说明

  参数名称	参数类型	是否必填	说明
  value	任意	是	填入要匹配的值。
  regular expression	String	是	匹配的正则表达式。
  mi	int	否	表示匹配到的第几个表达式，默认None和0，表示第一个。
  gi	int	否	表示匹配到的第几个分组，默认None和0，表示第一个。

• 返回结果

  返回提取的值。

• 函数示例

  • 示例1：提取字段str中符合正则表达式的第一个值。
    • 原始日志

      str: iZbp1a65x3r1vhpe94fi2qZ

    • 加工规则

      e_set("regex", regex_select(v("str"), r"\d+"))
      e_set("regex2", regex_select(v("str"), r"\d+", mi=None))
      e_set("regex3", regex_select(v("str"), r"\d+", mi=0))

    • 加工结果

      regex:1
      regex2:1
      regex3:1
      str:iZbp1a65x3r1vhpe94fi2qZ

  • 示例2：提取字段str中符合正则表达式的第一个和第二个的值。
    • 原始日志

      str: abc123 xyz456

    • 加工规则

      # 提取字段str中符合正则表达式的第一个值。
      e_set("regex", regex_select(v("str"), r"\d+"))
      # 提取字段str中符合正则表达式的第二个值。
      e_set("regex2", regex_select(v("str"), r"\d+", mi=1))

    • 加工结果

      regex:   123
      regex2:  456
      str: abc123 xyz456

  • 示例3
    • 原始日志

      str: abc123 xyz456

    • 加工规则

      # 提取字段str中符合正则表达式的第一个表达式的第一个分组的值。
      e_set("regex", regex_select(v("str"),r"[a-z]+(\d+)",gi=0))
      # 提取字段str中符合正则表达式的第二个表达式的第一个分组的值。
      e_set("regex2", regex_select(v("str"),r"[a-z]+(\d+)",mi=1,gi=0))
      # 提取字段str中符合正则表达式的第一个表达式的第一个分组的值。
      e_set("regex3", regex_select(v("str"),r"([a-z]+)(\d+)",gi=0))
      # 提取字段str中符合正则表达式的第一个表达式的第二个分组的值。
      e_set("regex4", regex_select(v("str"),r"([a-z]+)(\d+)",gi=1))

    • 加工结果

      str: abc123 xyz456
      regex:   123
      regex2:  456
      regex3:  abc
      regex4:  123

regex_findall

根据正则表达式获得符合条件的所有值的一个列表。

• 函数格式

  regex_findall(value, r"regular expression")

• 参数说明

  参数名称	参数类型	是否必填	说明
  value	任意	是	要匹配的值。
  regular expression	String	是	正则表达式。

• 返回结果

  返回获得符合条件的列表。

• 函数示例

  获取字段str所有的数字。

  • 原始日志

    str: iZbp1a65x3r1vhpe94fi2qZ

  • 加工规则

    e_set("regex_findall", regex_findall(v("str"),r"\d+"))

  • 加工结果

    str: iZbp1a65x3r1vhpe94fi2qZ
    regex_findall:  ["1", "65", "3", "1", "94", "2"]

regex_match

判断是否匹配正则表达式。

• 函数格式

  regex_match(value, r"regular expression", full=False)

• 参数说明

  参数名称	参数类型	是否必填	说明
  value	任意	是	要匹配的值。
  regular expression	String	是	正则表达式。
  full	Bool	否	是否完全匹配，默认为False。

• 返回结果

  返回True或者False。

• 函数示例

  判断字段str是否包含数字。

  • 原始日志

    str: iZbp1a65x3r1vhpe94fi2qZ

  • 加工规则

    # 判断字段str是否包含数字。
    e_set("regex_match", regex_match(v("str"),r"\d+"))
    # 判断字段str是否全部为数字。
    e_set("regex_match2", regex_match(v("str"),r"\d+",full=True))

  • 加工结果

    str: iZbp1a65x3r1vhpe94fi2qZ
    regex_match:  True
    regex_match2:  False

regex_replace

根据正则表达式替换字符串中的指定字符。

• 函数格式

  regex_replace(value, r"regular expression", replace="", count=0)

• 参数说明

  参数名称	参数类型	是否必填	说明
  value	任意	是	要被替换的值。
  regular expression	String	是	正则表达式。
  replace	String	否	替换后的新字符。默认为空，表示删除字符。 支持正则表达式，例如r"\1****\2"，表示替换后的字符串要满足该正则表达式。 \1代表第一个分组。 \2代表第二个分组。
  count	Number	否	替换次数。 默认为0，表示替换所有。

• 返回结果

  返回替换后的新字符串。

• 函数示例

  • 示例1：把str中的所有数字用13替换。
    • 原始日志

      str: iZbp1a65x3r1vhpe94fi2qZ
      replace: 13

    • 加工规则

      e_set("regex_replace", regex_replace(v("str"),r"\d+",v("replace")))

    • 加工结果

      str: iZbp1a65x3r1vhpe94fi2qZ
      replace: 13
      regex_replace:  iZbp13a13x13r13vhpe13fi13qZ

  • 示例2：对手机号中间4位数字进行脱敏处理。
    • 原始日志

      iphone: 13900001234

    • 加工规则

      e_set(
          "sec_iphone",
          regex_replace(v("iphone"), r"(\d{0,3})\d{4}(\d{4})", replace=r"\1****\2"),
      )

      
      说明

      • replace=r"\1****\2"表示替换后的字符串要满足正则表达式r"\1****\2"。
      • \1代表第一个分组，即(\d{0,3})。
      • \2代表第二个分组，即(\d{4})。
    • 加工结果

      iphone: 13900001234
      sec_iphone: 139****1234

regex_split

将一个字符串分割成字符串数组。

• 函数格式

  regex_split(value, r"regular expression", maxsplit=0)

• 参数说明

  参数名称	参数类型	是否必填	说明
  value	任意	是	要分裂的值。
  regular expression	String	是	正则表达式。
  maxsplit	int	否	最大分裂匹配次数。默认为0表示全部匹配分裂，如果为1，表示匹配中一个就分裂，剩余不再进行匹配。

• 返回结果

  返回分割后的数组列表。

• 函数示例

  将字段str按照数字进行分裂。

  • 原始日志

    str: iZbp1a65x3r1vhpe94fi2qZ

  • 加工规则

    e_set("regex_split", regex_split(v("str"),r"\d+"))

  • 加工结果

    str: iZbp1a65x3r1vhpe94fi2qZ
    regex_split:  ["iZbp", "a", "x", "r", "vhpe", "fi", "qZ"]