机器数据分析平台

  • 机器数据分析平台 > 产品手册 > SPL参考手册 > 字段处理 >convert

    convert

    最近更新时间:2020-04-01 15:39:02

    convert命令用于将搜索结果中的字段值转换为数值,通过as子句将转换后的值赋给新的字段。如果没有as子句,原始字段值会被转换后的值替换。

    语法:

    convert [timeformat=string] <convert-function>[as field])...

    参数说明:

    必填参数:

    • convert-function: 转换函数。函数的参数可以是某个字段,也支持参数为*, 参数为*的含义是该转换函数将作用于所有字段。目前支持以下9种转换函数autoctimedur2secmemkmktimemstimenonermcommarmunit。详情阅读下文【convert命令支持的转换函数】。

    选填参数:

    • timeformat:若果转换后的字段为时间字段,可通过timeformat指定字段的输出格式。timeformat参数用于ctimemktime转换函数中,mktime函数必须指定timeformat,ctime函数支持默认timeformt格式(yyyy-MM-dd HH:mm:ss)。

    • as field:将转换后的值放入指定的新字段中,原始字段和值保持不变。

    convert命令支持的转换函数

    函数 描述 示例
    auto() 自动使用最佳转换函数将字段中的值转换为数字;

    yyyy-MM-dd HH:mm:ssHH:mm:ss时间格式的字符串转换为Unix时间戳

    仅包含数字的字符串转换为数字

    包含数字前缀的字符串转换为数字(去掉数字后跟随的其他字符)
    convert auto(a) as aaa

    convert auto(*)

    convert auto("2018-12-30 12:34:56") as timestamp
    ctime() 将13位时间戳转换成指定timeformat的时间字段, timeformat支持形如yyyy-MM-dd HH:mm:ssHH:mm:ss的时间格式 convert timeformat="yyyy-MM-dd HH:mm:ss" ctime(*) none(h)
    dur2sec() 将形如HH:mm:ss的时间格式字符串转化为秒 convert dur2sec("12:14:05") as seconds
    memk() 将形如"xxx.k/m/g"(xxx可以是浮点数、整数,须为正数)形式的的字符串转换为以k/m/g结尾的数值。k代表kilobyte,m代表megabyte,g代表gigabyte convert memk(100.k)
    mktime() 将指定timeformat形式的字符串转换为13位时间戳 convert timeformat="HH:mm:ss" mktime(new)
    mstime() mm:ss形式的字符串转换为秒 convert mstime(20:30) none(m)
    none() 在转换所有字段的情况下,可使用none函数指定不需转换的字段 convert auto(*) none(a) none(b)
    rmcomma() 移除原始数字字符串中的逗号 convert rmcomma(100,200) none(m)
    rmunit() 移除以数字开头的字符串除数字之外的所有字符 convert rmunit(12dhu5) none(m)

    用法示例:

    1.将所有字段值转换为数值。

    ……| convert auto(*)
    

    2.转换除指定字段之外的所有字段值为数值。

    ……| convert auto(*) none(order)
    

    3.将指定字段的持续时间值更改为秒。

    ……| convert dur2sec(delay)
    

    4.对包含数值和字符串值的字段值通过移除值的字符串部分,转换为数值。例如,如果duration="30s",则结果值为duration="30"。本示例使用rmunit convert函数。

    ……| convert rmunit(duration)
    

    5.将UNIX时间转换为更易读的时间戳格式

    ……|convert timeformat="yyyy-MM-dd HH:mm:ss" ctime(_time)
    
    以上内容是否对您有帮助?
  • Icon free helper
    Close