文档中心

日志服务

SQL 函数

颜色函数

颜色函数

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

函数列表

函数名称	函数语法	说明
BAR 函数	BAR(x, width)	绘制一条起始颜色为红色，结束颜色为绿色的 ANSI 条形图，其中 width 定义了整条 ANSI 条形图的宽度，然后通过 x 截取并返还其中一段条形图。
BAR 函数		BAR(x, width, low_color, high_color)	绘制一条起始颜色和结束颜色为自定义颜色的 ANSI 条形图，其中 width 定义了整条 ANSI 条形图的宽度，然后通过 x 截取并返还其中一段条形图。
COLOR 函数	COLOR(string)	将表示颜色的字符串转换为 Color 类型。
		COLOR(x, low, high, low_color, high_color)	通过判断 x 在 low 和 high 之间的占比来指定 low_color 和 high_color 的份量，然后返回一个混合后颜色。
		COLOR(y, low_color, high_color)	通过 y 指定 low_color 和 high_color 的份量，然后返回一个混合后的颜色。
RENDER 函数	RENDER(boolean expression)	使用默认颜色渲染返回结果。布尔表达式为真时，返回绿色勾；否则返回红色叉。
RENDER 函数		RENDER(x, color)	使用自定义的颜色渲染返回结果。
RGB 函数	RGB(red, green, blue)	通过指定的 RGB 值返回一个颜色值。

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)

检索和分析结果

最近更新时间：2026.08.28 16:45:49

这个页面对您有帮助吗？

有用

有用

无用

无用