操作符函数的语法规则有哪些 - 日志服务

本文介绍操作符函数的语法规则，包括参数解释、函数示例等。

函数列表

说明

如果值为负数，请使用op_neg(positive value)函数，例如：您要表示-1，请使用op_neg(1)。

类型	函数	说明
条件判断函数	op_if	根据判断条件返回不同表达式的值。
	op_ifnull，op_coalesce	返回第一个值不为None的表达式的值。
	op_nullif	如果表达式1等于表达式2，返回None。否则返回表达式1的值。
	op_and	使用逻辑运算and，对任意类型值进行真假判断，所有参数值为真时返回True。
	op_not	使用逻辑运算not，对任意类型值进行真假判断，返回参数值的反义布尔值。
	op_or	使用逻辑运算or，对任意类型值进行真假判断。当任意参数值为真时返回True，所有参数值为假时返回False。
比较	op_eq	按照`a==b`条件进行计算，返回True或False。 a和b类型必须一致，例如都是字符串、数字或者列表。
	op_ge	按照`a>=b`条件进行计算，返回True或False。 a和b类型必须一致，例如都是字符串、数字或者列表。
	op_gt	按照`a>b`条件进行计算，返回True或False。 a和b类型必须一致，例如都是字符串、数字或者列表。
	op_le	按照`a<=b`条件进行计算，返回True或False。 a和b类型必须一致，例如都是字符串、数字或者列表。
	op_lt	按照`a<b`条件进行计算，返回True或False。 a和b类型必须一致，例如都是字符串、数字或者列表。
	op_ne	按照`a!=b`条件进行计算，返回True或False。 a和b类型必须一致，例如都是字符串、数字或者列表。
容器判断	op_len	计算文本字符串中的字符数，可用于字符串和其他返回元组、列表、字典的表达式。
	op_in	判断字符串、元组、列表或字典中是否包含特定元素，返回True或False。
	op_not_in	判断字符串、元组、列表或字典中是否不包含特定元素，返回True或False。
	op_slice	对指定字符串、数组、元组进行截取。
	op_index	根据字符串、数组、元组的下标返回其对应的元素。
一般性多值操作	op_add	计算多个值的和，可以是字符串或者数字等。
	op_max	计算多个字段或表达式表示的数值的最大值。
	op_min	计算多个字段或表达式表示的数值的最小值。

op_if

根据判断条件返回不同表达式的值。

函数格式

op_if(condition, expression1, expression2)

参数说明

参数名称	参数类型	是否必填	说明
condition	任意	是	判断条件。如果该条件为非布尔值，系统将对其采用真假判断。更多信息，请参见真假判断。
expression1	任意	是	判断结果为True时，返回该表达式的值。
expression2	任意	是	判断结果为False时，返回该表达式的值。

返回结果
返回相应的表达式的值。

函数示例

示例1：如果content为True，则把表达式1的值赋给test_if。

原始日志
```
content: hello
```

加工规则

e_set("test_if", op_if(v("content"),"still origion content","replace this"))

加工结果

content: hello
test_if:  still origion content

示例2：如果content为False，则把表达式2的值赋给test_if。

原始日志
```
content: 0
```

加工规则

e_set("test_if", op_if(ct_int(v("content", default=0)),"still origion content","replace this"))

加工结果
```
content: 0
test_if:  replace this
```

op_ifnull

返回第一个值不为None的表达式的值。

函数格式

op_ifnull(expression1, expression2, ....)

参数说明
参数名称
参数类型
是否必填
说明
expression1
任意
是
表达式1。
expression2
任意
是
表达式2。
返回结果
返回第一个值不为None的表达式的值。

函数示例

示例1：

原始日志
```
test_if: hello
escape_name: Etl
```

加工规则

e_set("test_ifnull", op_ifnull(v("escape_name"),v("test_if")))

加工结果

test_if: hello
escape_name: Etl
test_ifnull:  Etl

示例2：

原始日志
```
test_if: hello
escape_name: Etl
```

加工规则

e_set("test_ifnull", op_ifnull(v("test_if"),v("escape_name")))

加工结果

test_if: hello
escape_name: Etl
test_ifnull:  hello

op_coalesce

返回第一个值不为None的表达式的值。

与op_ifnull函数的参数说明和示例类似。更多信息，请参见op_ifnull。

op_nullif

如果表达式1等于表达式2，返回None。否则返回表达式1的值。

