Elasticsearch索引的基本操作(4)-Mapping设置

叁歲伎倆 2022-01-14 02:59 482阅读 0赞

# 1、**Mapping设置** #

Mapping设置API \_mapping ，允许增加新的字段到指定索引中，或在满足一定的条件下修改已经存在的字段，需要使用PUT方法。

## 1.1 **增加新的字段到索引中** ##

增加一个new\_name到已经存在的索引new\_index中，操作如下：

<table style="margin-left:28.05pt;width:398.05pt;"> 
 <tbody> 
 <tr> 
 <td style="width:398.05pt;"> PUT /new_index/_mapping { &nbsp;&nbsp;"properties":{ &nbsp;&nbsp;&nbsp;&nbsp;"phone_number": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type": "keyword" &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

响应：

表示操作成功，可以通过前面学的GET方法查看字段是否被成功到索引中。

## **1.2 增加字段到多个索引中** ##

如果涉及到要增加相同字段的索引较多，Elasticsearch同时往多个索引中增加相同的字段，以下示例同时在new\_index和new\_index\_2中增加字段，操作如下：

<table style="margin-left:28.05pt;width:398.05pt;"> 
 <tbody> 
 <tr> 
 <td style="width:398.05pt;"> PUT /new_index,new_index_2/_mapping { &nbsp;&nbsp;"properties":{ &nbsp;&nbsp;&nbsp;&nbsp;"phone_number": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type": "keyword" &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

响应：

表示操作成功。

## 1.3 **更新索引中的字段** ##

通常情况下，索引中的已经存在的字段是不可以被更新的，如果字段要被更新，须满足以下的条件：

*  被修改的字段为Object数据类型字段，可以为其增加新的属性；
 *  可以将新的多字段添加到现有字段中；
 *  字段的ignore\_above（指长度超过ignore\_above配置值的字符串，不会被索引或存储）参数值可以被更新；

## **1.4 操作示例** ##

1）先建立一个索引update\_field\_test，通过mapping指定其中的address字段是Object数据类型、指定name字段为keyword类型，如下所示：

<table style="margin-left:28.05pt;width:398.05pt;"> 
 <tbody> 
 <tr> 
 <td style="width:398.05pt;"> PUT /update_field_test { &nbsp;&nbsp;"mappings": { &nbsp;&nbsp;&nbsp;&nbsp;"properties": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"address": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"properties": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"home_address": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type": "text" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"name": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type": "keyword" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

2）修改address字段，在其中增加company\_address字段，并同时修改name字段的ignore\_above属性，操作如下：

<table style="margin-left:28.05pt;width:398.05pt;"> 
 <tbody> 
 <tr> 
 <td style="width:398.05pt;"> PUT /update_field_test/_mapping { &nbsp;&nbsp;"properties": { &nbsp;&nbsp;&nbsp;&nbsp;"address": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"properties": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"company_address": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type": "text" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;"name": { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type": "keyword", &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"ignore_above": 200 &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

3）通过GET方法查看字段是否被成功加入和修改：

<table style="margin-left:28.05pt;width:398.05pt;"> 
 <tbody> 
 <tr> 
 <td style="width:398.05pt;"> GET /update_field_test { &nbsp;&nbsp;"update_field_test" : { &nbsp;&nbsp;&nbsp;&nbsp;"aliases" : { }, &nbsp;&nbsp;&nbsp;&nbsp;"mappings" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"properties" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"address" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"properties" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"company_address" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type" : "text" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"home_address" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type" : "text" &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;}, &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"name" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type" : "keyword", &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"ignore_above" : 200 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} }, ...//省略其它的 } </td> 
 </tr> 
 </tbody> 
</table>

可以看到新的字段company\_address已经成功加入了，name的ignore\_above属性也被更新了。

# 2. **查看mapping** #

1）查看单个索引的mapping，如下所示：

<table style="margin-left:28.05pt;width:398.05pt;"> 
 <tbody> 
 <tr> 
 <td style="width:398.05pt;"> GET /update_field_test/_mapping </td> 
 </tr> 
 </tbody> 
</table>

2）也可以同时查看多个索引的mapping，索引之间与英文逗号“,”做分隔，如下所示：

<table style="margin-left:28.05pt;width:398.05pt;"> 
 <tbody> 
 <tr> 
 <td style="width:398.05pt;"> GET /update_field_test,new_index/_mapping </td> 
 </tr> 
 </tbody> 
</table>

每个索引的mapping都会归属到该索引下，返回的结构如下：

<table style="margin-left:28.05pt;width:398.05pt;"> 
 <tbody> 
 <tr> 
 <td style="width:398.05pt;"> { &nbsp;&nbsp;"new_index" : { &nbsp;&nbsp;&nbsp;&nbsp;"mappings" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"properties" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;... &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;}, &nbsp;&nbsp;"update_field_test" : { &nbsp;&nbsp;&nbsp;&nbsp;"mappings" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"properties" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;... &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

3）查看所有索引的mapping，如下所示：

<table style="margin-left:28.05pt;width:398.05pt;"> 
 <tbody> 
 <tr> 
 <td style="width:398.05pt;"> GET /_all/_mapping #或 GET /_mapping </td> 
 </tr> 
 </tbody> 
</table>

返回的结构和上面返回多个mapping的结构是相同的。

4）查看索引中指定字段的mapping，如下所示：

<table style="margin-left:28.05pt;width:398.05pt;"> 
 <tbody> 
 <tr> 
 <td style="width:398.05pt;"> GET /update_field_test/_mapping/field/name </td> 
 </tr> 
 </tbody> 
</table>

5）查看多个索引中多个字段的mapping，多个索引和多个字段，都以英文逗号“,”做为分隔符，如下所示：

响应：

<table style="margin-left:28.05pt;width:398.05pt;"> 
 <tbody> 
 <tr> 
 <td style="width:398.05pt;"> { &nbsp;&nbsp;"new_index" : { &nbsp;&nbsp;&nbsp;&nbsp;"mappings" : { } &nbsp;&nbsp;}, &nbsp;&nbsp;"update_field_test" : { &nbsp;&nbsp;&nbsp;&nbsp;"mappings" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"name" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"full_name" : "name", &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"mapping" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"name" : { &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"type" : "keyword", &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;"ignore_above" : 200 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;&nbsp;&nbsp;} &nbsp;&nbsp;} } </td> 
 </tr> 
 </tbody> 
</table>

New\_index没有字段name和name1，update\_field\_test中有字段name但没有name1，根据响应可以看出，如果字段不存在，则不显示mapping结果，存在则显示，这里不会报错。