---
title: "时间点初始保持活跃时间配置"
date: 2026-01-30
lastmod: 2026-01-30
description: "控制时间点（PIT）上下文初始保持活跃时间的配置说明"
tags: ["时间点配置", "PIT配置", "搜索配置"]
summary: "配置项概述 #  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 适用场景："
---


## 配置项概述

`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` 等）

**配置格式**：
```yaml
# 默认配置
point_in_time.init.keep_alive: 30s

# 增加初始保持时间
point_in_time.init.keep_alive: 1m

# 减少初始保持时间
point_in_time.init.keep_alive: 10s
```

---

## 使用场景

## 默认配置

```yaml
# 默认 30 秒
point_in_time.init.keep_alive: 30s
```

**适用场景**：
- 一般搜索场景
- 需要及时释放资源

## 延长保持时间

```yaml
# 延长到 1 分钟
point_in_time.init.keep_alive: 1m
```

**适用场景**：
- 需要更长时间的搜索
- 复杂的分页查询
- 后台处理任务

## 短暂保持时间

```yaml
# 缩短到 10 秒
point_in_time.init.keep_alive: 10s
```

**适用场景**：
- 快速搜索
- 资源受限环境
- 高频 PIT 创建场景

---

## PIT API 使用

## 创建 PIT 上下文

```bash
# 使用默认 keep_alive
POST /my-index/_pit

# 指定 keep_alive
POST /my-index/_pit?keep_alive=1m
```

## 使用 PIT 搜索

```bash
POST /_search
{
  "pit": {
    "id": "pit-id-value",
    "keep_alive": "1m"
  },
  "query": {
    "match_all": {}
  }
}
```

---

## 推荐配置

## 默认配置

```yaml
point_in_time.init.keep_alive: 30s
```

## 长时间搜索

```yaml
point_in_time.init.keep_alive: 1m
```

## 快速搜索

```yaml
point_in_time.init.keep_alive: 10s
```

---

## 注意事项

1. **动态配置**：可动态更新，无需重启
2. **资源管理**：PIT 上下文占用内存，及时清理
3. **最大限制**：受 `point_in_time.max_keep_alive` 限制
4. **续期机制**：可以通过搜索请求续期 PIT