manual/chinese/Searching/Expressions.md
Manticore 通过 SQL 和 HTTP 支持使用任意的算术表达式，结合属性值、内部属性（文档 ID 和相关度权重）、算术运算、多种内建函数以及用户自定义函数。以下是完整的参考列表，方便快速查阅。
+, -, *, /, %, DIV, MOD
提供标准算术运算符。使用这些运算符的算术计算可以以三种不同模式执行：
表达式解析器会自动切换到整数模式，如果没有任何运算结果为浮点值。否则，使用默认的浮点模式。例如，当两个参数都是 32 位整数时，a+b 会以 32 位整数计算；当两个参数都是整数但其中一个为 64 位时，使用 64 位整数；否则以浮点计算。然而，a/b 或 sqrt(a) 始终以浮点计算，因为这些运算返回非整数结果。为避免这种情况，可以使用 IDIV(a,b) 或 DIV b 形式。另外，当参数是 32 位时，a*b 不会自动提升到 64 位。若要强制使用 64 位结果，请使用 BIGINT()，但注意如果存在非整数运算，BIGINT() 将被忽略。
<, > <=, >=, =, <>
比较运算符返回 1.0 时条件为真，返回 0.0 时条件为假。例如，当属性 a 等于属性 b 时，表达式 (a=b)+3 计算值为 4；当 a 不等于 b 时，计算值为 3。与 MySQL 不同，等值比较（即 = 和 <> 运算符）包含一个小的相等阈值（默认是 1e-6）。如果比较值的差距在阈值内，则认为它们相等。
对于多值属性，BETWEEN 和 IN 运算符只要至少一个值满足条件就返回真（类似于 ANY()）。IN 运算符不支持 JSON 属性。IS (NOT) NULL 运算符仅支持 JSON 属性。
AND, OR, NOT
布尔运算符（AND、OR、NOT）的行为符合预期。它们是左结合的，并且优先级最低。NOT 的优先级高于 AND 和 OR，但仍低于其他运算符。AND 和 OR 具有相同优先级，建议在复杂表达式中使用括号以避免混淆。
&, |
这些运算符分别执行按位与和按位或。操作数必须是整数类型。
在 HTTP JSON 接口中，通过 script_fields 和 expressions 支持表达式。
{
"table": "test",
"query": {
"match_all": {}
}, "script_fields": {
"add_all": {
"script": {
"inline": "( gid * 10 ) | crc32(title)"
}
},
"title_len": {
"script": {
"inline": "crc32(title)"
}
}
}
}
在这个示例中，创建了两个表达式：add_all 和 title_len。第一个表达式计算 ( gid * 10 ) | crc32(title) 并将结果存储在 add_all 属性中。第二个表达式计算 crc32(title) 并将结果存储在 title_len 属性中。
目前，仅支持 inline 表达式。inline 属性（要计算的表达式）的值具有与 SQL 表达式相同的语法。
表达式名称可以在过滤或排序中使用。
<!-- intro -->{
"table":"movies_rt",
"script_fields":{
"cond1":{
"script":{
"inline":"actor_2_facebook_likes =296 OR movie_facebook_likes =37000"
}
},
"cond2":{
"script":{
"inline":"IF (IN (content_rating,'TV-PG','PG'),2, IF(IN(content_rating,'TV-14','PG-13'),1,0))"
}
}
},
"limit":10,
"sort":[
{
"cond2":"desc"
},
{
"actor_1_name":"asc"
},
{
"actor_2_name":"desc"
}
],
"profile":true,
"query":{
"bool":{
"must":[
{
"match":{
"*":"star"
}
},
{
"equals":{
"cond1":1
}
}
],
"must_not":[
{
"equals":{
"content_rating":"R"
}
}
]
}
}
}
默认情况下，表达式值包含在结果集的 _source 数组中。如果源是选择性的（参见 源选择），可以在请求中将表达式名称添加到 _source 参数中。注意，表达式的名称必须是小写的。
expressions 是 script_fields 的替代方案，语法更简单。示例请求添加了两个表达式并将结果存储在 add_all 和 title_len 属性中。注意，表达式的名称必须是小写的。
{
"table": "test",
"query": { "match_all": {} },
"expressions":
{
"add_all": "( gid * 10 ) | crc32(title)",
"title_len": "crc32(title)"
}
}