Elasticsearch(ES) 添加/更新映射

你的名字 2022-12-09 02:28 142阅读 0赞

原文地址：https://www.exception.site/elasticsearch/elasticsearch-add-mappings

通过 Elasticsearch API 可以向索引(Index) 添加文档类型(Type), 或者向文档类型(Type) 中添加/更新字段(Field)。

PUT http://127.0.0.1:9200/commodity

{ 
    	"mappings": { 
    		"_doc": { 
    			"properties": { 
    				"commodity_id": { 
    					"type": "long"
    				},
    				"commodity_name": { 
    					"type": "text"
    				},
    				"picture_url": { 
    					"type": "keyword"
    				}
    			}
    		}
    	}
    }

接下来，通过 Postman 工具来实际操作一下：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdmFfeHh4eA_size_16_color_FFFFFF_t_70_pic_center]  
通过上面 API, 我们创建了一个名称为 commodity(商品) 的索引，类型为\_doc, 且包含了三个字段(field), 分别为 commodity\_id（商品id）、commodity\_name (商品名称)、picture\_url（商品图片）。

## 一、向已存在的类型中添加字段 ##

commodity 索引创建成功后，我们还可以向其中添加新的字段，下面添加一个 price（价格）字段：

PUT http://127.0.0.1:9200/commodity/_mapping/_doc

入参：

{ 
    	"properties": { 
    		"price": { 
    			"type": "double"
    		}
    	}
    }

用 Postman 工具演示一下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdmFfeHh4eA_size_16_color_FFFFFF_t_70_pic_center 1]

## 二、同时向多个索引设置映射 ##

Elasticsearch 允许同时向多个索引添加文档类型。

PUT http://127.0.0.1:9200/{ index}/_mapping/{ type}
    
    { body}

{ index}: 索引可以有多种指定方式：
    逗号分隔符，比如: comodity1,commodity2；
    _all: 表示所有索引；
    commodity*：表示以 commodity 为前缀的所有索引；
    { type}: 需要添加或更新的文档类型；
    { body}：需要添加的字段或字段类型；

接下来，我们测试一下，先创建两个未设置映射的空索引 commodity1、commodity2:

PUT http://127.0.0.1:9200/commodity1

然后向这两个索引同时添加映射：

PUT http://localhost:9200/commodity1,commodity2/_mapping/_doc

入参:

{ 
    	"properties": { 
    		"commodity_id": { 
    			"type": "long"
    		},
    		"commodity_name": { 
    			"type": "text"
    		},
    		"picture_url": { 
    			"type": "keyword"
    		}
    	}
    }

使用 Postman 执行请求:  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdmFfeHh4eA_size_16_color_FFFFFF_t_70_pic_center 2]  
设置映射信息成功！

## 三、更新字段映射 ##

一些情况下，我们需要对某个索引当前类型进行更新，比如：

添加一个新的字段；
    更改原有的某个字段；
    禁用 doc_values（默认情况是开启的）;
    添加 ignore_above 参数；
    ...

Note：关于 ignore\_above 参数，若字段长度超过指定的值，则该字段不会被索引起来，也就是说查询不到。

接下来，为了演示，我们先删除之前 commodity 索引，重新建立:

PUT http://127.0.0.1:9200/commdoty

入参:

{ 
    	"mappings": { 
    		"_doc": { 
    			"properties": { 
    				"commodity_id": { 
    					"type": "long"
    				},
    				"commodity_name": { 
    					"properties": { 
    						"first": { "type": "text"}	
    					}
    				},
    				"picture_url": { 
    					"type": "keyword"
    				}
    			}
    		}
    	}
    }

需要注意，commodity\_name 字段是一个对象数据类型(Object datatype)。

对象类型指的是，这个字段是个对象，它里面还可以存储多个属性字段。

接着，索引映射新建成功后，我们尝试去更新:

PUT http://127.0.0.1:9200/commdoty/_mapping/_doc

入参:

{ 
    	"properties": { 
    		"commodity_id": { 
    			"type": "long"
    		},
    		"commodity_name": { 
    			"properties": { 
    				"last": { 
    					"type": "text"
    				}
    			}
    		},
    		"picture_url": { 
    			"type": "keyword",
    			"ignore_above": 500
    		}
    	}
    }

上述请求中，我们对 commodity\_name 对象数据类型增加了一个 last 属性，并且修改了 picture\_url 字段，将 ignore\_above设置成了 500。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdmFfeHh4eA_size_16_color_FFFFFF_t_70_pic_center 3]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdmFfeHh4eA_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/2d31043e84f443e2870cd99bedfb5304.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdmFfeHh4eA_size_16_color_FFFFFF_t_70_pic_center 1]: /images/20221123/1dcffab6dbd942d0b0cce8a5bc7ba4db.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdmFfeHh4eA_size_16_color_FFFFFF_t_70_pic_center 2]: /images/20221123/5b70600cbc724e73b39834317beebb27.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2phdmFfeHh4eA_size_16_color_FFFFFF_t_70_pic_center 3]: /images/20221123/09e7227bd0374a0cbaa31cd1e034bb5b.png