配置项概述 #
point_in_time.init.keep_alive 配置项控制时间点（Point In Time，PIT）上下文的初始保持活跃时间。
| 配置项 | 默认值 | 说明 |
|---|---|---|
point_in_time.init.keep_alive | 30s | PIT 初始保持活跃时间 |
配置说明 #
point_in_time.init.keep_alive #
配置项作用：控制 PIT 上下文的初始保持活跃时间。当创建 PIT 上下文时，如果客户端未指定 keep_alive 值，将使用此配置作为默认值。
默认值：30s
配置类型：动态配置
取值范围：任何正数时间值（如 1m, 5m, 1h 等）
配置格式：
# 默认配置
point_in_time.init.keep_alive: 30s
# 增加初始保持时间
point_in_time.init.keep_alive: 1m
# 减少初始保持时间
point_in_time.init.keep_alive: 10s
使用场景 #
默认配置 #
# 默认 30 秒
point_in_time.init.keep_alive: 30s
适用场景：
- 一般搜索场景
- 需要及时释放资源
延长保持时间 #
# 延长到 1 分钟
point_in_time.init.keep_alive: 1m
适用场景：
- 需要更长时间的搜索
- 复杂的分页查询
- 后台处理任务
短暂保持时间 #
# 缩短到 10 秒
point_in_time.init.keep_alive: 10s
适用场景：
- 快速搜索
- 资源受限环境
- 高频 PIT 创建场景
PIT API 使用 #
创建 PIT 上下文 #
# 使用默认 keep_alive
POST /my-index/_pit
# 指定 keep_alive
POST /my-index/_pit?keep_alive=1m
使用 PIT 搜索 #
POST /_search
{
"pit": {
"id": "pit-id-value",
"keep_alive": "1m"
},
"query": {
"match_all": {}
}
}
推荐配置 #
默认配置 #
point_in_time.init.keep_alive: 30s
长时间搜索 #
point_in_time.init.keep_alive: 1m
快速搜索 #
point_in_time.init.keep_alive: 10s
注意事项 #
- 动态配置：可动态更新，无需重启
- 资源管理：PIT 上下文占用内存，及时清理
- 最大限制：受
point_in_time.max_keep_alive限制 - 续期机制：可以通过搜索请求续期 PIT
