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

函数列表

BAR 函数

BAR 函数用于绘制一条 ANSI 条形图。

函数语法

• 语法格式

  • 绘制一条起始颜色为红色，结束颜色为绿色的 ANSI 条形图，其中 width 定义了整条 ANSI 条形图的宽度，然后通过 x 截取并返还其中一段条形图。

    BAR(x, width)
    

  • 绘制一条起始颜色和结束颜色为自定义颜色的 ANSI 条形图，其中 width 定义了整条 ANSI 条形图的宽度，然后通过 x 截取并返还其中一段条形图。

    BAR(x, width, low_color, high_color)
    

• 参数说明

  参数	说明
  x	用于指定返回的条形图占整条 ANSI 条形图的比例。参数值为 Double 类型，取值范围为 [0,1]。
  width	ANSI 条形图的宽度。
  low_color	起始颜色的 RGB 值。
  high_color	结束颜色的 RGB 值。

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

函数示例

• 场景
  绘制一个占比 50% 的 ANSI 条形图。

• 检索和分析语句

  * | SELECT BAR(0.5, 100)
  

• 检索和分析结果（控制台）
  

• 检索和分析结果（终端）
  

COLOR 函数

COLOR 函数用于返回目标值的颜色。

函数语法

• 语法格式

  • 将表示颜色的字符串转换为 Color 类型。

    COLOR(string)
    

  • 通过判断 x 在 low 和 high 之间的占比来指定 low_color 和 high_color 的份量，然后返回一个混合后的颜色。

    COLOR(x, low, high, low_color, high_color)
    

  • 通过 y 指定 low_color 和 high_color 的份量，然后返回一个混合后的颜色。

    COLOR(y, low_color, high_color)
    

• 参数说明

  参数	说明
  x	值为 Double类型。
  y	值为 Double 类型，取值范围为 [0,1]。
  low	最小值，值为 Double 类型。
  high	最大值，值为 Double 类型。
  low_color	起始颜色的 RGB 值。
  high_color	结束颜色的 RGB 值。
  string	字符串，可选值为 black、red、green、yellow、blue、magenta、cyan、white 或 CSS 样式的 RGB 值（例如 #000）。

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

函数示例

• 示例1

  • 场景
    将颜色字符串转换为 Color 类型。

  • 检索和分析语句

    * | SELECT COLOR('#000')
    

  • 检索和分析结果
    

• 示例2

  • 场景
    根据指定比例获取颜色。

  • 检索和分析语句

    *|SELECT COLOR(5, 0, 10, RGB(255,0,0), RGB(0,255,0))
    

  • 检索和分析结果
    

RENDER 函数

RENDER 函数使用颜色渲染返回结果。

函数语法

• 语法格式

  • 使用默认的颜色渲染返回结果。布尔表达式为真时，返回绿色勾；否则返回红色叉。

    RENDER(boolean expression)
    

  • 使用自定义的颜色渲染返回结果。

    RENDER(x, color)
    

• 参数说明

  参数	说明
  boolean expression	布尔表达式。
  x	X 坐标，值为 Integer 类型。
  color	颜色，值为 Color 类型。

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

函数示例

• 示例1

  • 场景
    通过 RENDER 函数判断count(*) 值是否小于 1000。如果小于，则返回绿色勾。

  • 检索和分析语句

    * | SELECT RENDER(count(*)<1000)
    

  • 检索和分析结果（控制台）
    

  • 检索和分析结果（终端）
    

RGB 函数

RGB 函数通过指定的 RGB 值返回一个颜色值。

函数语法

• 语法格式

  RGB(red, green, blue)
  

• 参数说明

  参数	说明
  red	指定红色份量，取值范围为 [0,255]，值为 integer 类型。
  green	指定绿色份量，取值范围为 [0,255]，值为 integer 类型。
  blue	指定蓝色份量，取值范围为 [0,255]，值为 integer 类型。

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

函数示例

• 场景
  根据 RGB 值返回一个颜色。

• 检索和分析语句

  *|SELECT RGB(255,0,0)
  

• 检索和分析结果