Lucene 表达式语言
编辑Lucene 表达式语言
编辑Lucene 的表达式将 javascript 表达式编译为字节码。它们专为高性能自定义排名和排序功能而设计，并且默认情况下为 inline 和 stored 脚本启用。
性能
编辑表达式旨在与自定义 Lucene 代码具有竞争性的性能。这种性能归因于与其他脚本引擎相比，每个文档的开销较低：表达式“预先”做得更多。
这允许非常快速的执行，甚至比您编写 native 脚本还要快。
语法
编辑表达式支持 javascript 语法的子集：单个表达式。
有关可用运算符和函数的详细信息，请参阅表达式模块文档。
expression 脚本中的变量可用于访问
- 文档字段，例如
doc['myfield'].value - 字段支持的变量和方法，例如
doc['myfield'].empty - 传递到脚本中的参数，例如
mymodifier - 当前文档的分数，
_score（仅在script_score中使用时可用）
您可以将表达式脚本用于 script_score、script_fields、排序脚本和数字聚合脚本，只需将 lang 参数设置为 expression 即可。
数值字段 API
编辑| 表达式 | 描述 |
|---|---|
|
字段的值，为 |
|
一个布尔值，指示字段在文档中是否没有值。 |
|
此文档中的值的数量。 |
|
此文档中字段的最小值。 |
|
此文档中字段的最大值。 |
|
此文档中字段的中位数。 |
|
此文档中值的平均值。 |
|
此文档中值的总和。 |
当文档完全缺少该字段时，默认情况下该值将被视为 0。您可以将其视为另一个值，例如 doc['myfield'].empty ? 100 : doc['myfield'].value
当文档的字段有多个值时，默认情况下返回最小值。您可以选择不同的值，例如 doc['myfield'].sum()。
当文档完全缺少该字段时，默认情况下该值将被视为 0。
布尔字段作为数值公开，true 映射到 1，false 映射到 0。例如： doc['on_sale'].value ? doc['price'].value * 0.5 : doc['price'].value
日期字段 API
编辑日期字段被视为自 1970 年 1 月 1 日以来的毫秒数，并支持上面的数值字段 API，以及对某些特定于日期的字段的访问
| 表达式 | 描述 |
|---|---|
|
世纪 (1-2920000) |
|
日 (1-31)，例如，每月的第一天为 |
|
星期几 (1-7)，例如，星期一为 |
|
一年中的第几天，例如，1 月 1 日为 |
|
纪元：公元前为 |
|
小时 (0-23)。 |
|
一天中的毫秒数 (0-86399999)。 |
|
秒内的毫秒数 (0-999)。 |
|
一天中的分钟数 (0-1439)。 |
|
小时内的分钟数 (0-59)。 |
|
一年中的月份 (1-12)，例如，1 月为 |
|
一天中的秒数 (0-86399)。 |
|
分钟内的秒数 (0-59)。 |
|
年份 (-292000000 - 292000000)。 |
|
世纪内的年份 (1-100)。 |
|
纪元内的年份 (1-292000000)。 |
以下示例显示 date 字段 date0 和 date1 之间的年份差
doc['date1'].date.year - doc['date0'].date.year
geo_point 字段 API
编辑| 表达式 | 描述 |
|---|---|
|
一个布尔值，指示字段在文档中是否没有值。 |
|
地理点的纬度。 |
|
地理点的经度。 |
以下示例计算距离华盛顿特区的公里数
haversin(38.9072, 77.0369, doc['field_name'].lat, doc['field_name'].lon)
在此示例中，坐标可以作为参数传递给脚本，例如，基于用户的地理位置。
限制
编辑与其他脚本语言相比，有一些限制
- 只能访问数值、
boolean、date和geo_point字段 - 存储字段不可用