单位换算函数

本文介绍日志服务支持的单位运算函数语法及常见场景的使用示例。

函数列表

CONVERT_DATA_SIZE 函数

CONVERT_DATA_SIZE 函数用于对数据量单位进行换算。

函数语法

• 语法格式

  • 系统自动判断最优的换算单位，换算数据量的单位。

    CONVERT_DATA_SIZE(KEY)
    

  • 使用指定的换算单位，换算数据量的单位。

    CONVERT_DATA_SIZE(KEY, unit)
    

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 String 类型。
  unit	数据的存储单位，可选值为 KB、MB、GB、PB、TB、EB、ZB、YB。

• 返回值说明
  返回值为 String 类型。

函数示例

• 示例1

  • 场景
    将 100,000 KB 换算为使用系统最优单位表示的数据量。

  • 检索和分析语句

    * | SELECT CONVERT_DATA_SIZE('100000KB')
    

  • 检索和分析结果
    

• 示例2

  • 场景
    将 100,000 KB 换算为 GB 单位的数据量。
  • 检索和分析语句

    * | SELECT CONVERT_DATA_SIZE('100000KB', 'GB')
    

• 检索和分析结果

  

FORMAT_DATA_SIZE 函数

FORMAT_DATA_SIZE 函数使用指定单位换算 Byte 单位的数据量。

函数语法

• 语法格式

  FORMAT_DATA_SIZE(KEY, unit)
  

• 参数说明

  参数	说明
  KEY	日志字段、表达式，其值为 Bigint 类型，单位为 Byte。
  unit	数据的存储单位，可选值为 KB、MB、GB、PB、TB、EB、ZB、YB。

• 返回值说明
  返回值为 String 类型。

函数示例

• 场景
  ReqSize字段值的单位为 Byte，使用 FORMAT_DATA_SIZE 函数换算为 KB 单位。

• 日志样例
  

• 检索和分析语句

  * | SELECT FORMAT_DATA_SIZE(4096, 'KB')
  

• 检索和分析结果
  

PARSE_DATA_SIZE 函数

PARSE_DATA_SIZE 函数用于将数据量的单位换算为 Byte。

函数语法