函数格式
```
op_nullif(expression1, expression2)
```
参数说明
参数名称
参数类型
是否必填
说明
expression1
任意
是
表达式1。
expression2
任意
是
表达式2。
返回结果
如果表达式1和表达式2相等返回None，否则返回表达式1的值。

函数示例

示例1：

原始日志
```
content: hello
escape_name: Etl
```

加工规则

e_set("test_ifnull", op_nullif(v("content"),v("escape_name")))

加工结果

content: hello
escape_name: Etl
test_nullif:  hello

示例2：

原始日志
```
content: hello
escape_name: hello
```

加工规则

e_set("test_ifnull", op_nullif(v("content"),v("escape_name")))

加工结果

#因为content与escape_name内容一样，所以没有任何内容返回给test_isnull字段。
content: hello
escape_name: hello

op_and

使用逻辑运算and，对任意类型值进行真假判断，所有参数值为真时返回True。

函数格式
```
op_and(value1, value2, ...)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
任意
是
运算值1。
value2
任意
是
运算值2。
返回结果
- 所有参数值为真时返回True。
- 对任意类型值进行真假判断。更多信息，请参见真假判断。

函数示例

示例1：

原始日志
```
number1: 123
number2: 234
```

加工规则

e_set("op_and", op_and(v("number1"),v("number2")))

加工结果
```
number1: 123
number2: 234
op_and:  True
```

示例2：

原始日志
```
number1: 0
number2: 234
```

加工规则

e_set("op_and", op_and(v("number1"),v("number2")))

加工结果
```
number1: 0
number2: 234
op_and: True
```

示例3：

原始日志
```
ctx1: False
ctx2: 234
```

加工规则

e_set("op_and", op_and(v("ctx1"),v("ctx2")))

加工结果
```
ctx1: False
ctx2: 234
op_and: False
```

示例4：

原始日志
```
ctx1: True
ctx2: 234
```

加工规则

e_set("op_and", op_and(v("ctx1"),v("ctx2")))

加工结果
```
ctx1: True
ctx2: 234
op_and: True
```

op_not

使用逻辑运算not，对任意类型值进行真假判断，返回表达式值的反义布尔值。

函数格式
```
op_not(expression)
```
参数说明
参数名称
参数类型
是否必填
说明
expression
任意
是
表达式。
返回结果
- 返回表达式值的反义布尔值。
- 对任意类型值进行真假判断。更多信息，请参见真假判断。

函数示例

示例1：

原始日志
```
ctx1: True
```
加工规则
```
e_set("op_not", op_not(v("ctx1")))
```
加工结果
```
ctx1: True
op_not:  False
```

示例2：

原始日志
```
ctx1: 345
```
加工规则
```
e_set("op_not", op_not(v("ctx1")))
```
加工结果
```
ctx1: 345
op_not:  False
```

示例3：

原始日志
```
ctx1: 0
```

加工规则

e_set("op_not", op_not(ct_int(v("ctx1"))))

加工结果
```
ctx1: 0
op_not:  True
```

示例4：

原始日志
```
ctx1: ETL
```
加工规则
```
e_set("op_not", op_not(v("ctx1")))
```
加工结果
```
ctx1: ETL
op_not:  False
```

示例5：

原始日志
```
ctx1: None
```
加工规则
```
e_set("op_not", op_not(v("ctx1")))
```
加工结果
```
ctx1: None
op_not:  True
```

op_or

使用逻辑运算or，对任意类型值进行真假判断。当任意表达式的值为真时返回True，所有表达式值为假时返回False。

函数格式
```
op_or(expression1, expression2, ...)
```
参数说明
参数名称
参数类型
是否必填
说明
expression1
任意
是
表达式1。
expression2
任意
是
表达式2。
返回结果
- 任意表达式的值为真时返回True，所有表达式的值为假时返回False。
- 对任意类型值进行真假判断。更多信息，请参见真假判断。

函数示例

示例1：

原始日志
```
ctx1: 123
ctx2: 234
```

加工规则

e_set("op_or", op_or(v("ctx1"),v("ctx2")))

加工结果
```
ctx1: 123
ctx2: 234
op_or:  True
```

示例2：

原始日志
```
ctx1: 0
ctx2: 234
```

加工规则

e_set("op_or", op_or(v("ctx1"),v("ctx2")))

加工结果
```
ctx1: 0
ctx2: 234
op_or:  True
```

示例3：

原始日志
```
ctx1: ETL
ctx2: ALIYUN
```

加工规则

e_set("op_or", op_or(v("ctx1"),v("ctx2")))

加工结果
```
ctx1: ETL
ctx2: ALIYUN
op_or:  True
```

示例4：

原始日志
```
ctx1: True
ctx2: False
```

加工规则

e_set("op_or", op_or(v("ctx1"),v("ctx2")))

加工结果
```
ctx1: True
ctx2: False
op_or:  True
```

示例5：

原始日志
```
ctx1: 0
ctx2: False
```

加工规则

e_set("op_or", op_or(ct_int(v("ctx1")),v("ctx2")))

加工结果
```
ctx1: 0
ctx2: False
op_or:  False
```

示例6：

原始日志
```
ctx1: 124
ctx2: True
```

加工规则

e_set("op_or", op_or(v("ctx1"),v("ctx2")))

加工结果
```
ctx1: 124
ctx2: True
op_or:  True
```

op_eq

按照a==b条件进行计算，返回True或False。

函数格式
```
op_eq(value1, value2)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
任意
是
运算值1。
value2
必须与值1相同
是
运算值2。
返回结果
如果值1与值2相等返回True，否则返回False。

