REST API

下面简单介绍下elasticsearch提供的一套api的用法：

1. 创建索引 PUT （注意，index名称里的字母必须小写）

下面创建了索引jiu3，里面配置信息重写，否则默认5个分片和一个副本，映射里写了一个type：lvh，以及两个字段。当然，大括号里这些并不是必需的。

curl -XPUT 192.168.100.15:9200/index

curl -XPUT http://192.168.100.15:9200/jiu3/ -d '{
    "settings":{
        "index":{
            "number_of_shards":1,
            "number_of_replicas":0
        }
    },
    "mappings":{
        "lvh":{
            "properties":{
                "name":{
                    "type":"string"},
                "age":{
                    "type":"long"}
            }
        }
    }
}'

curl -XPUT 192.168.100.15:9200/index/type/_mapping -d @mapping.json

其中mapping.json的内容是以下形式：

{
   "lvh":{
        "properties":{
             "name":{
                  "type":"string"},
              "age":{
                   "type":"long"}
           }
     }
}

以上都是手动添加索引映射，还有另一种方法：插入数据，根据数据自动创建索引和映射：

#以后eshost都代替192.168.100.15:9200
curl -XPUT eshost/index/type/id -d '{
        "name":"lvhuan",
        "age":"21"
}'

2. 添加文档(无则添加，有则覆盖) POST

添加文档时，可以在现有type里添加，亦可以新建一个type来添加文档。唯一标识符(_id)可写可不写。

这里需要注意的是，覆盖特效。新内容覆盖对应id所有的旧内容。

curl -XPOST eshost/jiu3/lih/1 -d '{
    "name":"huan"}'

批量添加（特别注意格式，尤其是每条记录之间的回车必不可少; 同样，id可以缺省）（另外，记录数可以等于一）

POST /_bulk
{ "index": { "_index": "addr", "_type": "contact", "_id": 1 }}
{ "name": "Fyodor Dostoevsky", "country": "RU" }
{ "create": { "_index": "addr", "_type": "contact", "_id": 2 }}
{ "name": "Erich Maria Remarque", "country": "DE" }
{ "create": { "_index": "addr", "_type": "contact", "_id": 2 }}
{ "name": "Joseph Heller", "country": "US" }
{ "delete": { "_index": "addr", "_type": "contact", "_id": 4 }}
{ "delete": { "_index": "addr", "_type": "contact", "_id": 1 }}

curl -XPOST 'localhost:9200/_bulk?pretty' --data-binary
@documents.json

其中，json文件内容就是之前那种记录排列的格式。

3. 获取索引、文档 GET

pretty是以JSON格式显示

curl -XGET http://192.168.100.15:9200/jiu3?pretty

curl -XGET http://192.168.100.15:9200/jiu3/lih/1?pretty

4. 查询文档 GET

对于字符串匹配，可模糊查询，即匹配字符串部分内容。

查询所有信息

curl -XGET http://192.168.100.15:9200/jiu3/lih/_search?pretty

curl -XGET eshost/index/type/_search -d '{
    "query":{
        "match_all":{}
     }
}'

查询，匹配单字段

curl -XGET eshost/index/type/_search?pretty&q=name:huan

curl -XGET eshost/index/type/_search -d '{
  "query":{
      "match":{
          "age":21}
    }
}'

curl -XGET eshost/index/type/_search -d '{
  "query":{
      "query_string":{
          "query":"age:21"
       }
    }
}'

匹配多字段

curl -XGET eshost/index/type/_search -d '{
  "query": {
    "bool": {
      "should": [
        { "match": { "title":  "War and Peace" }},
        { "match": { "author": "Leo Tolstoy"   }}
      ]
    }
  }
}‘

匹配单词条 这里的词条是指字段的单元，确切、未经分析的词条，即必须完全匹配。

curl -XGET eshost/index/type/_search -d '{
   "query": {
     "term": {
       "tags":"novel"
      }
  }
}‘

匹配多词条

curl -XGET eshost/index/type/_search -d '{
   "query": {
     "terms": {
       "tags":["novel","book"]
      }
  }
}‘

5.删除文档 DELETE

curl -XDELETE eshost/index/type/id

6.更新文档 POST

这里只举两个我常用的写法，其他可参看http://www.cnblogs.com/jiu0821/p/5635610.html

若下面第一个写法报错，解决方案在上面链接里可找到。

与前面覆盖文档不同，这里只需写要更新的字段即可，其他字段不写。有则更新，无则添加。

curl -XPOST eshost/index/type/id/_update -d '{
    "script":"ctx._source.name = "lv huan" "
}'

curl -XPOST eshost/index/type/id/_update -d '{
    "doc":{
       "name" = "lv huan"
    }
}'