前言

这篇文章详细介绍了如何创建索引和某个类型的映射。

下文中[address]指代elasticsearch服务器访问地址(http://localhost:9200)。

1       创建索引

1.1     简单创建语句

curl -XPUT [address]/blog

1.2     带参数的创建语句

curl -XPUT [address]/blog/ -d '{

"settings":{

"number_of_shards":1,     //设置分片数量

"number_of_replicas":2,  //设置副本数量

//自定义索引默认分析器

"index":{

"analysis":{

"analyzer":{

"default":{

"tokenizer":"standard",     //分词器

"filter":[ //过滤器

"asciifolding",

"lowercase",

"ourEnglishFilter"

]

}

},

"filter":{

"ourEnglishFilter":{

"type":"kstem"

}

}

}

}

}

}'

2       创建映射(扁平结构)

2.1     简单创建语句

curl -XPUT [address]/blog/_mapping/article?pretty -d '{

"properties":{

"id":{"type":"long"},

"name":{"type":"string"},

"published":{"type":"date"}

}

}'

2.2     带参数的创建语句

curl -XPUT [address]/blog/_mapping/article?pretty -d '{

"dynamic":"false",  //关闭自动添加字段，关闭后索引数据中如果有多余字段不会修改mapping,默认true

"_id":{"index":"not_analyzed","store":"no"},        //设置文档标识符可以被索引，默认不能被索引。可以设置为"_id":{"path":"book_id"},这样将使用字段book_id作为标识符

"_all":{"enabled":"false"},       //禁用_all字段，_all字段包含了索引中所有其他字段的所有数据，便于搜索。默认启用

"_source":{"enabled":"false"},        //禁用_source字段，_source字段在生成索引过程中存储发送到elasticsearch的原始json文档。elasticsearch部分功能依赖此字段(如局部更新功能),因此建议开启。默认启用

"_index":{"enabled":"true"},  //启用_index字段，index字段返回文档所在的索引名称。默认关闭。

"_timestamp":{"enabled":"true","index":"not_analyzed","store":"true","format":"YYYY-mm-dd"},                  //启用时间戳并设置。时间戳记录文档索引时间，使用局部文档更新功能时，时间戳也会被更新。默认未经分析编入索引但不保存。

"_ttl":{"enabled":"true","default":"30d"},     //定义文档的生命周期,周期结束后文档会自动删除。

"_routing":{"required":"true","path":"name"}      //指定将name字段作为路由，且每个文档必须指定name字段。

"properties":{

"id":{

"type":"long",

//公共属性

"store":"yes",

//数值特有属性

"precision_step":"0"       //指定为该字段生成的词条数，值越低，产生的词条数越多，查询会更快，但索引会更大。默认4

},

"name":{

"type":"string",

//公共属性

"store":"yes",

"index":"not_analyzed", //analyzed:编入索引供搜索、no:不编入索引、not_analyzed(string专有):不经分析编入索引

"boost":"1",    //文档中该字段的重要性，值越大表示越重要，默认1

"null_value":"jim",  //当索引文档的此字段为空时填充的默认值，默认忽略该字段

"include_in_all":"xxx"      //此属性是否包含在_all字段中,默认为包含

//字符串特有属性

"analyzer":"xxx",     //定义用于索引和搜索的分析器名称，默认为全局定义的分析器名称。可以开箱即用的分析器:standard,simple,whitespace,stop,keyword,pattern,language,snowball

"index_analyzer":"xxx",           //定义用于建立索引的分析器名称

"search_analyzer":"xxx",        //定义用于搜索时分析该字段的分析器名称

"ignore_above":"xxx"      //定义字段中字符的最大值，字段的长度高于指定值时，分析器会将其忽略

},

"published":{

"type":"date",

//公共属性

"store":"yes",

//日期特有属性

"precision_step":"0",      //指定为该字段生成的词条数，值越低，产生的词条数越多，查询会更快，但索引会更大。默认4

"format":"YYYY-mm-dd"          //指定日期格式，默认为dateOptionalTime

}

}

}'

3       创建映射(非扁平结构)

在第二章我们讲解了创建映射的语句。所创建的是简单的扁平结构映射。这一章我们看看如何创建非扁平结构映射。

3.1     树形结构

树形结构的作用是为索引层级路径提供便利。例如一家汽车店中可能会有如下路径:/cars/passenger/sport、/cars/passenger/camper、/cars/delivery_truck,我们想在搜索cars的时候返回三条记录，搜索cars/passenger的时候返回前两条记录，可以这样建立映射:

curl -XPUT [address]/path -d '{