• 语法格式

  PARSE_DATA_SIZE(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 String 类型。

• 返回值说明
  返回值为 Decimal 类型。

函数示例

• 场景
  将 1 KB换算为以 Byte 为单位的值。

• 检索和分析语句

  *| SELECT PARSE_DATA_SIZE('1KB')
  

• 检索和分析结果
  

TO_DATA_SIZE_B 函数

TO_DATA_SIZE_B 函数用于将数据量的单位换算为 Byte。

函数语法

• 语法格式

  TO_DATA_SIZE_B(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 String 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将 1 KB换算为以 Byte 为单位的值。

• 检索和分析语句

  * | SELECT TO_DATA_SIZE_B('1KB')
  

• 检索和分析结果
  

TO_DATA_SIZE_KB 函数

TO_DATA_SIZE_KB 函数用于将数据量的单位换算为 KB。

函数语法

• 语法格式

  TO_DATA_SIZE_KB(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 String 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将 2048MB 换算为以 KB 为单位的值。

• 检索和分析语句

  * | SELECT TO_DATA_SIZE_KB('2048MB')
  

• 检索和分析结果

  

TO_DATA_SIZE_MB 函数

TO_DATA_SIZE_MB 函数用于将数据量单位换算为 MB。

函数语法格式

• 语法格式

  TO_DATA_SIZE_MB(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 String 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将 1024GB 换算为以 MB 为单位的值。

• 检索和分析语句

  * | SELECT TO_DATA_SIZE_MB('1024GB')
  

• 检索和分析结果

  

TO_DATA_SIZE_GB 函数

TO_DATA_SIZE_GB 函数用于将数据量单位换算为 GB。

函数语法

• 语法格式

  TO_DATA_SIZE_GB(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 String 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将 1024TB 换算为以 GB 为单位的值。

• 检索和分析语句

  * | SELECT TO_DATA_SIZE_GB('1024TB')
  

• 检索和分析结果
  

TO_DATA_SIZE_TB 函数

TO_DATA_SIZE_TB 函数用于将数据量单位换算为 TB 。

函数语法

• 语法格式

  TO_DATA_SIZE_TB(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 String 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将 1024PB 换算为以 TB 为单位的值。

• 检索和分析语句

  * | SELECT TO_DATA_SIZE_TB('1024PB')
  

• 检索和分析结果

  

TO_DATA_SIZE_PB 函数

TO_DATA_SIZE_PB 函数用于将数据量单位换算为 PB。

函数语法

• 语法格式

  TO_DATA_SIZE_PB(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 String 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将 1048576TB 换算为以 PB 为单位的值。

• 检索和分析语句

  * | SELECT TO_DATA_SIZE_PB('1048576TB')
  

• 检索和分析结果
  

FORMAT_DURATION 函数

FORMAT_DURATION 函数用于将以秒为单位的时间间隔格式化为 xx weeks, xx days, xx hours, xx minutes, xx seconds 格式。

函数语法

• 语法格式

  FORMAT_DURATION(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 Double 类型。

• 返回值说明
  返回值为 String 类型。

函数示例

• 场景
  格式化时间间隔 4200000 秒。

• 检索和分析语句

  * | SELECT FORMAT_DURATION(4200000)
  

• 检索和分析结果
  

PARSE_DURATION 函数

PARSE_DURATION函数用于将时间间隔格式化为0 00:00:00.000格式。

函数语法

• 语法格式

  PARSE_DURATION(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 String 类型。

• 返回值说明
  返回值为 String 类型。

函数示例

• 场景
  将 120,000 秒转换为 1 09:20:00.000 格式。

• 检索和分析语句

  * | SELECT PARSE_DURATION('120000s')
  

• 检索和分析结果
  

TO_DAYS 函数

TO_DAYS 函数用于将时间间隔的单位换算为天。

函数语法

• 语法格式

  TO_DAYS(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 Varchar 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将 360,000s 转换为以天为单位的时间间隔。

• 检索和分析语句

  *| SELECT TO_DAYS('360000s')
  

• 检索和分析结果
  

TO_MILLISECONDS 函数

TO_MILLISECONDS 函数用于将时间间隔的单位换算为以毫秒。

函数语法

• 语法格式

  TO_MILLISECONDS(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 Varchar 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将 10 秒转换为以毫秒为单位的时间间隔。

• 检索和分析语句

  * | SELECT TO_MILLISECONDS('10s')
  

• 检索和分析结果
  

TO_MINUTES 函数

TO_MINUTES 函数用于将时间间隔单位转换为分钟。

函数语法

• 语法格式

  TO_MINUTES(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 Varchar 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将 10 小时转换为以分钟为单位的时间间隔。

• 检索和分析语句

  * | SELECT TO_MINUTES('10h')
  

• 检索和分析结果
  

TO_MOST_SUCCINCT_TIME_UNIT 函数

TO_MOST_SUCCINCT_TIME_UNIT 函数使用系统自动判断的最优换算单位对时间间隔进行换算。

函数语法

• 语法格式

  TO_MOST_SUCCINCT_TIME_UNIT(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 Varchar 类型。

• 返回值说明
  返回值为 Varchar 类型。

函数示例

• 场景
  将 1340ms 转换为以秒为单位的时间间隔。

• 检索和分析语句

  * | SELECT TO_MOST_SUCCINCT_TIME_UNIT('1340ms')
  

• 检索和分析结果

  

TO_SECONDS 函数

TO_SECONDS 函数用于对时间间隔单位转换为秒。

函数语法

• 语法格式

  TO_SECONDS(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 Varchar 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将1340毫秒转换为以秒为单位的时间间隔。

• 检索和分析语句

  * | SELECT TO_SECONDS('1340ms')
  

• 检索和分析结果

  

TO_NANOSECONDS 函数

TO_NANOSECONDS 函数用于将时间间隔单位转换为纳秒。

函数语法

• 语法格式

  TO_NANOSECONDS(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 Varchar 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将125毫秒转换为以纳秒为单位的时间间隔。

• 检索和分析语句

  * | SELECT TO_NANOSECONDS('125ms')
  

• 检索和分析结果

  

TO_MICROSECONDS 函数

TO_MICROSECONDS 函数用于将时间间隔单位转换为微秒。

函数语法

• 语法格式

  TO_MICROSECONDS(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 Varchar 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将 3600 纳秒转换为以微秒为单位的时间间隔。

• 检索和分析语句

  * | SELECT TO_MICROSECONDS('3600ns')
  

• 检索和分析结果

  

TO_HOURS 函数

TO_HOURS 函数用于将时间间隔单位转换为小时。

函数语法

• 语法格式

  TO_HOURS(KEY)
  

• 参数说明

  参数	说明
  KEY	字段、表达式，其值为 Varchar 类型。

• 返回值说明
  返回值为 Double 类型。

函数示例

• 场景
  将 1.2 天转换为以小时为单位的时间间隔。

• 检索和分析语句

  * | SELECT TO_HOURS('1.2d')
  

• 检索和分析结果