Elasticsearch 2.3.0 索引映射管理

增加映射

API允许你向索引(index)添加文档类型(type)，或者向文档类型(type)中添加字段(field)。

PUT secisland
{
  "mappings": {
    "log": {
      "properties": {
        "message": {
          "type": "string"
        }
      }
    }
  }
}

添加索引名为secisland，文档类型为log，其中包含字段message，字段类型是字符串。

PUT secisland/_mapping/user

{
  "properties": {
    "name": {
      "type": "string"
    }
  }
}

向已经存在的索引secisland添加文档类型为user，包含字段name，字段类型是字符串。

PUT secisland/_mapping/log

{
  "properties": {
    "user_name": {
      "type": "string"
    }
  }
}

已经存在的索引secisland，文档类型为log，添加新的字段user_name，字段类型是字符串。

多个索引设置映射,可以一次向多个索引添加文档类型

PUT /{index}/_mapping/{type}
{ body }

{index}可以有多种方式,逗号分隔，比如test1,test2,test3

_all,表示所有索引，通配符，*表示所有，test*表示以test开头

{type}需要添加或更新的文档类型

{body}需要添加的字段或字段类型

更新字段映射

在一般情况下，对现有字段的映射不会更新。对这个规则有一些例外。例如：

新的属性被添加到对象数据类型的字段。

新的多域字段被添加到现有的字段。

doc_values可以被禁用。

增加了ignore_above参数。

例如：

请求：PUT my_index

参数:

 {
  "mappings": {
    "user": {
      "properties": {
        "name": {
          "properties": {
            "first": {
              "type": "string"
            }
          }
        },
        "user_id": {
          "type": "string",
          "index": "not_analyzed"
        }
      }
    }
  }
 }

user的第一个name属性是对象数据类型(Object datatype)字段，对上个索引进行修改：

请求：PUT my_index/_mapping/user

参数：

{
  "properties": {
    "name": {
      "properties": {
        "last": { 
          "type": "string"
        }
      }
    },
    "user_id": {
      "type": "string",
      "index": "not_analyzed",
      "ignore_above": 100 
    }
  }
}

修改映射，对第一个对象数据类型增加了一个熟悉是last。修改了user_id, 通过设置ignore_above使默认的更新为0。

不同类型之间的冲突

在同一个索引的不同类型(type)中，相同名称的字段中必须有相同的映射，因为他们内部是在同一个领域内，如果试图在这种情况下更新映射参数，系统将会抛出异常。除非在更新的时候指定 update_all_types参数。在这种情况下它将更新在相同的指标参数在所有同名的字段。

例如：

请求：PUT my_index

参数：

{
  "mappings": {
    "type_one": {
      "properties": {
        "text": { 
          "type": "string",
          "analyzer": "standard"
        }
      }
    },
    "type_two": {
      "properties": {
        "text": { 
          "type": "string",
          "analyzer": "standard"
        }
      }
    }
  }
}

修改映射

请求：PUT my_index/_mapping/type_one

参数：

{
  "properties": {
    "text": {
      "type": "string",
      "analyzer": "standard",
      "search_analyzer": "whitespace"
    }
  }
}

这个时候会抛出异常，然后增加参数，update_all_types，这个时候会同时更新两个类型。

请求：PUT my_index/_mapping/type_one?update_all_types

 {
  "properties": {
    "text": {
      "type": "string",
      "analyzer": "standard",
      "search_analyzer": "whitespace"
    }
  }
}

获取映射

获取文档映射接口允许通过索引或者索引和类型来检索。

curl -XGET 'http://localhost:9200/twitter/_mapping/tweet'

系统同时支持获取多个索引和类型的语法：

获取文档映射接口一次可以获取多个索引或文档映射类型。该接口通常是如下格式：

host:port/{index}/_mapping/{type}，{index}和{type}可以接受逗号(,)分隔符，也可以使用_all来表示全部索引。如下所示：

curl -XGET 'http://localhost:9200/_mapping/twitter,kimchy'

curl -XGET 'http://localhost:9200/_all/_mapping/tweet,book'

第一个省略_all，第二个使用_all都是表示全部索引。也就是说，下面两个是等价的：

curl -XGET 'http://localhost:9200/_all/_mapping'

curl -XGET 'http://localhost:9200/_mapping'

获取字段映射

获取文档字段接口允许你检索一个或多个字段。这个用来检索想要检索的字段，而不是某个索引或者文档类型的全部内容。

这段请求只返回字段为text的内容：

curl -XGET 'http://localhost:9200/twitter/_mapping/tweet/field/text'

响应结果如下（假定text为String类型）

{
   "twitter": {
      "tweet": {
         "text": {
            "full_name": "text",
            "mapping": {
               "text": { "type": "string" }
            }
         }
      }
   }
}

获取多索引和类型的字段映射。

获取文档字段映射接口一次可以获取多个索引或文档映射类型。该接口通常是如下格式：host:port/{index}/{type}/_mapping/field/{field}

{index}，{type}，{field}可以使用逗号(,)分隔，也可以使用*作为通配符{type}，{field}可以使用逗号(,)分隔。

其中{index}可以使用_all表示全部索引，示例如下：

curl -XGET 'http://localhost:9200/twitter,kimchy/_mapping/field/message'

curl -XGET 'http://localhost:9200/_all/_mapping/tweet,book/field/message,user.id'

curl -XGET 'http://localhost:9200/_all/_mapping/tw*/field/*.id'

指定字段

获取文档字段接口，可以使用逗号(,)分隔符或者通配符(*)。

如下文档示例，如果只使用字段名id会产生歧义。

{
     "article": {
         "properties": {
             "id": { "type": "string" },
             "title":  { "type": "string"},
             "abstract": { "type": "string"},
             "author": {
                 "properties": {
                     "id": { "type": "string" },
                     "name": { "type": "string" }
                 }
             }
         }
     }
 }

如果想要表示author中的id，name，使用author.id，author.name。请求如下：

curl -XGET "http://localhost:9200/publications/_mapping/article/field/

author.id,abstract,author.name"

返回结果如下：

{
   "publications": {
      "article": {
         "abstract": {
            "full_name": "abstract",
            "mapping": {
               "abstract": { "type": "string" }
            }
         },
         "author.id": {
            "full_name": "author.id",
            "mapping": {
               "id": { "type": "string" }
            }
         },
         "author.name": {
            "full_name": "author.name",
            "mapping": {
               "name": { "type": "string" }
            }
         }
      }
   }
}