"settings":{

//定义一个路径分析器

"index":{

"analysis":{

"analyzer":{

"path_analyzer":{"tokenizer":"path_hierarchy"}

}

}

}

},

"mappings":{

"category":{

"properties":{

"category":{

"type":"string",

"fields":{

//定义多字段对象，使用category.path进行查询时将启用路径分析匹配指定路径下的所有文档，使用category.name进行查询时将精确匹配指定路径的文档，略过结构更深的文档。

"name":{"type":"string","index":"not_analyzed"},

"path":{"type":"string","analyzer":"path_analyzer","store":true}

}

}

}

}

}

}'

3.2     对象

先执行curl –XPUT [address]/extend_mapping，创建extend_mapping索引

创建一个带有对象属性author的类型book:

curl –XPUT [address]/extend_mapping/_mapping/book –d ‘{

"properties":{

"title":{"type":"string","index":"not_analyzed"},

"author":{

"type":"object",

"properties":{

"firstName":{"type":"string","index":"not_analyzed"},

"lastName":{"type":"string","index":"not_analyzed"}

}

}

}

}’

3.3     嵌套对象

嵌套对象允许我们连接一个主文档和多个附属文档，下面通过一个例子来说明嵌套对象的应用场景。

现在我们有一个服装店，需要设计一个数据结构来存储服装店里的服装信息。例如现在有一种名字为”cloth”的服装，这件服装现有两件存货，一件XXL的红色和一件XL的黑色,请设计一个数据结构来存储该服装信息。

我们可能会把数据结构设计成这样:

{

“name”:”cloth”,

“variation”:[

{“size”:”XXL”,”color”:”red”},

{“size”:”XL”,”color”:”black”}

]

}

直观的来看，这个数据结构是能够表现我们所描述的服装信息的，我们依据这个结构创建以下映射(发送rest请求语句略):

{

"properties":{

"name":{"type":"string","index":"not_analyzed"},

"variation":{

"properties":{

"size":{"type":"string","index":"not_analyzed"},

"color":{"type":"string","index":"not_analyzed"}

}

}

}

}

建立映射后索引以下数据:

{

"name": "cloth",

"variation": [

{

"size": "XXL",

"color": "red"

},

{

"size": "XL",

"color": "black"

}

]

}

下面我们查询一下我们的服装信息库，看看是否有尺寸为XXL,颜色为black的服装:

{

"filter": {

"and": [

{

"term": {

"variation.size": "XXL"

}

},

{

"term": {

"variation.color": "black"

}

}

]

}

}

出乎意料的是，该查询返回了结果:

{

......(此处信息略去)

"hits": {

"total": 1,

"max_score": 1,

"hits": [

{

"_index": "extend_mapping",

"_type": "unnested_cloth",

"_id": "AVACnlA-8eAUpvGq_eZa",

"_score": 1,

"_source": {

"name": "cloth",

"variation": [

{

"size": "XXL",

"color": "red"

},

{

"size": "XL",

"color": "black"

}

]

}

}

]

}

}

这与我们的预期不符，我们只有XXL红色和XL黑色两件服装，并没有所查询的XXL黑色服装。

这是因为按照我们之前定义的映射结构，尺寸信息(“size”:”XXL”,”size”:”XL”)和颜色信息(“color”:”red”,”color”:”black”)都存在同一个文档中,ES无法将XXL和red、XL和black绑定在一起，因此在查询时造成了混淆。

解决的方法就是使用嵌套对象，将variation对象的类型指定为嵌套:

重新创建以下映射:

{

"properties":{

"name":{"type":"string","index":"not_analyzed"},

"variation":{

“type”:”nested”,

"properties":{

"size":{"type":"string","index":"not_analyzed"},

"color":{"type":"string","index":"not_analyzed"}

}

}

}

}

索引之前的测试数据:

{

"name": "cloth",

"variation": [

{

"size": "XXL",

"color": "red"

},

{

"size": "XL",

"color": "black"

}

]

}

现在我们通过”type”:”nested”将variation对象指定为嵌套对象，需要注意的是，如果我们对新映射执行类似之前的查询，将无任何文档返回。因为对于嵌套映射，必须要使用专用的查询语法，如下:

{

"filter": {

"nested": {

"path": "variation",

"filter": {

"and": [

{

"term": {

"variation.size": "XXL"

}

},

{

"term": {

"variation.color": "black"

}

}

]

}

}

}

}

这次的查询如我们的预期，没有返回结果。这是因为使用嵌套结构后，当我们索引测试数据时，事实上ES生成了3个文档，一个cloth的主文档，和两个variation对象的附属文档，这样就分离存储了两件服装存货，避免了尺寸和颜色的混淆。

from: http://www.cnblogs.com/sheeva/p/4837881.html