函数示例

示例1：

原始日志
```
content: hello
ctx: hello
```

加工规则

e_set("test_eq", op_eq(v("content"),v("ctx")))

加工结果
```
content: hello
ctx: hello
test_eq: True
```

示例2：

原始日志
```
content: hello
ctx: ctx
```

加工规则

e_set("test_eq", op_eq(v("content"),v("ctx")))

加工结果
```
content: hello
ctx: ctx
test_eq: False
```

op_ge

按照a>=b条件进行计算，返回True或False。

函数格式
```
op_ge(value1, value2)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
任意
是
运算值1。
value2
必须与值1相同
是
运算值2。
返回结果
如果值1大于等于值2返回True，否则返回False。

函数示例

示例1：假如apple_price的值大于等于orange_price的值，则返回True。

原始日志
```
apple_price: 16
orange_price: 14
```

加工规则

e_set("test_ge", op_ge(ct_int(v("apple_price")),ct_int(v("orange_price"))))

加工结果

apple_price: 16
orange_price: 14
test_ge: True

示例2：假如apple_price的值小于orange_price的值，则返回False。

原始日志
```
apple_price: 12
orange_price: 14
```

加工规则

e_set("test_ge", op_ge(ct_int(v("apple_price")),ct_int(v("orange_price"))))

加工结果

apple_price: 12
orange_price: 14
test_ge: False

op_gt

按照a>b条件进行计算，返回True或False。

函数格式
```
op_gt(value1, value2)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
任意
是
运算值1。
value2
必须与值1相同
是
运算值2。
返回结果
如果值1大于值2返回True，否则返回False。
函数示例
- 示例1：判断old_number取值是否大于young_number取值，大于返回True否则返回False。
  - 原始日志
```
old_number: 16
young_number: 14
```
  - 加工规则
```
e_set("op_gt",op_gt(ct_int(v("old_number")),ct_int(v("young_number"))))
```
  - 加工结果
```
old_number: 16
young_number: 14
test_ge: True
```
- 示例2：判断priority取值是否大于price取值，大于返回True否则返回False。
  - 原始日志
```
priority: 14
price: 16
```
  - 加工规则
```
e_set("op_gt",op_gt(ct_int(v("priority")),ct_int(v("price"))))
```
  - 加工结果
```
priority: 14
price: 16
test_ge: False
```

op_le

按照a<=b条件进行计算，返回True或False。

函数格式
```
op_le(value1, value2)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
任意
是
运算值1。
value2
必须与值1相同
是
运算值2。
返回结果
如果值1小于等于值2返回True，否则返回False。
函数示例
- 示例1：如果priority的值小于等于price的值，返回True否则返回False。
  - 原始日志
```
priority: 16
price: 14
```
  - 加工规则
```
e_set("op_le",op_le(ct_int(v("priority")),ct_int(v("price"))))
```
  - 加工结果
```
priority: 16
price: 14
test_ge: False
```
- 示例2：如果priority的值小于等于price的值，返回True否则返回False。
  - 原始日志
```
priority: 14
price: 16
```
  - 加工规则
```
e_set("op_le",op_le(ct_int(v("priority")),ct_int(v("price"))))
```
  - 加工结果
```
priority: 14
price: 16
test_ge: True
```

op_lt

按照a<b条件进行计算，返回True或False。

函数格式
```
op_lt(value1, value2)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
任意
是
运算值1。
value2
必须与值1相同
是
运算值2。
返回结果
如果值1小于值2返回True，否则返回False。
函数示例
- 示例1：如果priority的值小于price的值，返回True否则返回False。
  - 原始日志
