es 中使用update 、create 、index的区别

文章目录

- - 1. `index` 操作
  - - 示例：`index` 操作
    - Bulk 示例中的 `index` 操作：
  - 2. `create` 操作
  - - 示例：`create` 操作
    - Bulk 示例中的 `create` 操作：
  - 3. `update` 操作
  - - 示例：`update` 操作
    - Bulk 示例中的 `update` 操作：
  - 4. 区别总结
  - 总结

在 Elasticsearch 中， index、 update 和 create 是常用的操作类型，它们用于不同的场景，且具有不同的行为。下面详细解释这三个操作的区别，并提供相关的示例。

1. `index` 操作

功能：index 操作用于插入文档，如果文档的 _id 已经存在，则会覆盖该文档（即进行替换）。
使用场景：适用于需要插入新文档，或者更新已有文档的场景。
注意：index 操作是幂等的（idempotent）。即使你多次执行相同的操作，只要文档内容没有变化，最终结果不会受到影响。

示例：`index` 操作

POST /articles/_doc/1
{"title": "Tech News Today","tags": ["tech", "news", "AI"]
}

如果 _id 为 1 的文档不存在，则会插入一个新的文档。

POST /articles/_search[{"_index" : "articles","_type" : "_doc","_id" : "1","_score" : 1.0,"_source" : {"title" : "Tech News Today","tags" : ["tech","news","AI"]}}
]

如果 _id 为 1 的文档已存在，则会被替换为新的文档。

POST /articles/_doc/1
{"title": "Tech News Today"
}POST /articles/_search[{"_index" : "articles","_type" : "_doc","_id" : "1","_score" : 1.0,"_source" : {"title" : "Tech News Today"}}
]

Bulk 示例中的 `index` 操作：

{ "index": { "_id": 1 } }
{ "title": "Tech News Today", "tags": ["tech", "news", "AI"] }

2. `create` 操作

功能：create 操作用于插入新文档。如果文档的 _id 已经存在，操作会失败（返回错误）。这意味着该操作只能用于创建新文档，而不能更新或替换已有文档。
使用场景：适用于你想要确保文档不存在时插入文档的情况。比如避免覆盖现有的文档。

示例：`create` 操作

POST /articles/_doc/1/_create
{"title": "Tech News Today","tags": ["tech", "news", "AI"]
}

如果 _id 为 1 的文档已存在，Elasticsearch 会返回错误，提示该文档已经存在。

{"error" : {"root_cause" : [{"type" : "version_conflict_engine_exception","reason" : "[1]: version conflict, document already exists (current version [2])","index_uuid" : "mu6PYHhxTRSOOOjSZoPmaQ","shard" : "0","index" : "articles"}],"type" : "version_conflict_engine_exception","reason" : "[1]: version conflict, document already exists (current version [2])","index_uuid" : "mu6PYHhxTRSOOOjSZoPmaQ","shard" : "0","index" : "articles"},"status" : 409
}

如果 _id 为 1 的文档不存在，它将会被插入。

Bulk 示例中的 `create` 操作：

{ "create": { "_id": 1 } }
{ "title": "Tech News Today", "tags": ["tech", "news", "AI"] }

3. `update` 操作

功能：update 操作用于更新已有的文档。如果文档存在，它会更新文档的部分内容；如果文档不存在，则会抛出错误。
使用场景：适用于部分更新文档的场景，特别是当你只需要更新文档的一部分字段时。update 操作不会覆盖整个文档，只会对指定字段进行修改。

示例：`update` 操作

POST /articles/_doc/1/_update
{"doc": {"tags": ["tech", "news", "AI", "machine learning"]}
}

如果 _id 为 1 的文档存在，tags 字段将会被更新为新的值。

POST /articles/_search[{"_index" : "articles","_type" : "_doc","_id" : "1","_score" : 1.0,"_source" : {"title" : "Tech News Today","tags" : ["tech","news","AI","machine learning"]}}
]

如果 _id 为 1 的文档不存在，Elasticsearch 会返回错误。

DELETE articlesPOST /articles/_doc/1/_update
{"doc": {"tags": ["tech", "news", "AI", "machine learning"]}
}{"error" : {"root_cause" : [{"type" : "document_missing_exception","reason" : "[_doc][1]: document missing","index_uuid" : "B9MrCqCwT5u-GCvgdWB-Rw","shard" : "0","index" : "articles"}],"type" : "document_missing_exception","reason" : "[_doc][1]: document missing","index_uuid" : "B9MrCqCwT5u-GCvgdWB-Rw","shard" : "0","index" : "articles"},"status" : 404
}

Bulk 示例中的 `update` 操作：

{ "update": { "_id": 1 } }
{ "doc": { "tags": ["tech", "news", "AI", "machine learning"] } }

4. 区别总结

操作类型	目标	说明	示例
`index`	插入或替换	文档插入，如果文档已经存在则会被替换。	`POST /articles/_doc/1`
`create`	插入	仅在文档不存在时插入文档，如果文档已存在，则返回错误。	`POST /articles/_doc/1/_create`
`update`	更新	仅更新文档的一部分内容，文档必须存在。如果文档不存在，则返回错误。	`POST /articles/_doc/1/_update`