文档的CRUD操作-ElasticSearch入门与实践

当前位置:　首页>> 技术小册>> ElasticSearch入门与实践

### 文档的CRUD操作

在Elasticsearch中，文档（Document）是存储和搜索的基本单位。每个文档都是一个JSON对象，包含了字段（Field）及其对应的值。对文档的CRUD操作，即创建（Create）、读取（Read）、更新（Update）和删除（Delete），是Elasticsearch使用中最基础也是最重要的功能之一。本章将详细介绍如何在Elasticsearch中执行这些操作，帮助读者快速上手并高效管理数据。

#### 一、创建文档（Create）

在Elasticsearch中，创建文档通常是通过向指定的索引（Index）中发送一个包含文档数据的POST请求来完成的。如果索引不存在，Elasticsearch会根据请求中的设置自动创建索引（如果配置了自动创建索引的权限）。

##### 1.1 基本语法

使用Elasticsearch的REST API，创建文档的基本URL格式如下：

```
PUT /<index>/_doc/<id>
```

- `<index>` 是你想要存储文档的索引名称。
- `<id>` 是文档的唯一标识符。如果不指定ID，Elasticsearch会自动生成一个。

请求体（Body）应包含JSON格式的文档数据。

##### 示例

假设我们有一个名为`blogposts`的索引，我们想要创建一个新的博客文章：

```json
PUT /blogposts/_doc/1
{
  "title": "Elasticsearch入门与实践",
  "content": "本文详细介绍了Elasticsearch的文档CRUD操作...",
  "author": "张三",
  "publish_date": "2023-04-01"
}
```

这个请求会在`blogposts`索引中创建一个ID为`1`的文档，包含标题、内容、作者和发布日期等信息。

##### 1.2 批量创建

Elasticsearch支持通过`_bulk` API批量创建、更新或删除多个文档，以提高效率。批量操作通过发送一个包含多个操作指令的JSON数组来完成。

##### 示例

```json
POST /blogposts/_bulk
{"index":{"_id":"2"}}
{"title":"Elasticsearch进阶","content":"深入探索Elasticsearch的高级特性...","author":"李四","publish_date":"2023-04-02"}
{"index":{"_id":"3"}}
{"title":"Elasticsearch性能优化","content":"提升Elasticsearch查询性能的技巧...","author":"王五","publish_date":"2023-04-03"}
```

#### 二、读取文档（Read）

读取文档是通过发送GET请求到指定的索引和文档ID来完成的。

##### 2.1 基本语法

```
GET /<index>/_doc/<id>
```

##### 示例

```
GET /blogposts/_doc/1
```

这个请求会返回ID为`1`的文档内容。

##### 2.2 读取多个文档

虽然Elasticsearch没有直接的API来一次性读取多个指定ID的文档，但你可以通过`mget` API来批量获取多个文档的详细信息，这比单独发送多个GET请求更高效。

##### 示例

```json
GET /blogposts/_mget
{
  "docs": [
    {"_id": "1"},
    {"_index": "blogposts", "_id": "2"}
  ]
}
```

#### 三、更新文档（Update）

在Elasticsearch中，文档是不可变的，这意味着你不能直接修改一个已存在的文档。但是，你可以通过删除旧文档并索引一个新版本来实现更新的效果。不过，Elasticsearch也提供了`_update` API来部分更新文档，这通常比完全替换文档更高效。

##### 3.1 使用`_update` API

```
POST /<index>/_doc/<id>/_update
```

请求体可以包含`doc`字段来指定要更新的字段，或者使用`script`字段来执行更复杂的更新逻辑。

##### 示例

```json
POST /blogposts/_doc/1/_update
{
  "doc": {
    "content": "更新后的内容..."
  }
}
```

这个请求会更新ID为`1`的文档的`content`字段。

##### 3.2 脚本更新

对于更复杂的更新操作，可以使用Painless脚本或其他支持的脚本语言。

##### 示例

```json
POST /blogposts/_doc/1/_update
{
  "script" : {
    "source": "ctx._source.views += params.count",
    "lang": "painless",
    "params" : {
      "count" : 1
    }
  }
}
```

这个示例展示了如何使用Painless脚本增加文档的`views`字段值。

#### 四、删除文档（Delete）

删除文档是通过发送DELETE请求到指定的索引和文档ID来完成的。

##### 4.1 基本语法

```
DELETE /<index>/_doc/<id>
```

##### 示例

```
DELETE /blogposts/_doc/1
```

这个请求会删除ID为`1`的文档。

#### 五、版本控制

Elasticsearch为文档提供了乐观锁机制，通过版本号（version）来控制并发更新。在更新或删除文档时，可以指定一个版本号，以确保操作是基于文档的当前版本进行的。

##### 示例

```json
PUT /blogposts/_doc/1?version=1
{
  "title": "Elasticsearch入门与实践（更新版）",
  ...
}
```

如果文档的当前版本不是1，这个更新请求将失败。

#### 六、总结

文档的CRUD操作是Elasticsearch中最基础也是最重要的功能之一。通过掌握这些操作，你可以有效地在Elasticsearch中存储、检索、更新和删除数据。在实际应用中，根据具体需求选择合适的操作方式，可以显著提高数据处理的效率和准确性。此外，Elasticsearch还提供了丰富的API和高级特性，如批量操作、脚本更新、版本控制等，以满足更复杂的业务需求。希望本章内容能帮助你更好地理解和使用Elasticsearch的文档CRUD操作。

该分类下的相关小册推荐：

ElasticSearch零基础到实战