```
priority: 16
price: 14
```
  - 加工规则
```
e_set("op_lt",op_lt(ct_int(v("priority")),ct_int(v("price"))))
```
  - 加工结果
```
priority: 16
price: 14
op_lt: False
```
- 示例2：如果priority的值小于price的值，返回True否则返回False。
  - 原始日志
```
priority: 14
price: 15
```
  - 加工规则
```
e_set("op_lt",op_lt(ct_int(v("priority")),ct_int(v("price"))))
```
  - 加工结果
```
priority: 14
price: 15
op_lt: True
```

op_ne

按照a!=b条件进行计算，返回True或False。

函数格式
```
op_ne(value1, value2)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
任意
是
运算值1。
value2
必须与值1相同
是
运算值2。
返回结果
如果值1不等于值2返回True，否则返回False。

函数示例

示例1：

原始日志
```
priority: 16
price: 14
```

加工规则

e_set("op_ne",op_ne(ct_int(v("priority")),ct_int(v("price"))))

加工结果
```
priority: 16
price: 14
op_ne: True
```

示例2：

原始日志
```
priority: 14
price: 14
```

加工规则

e_set("op_ne",op_ne(ct_int(v("priority")),ct_int(v("price"))))

加工结果
```
priority: 14
price: 14
op_ne: False
```

op_len

计算文本字符串中的字符数，可用于字符串和其他返回元组、列表、字典的表达式。

函数格式
```
op_len(value）
```
参数说明
参数名称
参数类型
是否必填
说明
value
字符串、元组、列表或字典等
是
运算值。
返回结果
返回字段的长度。

函数示例

原始日志
```
content: I,love,this,world
```
加工规则
```
e_set("op_len",op_len(v("content")))
```
加工结果
```
content: I,love,this,world
op_len: 17
```

op_in

判断字符串、元组、列表或字典中是否包含特定元素，返回True或False。

函数格式
```
op_in(value1, value2)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
字符串、元组、列表或字典等
是
字符串、元组、列表或者字典等。
value2
任意
是
判断的元素。
说明
函数中字符串、元组、列表或字典参数在前，元素在后。
返回结果
如果字符串、元组、列表或字典a中包含元素b返回True，否则返回False。

函数示例

原始日志
```
list:  [1, 3, 2, 7, 4, 6]
num2:  2
```

加工规则

e_set("op_in",op_in(v("list"),v("num2")))

加工结果

list:  [1, 3, 2, 7, 4, 6]
num2:  2
op_in: True

op_not_in

判断字符串、元组、列表或字典中是否不包含特定元素，返回True或False。

函数格式
```
op_not_in(value1, value2)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
字符串、元组、列表或字典等
是
字符串、元组、列表或者字典等。
value2
任意
是
判断的元素。
说明
函数中字符串、元组、列表或字典参数在前，元素在后。
返回结果
如果字符串、元组、列表或字典中不包含元素返回True，否则返回False。

函数示例

原始日志
```
list:  [1, 3, 2, 7, 4, 6]
num2:  12
```

加工规则

e_set("op_not_in",op_not_in(v("list"),v("num2")))

加工结果

list:  [1, 3, 2, 7, 4, 6]
num2:  12
op_in: True

op_slice

对指定字符串、数组、元组进行截取。

函数格式

op_slice(value, start, end=None, step=None)

参数说明

参数名称	参数类型	是否必填	说明
value	String	是	函数要切片的值。
start	Num	否	截取的起始位置，默认为位置0。
end	Num	否	截取的结束位置，不包含该位置，默认为字符串结尾位置。
step	Num	否	每次截取的长度。

返回结果
返回提取后的字符串。
函数示例
- 示例1：对word字段从开头到结尾开始进行截取，步长为2。
  - 原始日志
```
word:  I,love,this,world
```
  - 加工规则
```
e_set("op_slice",op_slice(v("word"),2))
```
  - 加工结果
```
word:  I,love,this,world
op_slice: I,
```
- 示例2：对word字段从位置2到位置9进行截取，步长为1。
  - 原始日志
```
word:  I,love,this,world
```
  - 加工规则
```
e_set("op_slice",op_slice(v("word"),2,9,1))
```
  - 加工结果
```
word:  I,love,this,world
op_slice: love,th
```

op_index

根据字符串、数组、元组的下标返回其对应的元素。

函数格式
```
op_index(value, index)
```
参数说明
参数名称
参数类型
是否必填
说明
value
String
是
字符串、数组、元组等。
index
Num
否
需要传入的字符串、数组或元组的下标。
返回结果
返回下标对应的元素。

函数示例

示例1：返回word字段下标为0的元素。

原始日志
```
word:  I,love,this,world
```
加工规则
```
e_set("op_index",op_index(v("word"),0))
```
加工结果
```
word:  I,love,this,world
op_slice: I
```

示例2：返回word字段下标为3的元素。

原始日志
```
word:  I,love,this,world
```
加工规则
```
e_set("op_index",op_index(v("word"),3))
```
加工结果
```
word:  I,love,this,world
op_index: o
```

op_add

计算多个值的和，可以是字符串或者数字等。

函数格式
```
op_add(value1, value2, ...)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
字符串、元组、列表或字典等
是
运算值1。
value2
必须与值1一样
是
运算值2。
返回结果
返回求和操作后的数值。

函数示例

示例1：计算price_orange和price_apple总金额。

原始日志
```
price_orange: 2
price_apple: 13
```

加工规则

e_set("account",op_add(ct_int(v("price_orange")),ct_int(v("price_apple"))))

加工结果

price_orange: 2
price_apple: 13
account:  15

示例2：统计bytes_in和bytes_out的和。

原始日志
```
bytes_in: 214
bytes_out: 123
```

加工规则

e_set("total_bytes", op_add(ct_int(v("bytes_in")), ct_int(v("bytes_out"))))

加工结果

bytes_in: 214
bytes_out: 123
total_bytes:  337

示例3：给网址添加HTTPS头。

原始日志
```
host: aliyun.com
```

加工规则

e_set("website", op_add("https://", v("host")))

加工结果

host: aliyun.com
website: https://aliyun.com

op_max

计算多个字段或表达式表示的数值的最大值。

函数格式
```
op_max(value1, value2, ...)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
任意
是
运算值1。
value2
必须与值1一样
是
运算值2。
返回结果
返回多个数值中的最大值。

函数示例

原始日志
```
price_orange:  2
priority_apple:  13
```

加工规则

e_set("max_price", op_max(ct_int(v("price_orange")),ct_int(v("priority_apple"))))

加工结果

price_orange:  2
priority_apple:  13
max_price:  13

op_min

计算多个字段或表达式表示的数值的最小值。

函数格式
```
op_min(value1, value2, ...)
```
参数说明
参数名称
参数类型
是否必填
说明
value1
任意
是
运算值1。
value2
必须与值1一样
是
运算值2。
返回结果
返回多个数值中的最小值。

函数示例

原始日志
```
price_orange:  2
price_apple:  13
```

加工规则

e_set("op_min", op_min(ct_int(v("price_orange")),ct_int(v("price_apple"))))

加工结果

price_orange:  2
price_apple:  13
op_min:  2

参数名称	参数类型	是否必填	说明
value1	字符串、元组、列表或字典等	是	运算值1。
value2	必须与值1一样	是	运算值2。

函数列表

op_if

函数格式

参数说明

返回结果

函数示例

op_ifnull

函数格式

参数说明

返回结果

函数示例

op_coalesce

op_nullif

函数格式

参数说明

返回结果

函数示例

op_and

函数格式

参数说明

返回结果

函数示例

op_not

函数格式

参数说明

返回结果

函数示例

op_or

函数格式

参数说明

返回结果

函数示例

op_eq

函数格式

参数说明

返回结果

函数示例

op_ge

函数格式

参数说明

返回结果

函数示例

op_gt

函数格式

参数说明

返回结果

函数示例

op_le

函数格式

参数说明

返回结果

函数示例

op_lt

函数格式

参数说明

返回结果

函数示例

op_ne

函数格式

参数说明

返回结果

函数示例

op_len

函数格式

参数说明

返回结果

函数示例

op_in

函数格式

参数说明

返回结果

函数示例

op_not_in

函数格式

参数说明

返回结果

函数示例

op_slice

函数格式

参数说明