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

1、Mapping设置

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

1.1 增加新的字段到索引中

增加一个new_name到已经存在的索引new_index中，操作如下：

PUT /new_index/_mapping {   "properties":{     "phone_number": {       "type": "keyword"     }   } }

响应：

{   "acknowledged" : true }

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

1.2 增加字段到多个索引中

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

PUT /new_index,new_index_2/_mapping {   "properties":{     "phone_number": {       "type": "keyword"     }   } }

响应：

{   "acknowledged" : true }

表示操作成功。

​​​​​​​1.3 更新索引中的字段

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

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

1.4 操作示例

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

PUT /update_field_test {   "mappings": {     "properties": {       "address": {         "properties": {           "home_address": {             "type": "text"           }         }       },       "name": {         "type": "keyword"       }     }   } }

 

2）修改address字段，在其中增加company_address字段，并同时修改name字段的ignore_above属性，操作如下：

PUT /update_field_test/_mapping {   "properties": {     "address": {       "properties": {         "company_address": {           "type": "text"         }       }     },     "name": {       "type": "keyword",       "ignore_above": 200     }   } }

 

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

GET /update_field_test {   "update_field_test" : {     "aliases" : { },     "mappings" : {       "properties" : {         "address" : {           "properties" : {             "company_address" : {               "type" : "text"             },             "home_address" : {               "type" : "text"             }           }         },         "name" : {           "type" : "keyword",           "ignore_above" : 200         }       } }, ...//省略其它的 }

        可以看到新的字段company_address已经成功加入了，name的ignore_above属性也被更新了。

​​​​​​​2. 查看mapping

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

GET /update_field_test/_mapping

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

GET /update_field_test,new_index/_mapping

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

{   "new_index" : {     "mappings" : {       "properties" : {         ...       }     }   },   "update_field_test" : {     "mappings" : {       "properties" : {         ...       }     }   } }

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

GET /_all/_mapping #或 GET /_mapping

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

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

GET /update_field_test/_mapping/field/name

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

GET /update_field_test,new_index/_mapping/field/name,name1

响应：

{   "new_index" : {     "mappings" : { }   },   "update_field_test" : {     "mappings" : {       "name" : {         "full_name" : "name",         "mapping" : {           "name" : {             "type" : "keyword",             "ignore_above" : 200           }         }       }     }   } }

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