当前位置：首页 > news >正文

【Elasticsearch】index.mapping.source.mode

news 来源：原创 2025/6/6 6:59:38

在Elasticsearch中，当设置 `index.mapping.source.mode` 为 `synthetic` 时，Elasticsearch会自动生成和存储源文档的合成版本。这些合成版本的内容取决于你索引的字段和映射定义。具体来说，`synthetic` 模式会存储以下内容：

### 合成源文档的内容

1. **字段名称和值**：

- **字段名称**：所有字段的名称都会被存储。

- **字段值**：对于基本类型（如字符串、数字、布尔值等），字段的值会被存储。

- **复杂类型**：对于对象和嵌套字段，Elasticsearch会存储字段的结构信息，但不会存储完整的原始值。

2. **元数据**：

- **字段类型**：每个字段的类型信息会被存储。

- **字段属性**：字段的索引属性（如是否索引、是否存储等）会被记录。

3. **索引和存储信息**：

- **索引信息**：哪些字段被索引，以及索引的类型（如 `text`、`keyword`、`date` 等）。

- **存储信息**：哪些字段被存储，以便后续查询时可以直接访问。

### 示例

假设你有一个文档如下：

```json

{

"title": "Example Document",

"content": "This is an example document.",

"author": {

"name": "John Doe",

"email": "john.doe@example.com"

"tags": ["example", "document", "test"]

}

```

#### 1. 创建索引

```json

PUT idx

{

"settings": {

"index": {

"mapping": {

"source": {

"mode": "synthetic"

}

"mappings": {

"properties": {

"title": { "type": "text" },

"content": { "type": "text" },

"author": {

"properties": {

"name": { "type": "text" },

"email": { "type": "keyword" }

}

"tags": { "type": "keyword" }

}

```

#### 2. 索引文档

```json

POST idx/_doc/1

{

"title": "Example Document",

"content": "This is an example document.",

"author": {

"name": "John Doe",

"email": "john.doe@example.com"

"tags": ["example", "document", "test"]

}

```

#### 3. 获取文档

当你尝试获取文档时，Elasticsearch会返回合成版本的源文档：

```json

GET idx/_doc/1

```

返回的合成源文档可能类似于以下内容：

```json

{

"_index": "idx",

"_id": "1",

"_source": {

"title": "Example Document",

"content": "This is an example document.",

"author": {

"name": "John Doe",

"email": "john.doe@example.com"

"tags": ["example", "document", "test"]

}

```

### 合成源文档的特点

1. **字段值**：

- 对于基本类型（如字符串、数字、布尔值等），字段的值会被存储。

- 对于复杂类型（如对象和嵌套字段），Elasticsearch会存储字段的结构信息，但不会存储完整的原始值。

2. **元数据**：

- 字段的类型信息和属性会被存储。

- 索引和存储信息会被记录。

3. **存储效率**：

- 合成源文档通常比完整的原始源文档占用更少的存储空间。

- 但某些查询和操作可能会受到限制，因为无法直接访问原始的完整源文档。

### 总结

`synthetic` 模式下的合成源文档会存储字段名称、值、元数据和索引信息。这种模式可以显著减少存储空间，但可能会限制某些查询和操作的功能。如果你需要频繁地访问和修改原始文档的完整内容，建议使用 `full` 模式。

相关文章：