范围查询
编辑范围查询编辑
返回包含在指定范围内的词条的文档。
示例请求编辑
以下搜索返回 age 字段包含介于 10 和 20 之间的词条的文档。
resp = client.search(
body={"query": {"range": {"age": {"gte": 10, "lte": 20, "boost": 2}}}},
)
print(resp)
response = client.search(
body: {
query: {
range: {
age: {
gte: 10,
lte: 20,
boost: 2
}
}
}
}
)
puts response
res, err := es.Search(
es.Search.WithBody(strings.NewReader(`{
"query": {
"range": {
"age": {
"gte": 10,
"lte": 20,
"boost": 2.0
}
}
}
}`)),
es.Search.WithPretty(),
)
fmt.Println(res, err)
GET /_search
{
"query": {
"range": {
"age": {
"gte": 10,
"lte": 20,
"boost": 2.0
}
}
}
}
range 的顶级参数编辑
-
<field> -
（必填，对象）要搜索的字段。
<field> 的参数编辑
-
relation -
（可选，字符串）指示范围查询如何匹配
range字段的值。有效值为-
INTERSECTS（默认） - 匹配范围字段值与查询范围相交的文档。
-
CONTAINS - 匹配范围字段值完全包含查询范围的文档。
-
WITHIN - 匹配范围字段值完全在查询范围内的文档。
-
-
time_zone -
（可选，字符串）用于将查询中的
date值转换为 UTC 的 协调世界时 (UTC) 偏移量 或 IANA 时区。有效值为 ISO 8601 UTC 偏移量（例如
+01:00或 -08:00）和 IANA 时区 ID（例如America/Los_Angeles）。有关使用
time_zone参数的示例查询，请参阅range查询中的时区。 -
boost -
（可选，浮点数）用于减少或增加查询的 相关性分数 的浮点数。默认为
1.0。您可以使用
boost参数来调整包含两个或多个查询的搜索的相关性分数。提升值是相对于默认值
1.0的。介于0和1.0之间的提升值会降低相关性分数。大于1.0的值会增加相关性分数。
注意编辑
将 range 查询与 text 和 keyword 字段一起使用编辑
如果 search.allow_expensive_queries 设置为 false，则不会执行对 text 或 keyword 字段的范围查询。
将 range 查询与 date 字段一起使用编辑
当 <field> 参数是 date 字段数据类型时，您可以将 日期数学 与以下参数一起使用
-
gt -
gte -
lt -
lte
例如，以下搜索返回 timestamp 字段包含介于今天和昨天之间的日期的文档。
resp = client.search(
body={
"query": {
"range": {"timestamp": {"gte": "now-1d/d", "lte": "now/d"}}
}
},
)
print(resp)
response = client.search(
body: {
query: {
range: {
timestamp: {
gte: 'now-1d/d',
lte: 'now/d'
}
}
}
}
)
puts response
GET /_search
{
"query": {
"range": {
"timestamp": {
"gte": "now-1d/d",
"lte": "now/d"
}
}
}
}
缺少日期组件编辑
对于范围查询和 日期范围 聚合，Elasticsearch 会将缺少的日期组件替换为以下值。不会替换缺少的年份组件。
MONTH_OF_YEAR: 01 DAY_OF_MONTH: 01 HOUR_OF_DAY: 23 MINUTE_OF_HOUR: 59 SECOND_OF_MINUTE: 59 NANO_OF_SECOND: 999_999_999
例如，如果格式为 yyyy-MM，则 Elasticsearch 会将 gt 值 2099-12 转换为 2099-12-01T23:59:59.999_999_999Z。此日期使用提供的年份 (2099) 和月份 (12)，但使用默认的日期 (01)、小时 (23)、分钟 (59)、秒 (59) 和纳秒 (999_999_999)。
数字日期范围值编辑
如果未指定日期格式，并且范围查询的目标是日期字段，则数字值将被解释为表示自纪元以来的毫秒数。如果您希望该值表示年份（例如 2020），则需要将其作为字符串值（例如“2020”）传递，该值将根据默认格式或设置的格式进行解析。
日期数学和舍入编辑
Elasticsearch 如下舍入参数中的 日期数学 值
-
gt -
向上舍入到舍入日期未涵盖的第一个毫秒。
例如，
2014-11-18||/M向上舍入到2014-12-01T00:00:00.000，不包括整个 11 月。 -
gte -
向下舍入到第一个毫秒。
例如，
2014-11-18||/M向下舍入到2014-11-01T00:00:00.000，包括整个月。 -
lt -
向下舍入到舍入值之前的最后一个毫秒。
例如，
2014-11-18||/M向下舍入到2014-10-31T23:59:59.999，不包括整个 11 月。 -
lte -
向上舍入到舍入间隔中的最后一个毫秒。
例如，
2014-11-18||/M向上舍入到2014-11-30T23:59:59.999，包括整个月。
使用 time_zone 参数的示例查询编辑
您可以使用 time_zone 参数使用 UTC 偏移量将 date 值转换为 UTC。例如
$params = [
'body' => [
'query' => [
'range' => [
'timestamp' => [
'time_zone' => '+01:00',
'gte' => '2020-01-01T00:00:00',
'lte' => 'now',
],
],
],
],
];
$response = $client->search($params);
resp = client.search(
body={
"query": {
"range": {
"timestamp": {
"time_zone": "+01:00",
"gte": "2020-01-01T00:00:00",
"lte": "now",
}
}
}
},
)
print(resp)
response = client.search(
body: {
query: {
range: {
timestamp: {
time_zone: '+01:00',
gte: '2020-01-01T00:00:00',
lte: 'now'
}
}
}
}
)
puts response
res, err := es.Search(
es.Search.WithBody(strings.NewReader(`{
"query": {
"range": {
"timestamp": {
"time_zone": "+01:00",
"gte": "2020-01-01T00:00:00",
"lte": "now"
}
}
}
}`)),
es.Search.WithPretty(),
)
fmt.Println(res, err)
const response = await client.search({
body: {
query: {
range: {
timestamp: {
time_zone: '+01:00',
gte: '2020-01-01T00:00:00',
lte: 'now'
}
}
}
}
})
console.log(response)