ElasticSearsh--分布式搜索和分析引擎（二）之RestFulAPI使用说明

0 说明

本节重点说明Elasticsearsh的RESTFulAPI详细使用
ElaaticSearsh集群部署详见我另一篇文章《ElasticSearsh–分布式搜索和分析引擎（一）之安装与介绍》

1 格式

http://your_ipaddr:9200/<index>/<type>/[<id>]

其中index、type是必须提供的。
id是可选的，不提供es会自动生成。
index、type将信息进行分层，利于管理。
index可以理解为数据库；type理解为数据表；id相当于数据库表中记录的主键，是唯一的。

2 示例

2.1 向store索引中添加一些书籍

在任意节点执行，可以在任意节点查询到，在不同节点输入执行该命令时，替换不同的ip。

curl -XPUT 'http://192.168.218.100:9200/store/books/1' -d '{
  "title": "Elasticsearch: The Definitive Guide",
  "name" : {
    "first" : "Zachary",
    "last" : "Tong"
  },
  "publish_date":"2015-02-06",
  "price":"49.99"
}'

在linux中通过curl的方式查询

curl -XGET 'http://192.168.218.100:9200/store/books/1'

#通过浏览器查询

http://192.168.218.100:9200/store/books/1

在就群中任意一台启停机器执行查询命令

curl -XGET 'http://192.168.218.101:9200/store/books/1'

可查询到相同的结果

2.2 再添加一个书的信息

curl -XPUT 'http://192.168.218.100:9200/store/books/2' -d '{
  "title": "Elasticsearch Blueprints",
  "name" : {
    "first" : "Vineeth",
    "last" : "Mohan"
  },
  "publish_date":"2015-06-06",
  "price":"35.99"
}'

通过_source获取指定的字段

curl -XGET 'http://192.168.218.100:9200/store/books/1?_source=title'

curl -XGET 'http://192.168.218.101:9200/store/books/1?_source=title,price'

curl -XGET 'http://192.168.218.102:9200/store/books/1?_source'

2.3 可以通过覆盖的方式更新

curl -XPUT 'http://192.168.218.104:9200/store/books/1' -d '{
  "title": "Elasticsearch: The Definitive Guide",
  "name" : {
    "first" : "Zachary",
    "last" : "Tong"
  },
  "publish_date":"2016-02-06",
  "price":"99.99"
}'

2.4 或者通过 _update API的方式单独更新

curl -XPOST 'http://192.168.218.100:9200/store/books/1/_update' -d '{
  "doc": {
     "price" : 88.88
  }
}'

#查询更新后的内容

curl -XGET 'http://192.168.218.103:9200/store/books/1'

#查询
以下sql语句等价于curl查询语句

SELECT * FROM books WHERE price = 35.99

curl -XGET 'http://192.168.218.100:9200/store/books/_search' -d '{
  "query": {
    "bool": {
      "must": {
        "match_all": {}
      },
      "filter": {
        "term": {
          "price": 35.99
        }
      }
    }
  }
}'

curl -XGET 'http://192.168.218.102:9200/store/books/_search' -d '{
    "query": {
        "bool": {
           "filter" : {
                "term" : {
                  "price" : 35.99
                }
            }
        }
    }
}'

以后会进行相关度排序，得分越高排的越靠前。
#指定多个值

curl -XGET 'http://192.168.218.103:9200/store/books/_search' -d '{
    "query" : {
        "bool" : {
            "filter" : {
                "terms" : {
                    "price" : [35.99, 99.99]
                  }
              }
        }
    }
}'

以下sql语句等价于curl

SELECT * FROM books WHERE publish_date = "2015-02-06"

curl -XGET 'http://192.168.218.100:9200/store/books/_search' -d '{
  "query" : {
    "bool" : {
        "filter" : {
           "term" : {
              "publish_date" : "2015-02-06"
            }
          }
      }
  }
}'

#bool过滤查询，可以做组合过滤查询

SELECT * FROM books WHERE (price = 35.99 OR price = 99.99) AND publish_date != "2016-02-06"`

#类似的，Elasticsearch也有 and, or, not这样的组合条件的查询方式
#格式如下：
#{
#“bool” : {
#“must” : [],
#“should” : [],
#“must_not” : [],
#}
#}
#must: 条件必须满足，相当于 and
#should: 条件可以满足也可以不满足，相当于 or
#must_not: 条件不需要满足，相当于 not

curl -XGET 'http://192.168.218.104:9200/store/books/_search' -d '{
  "query" : {
    "bool" : {
      "should" : [
        { "term" : {"price" : 35.99}},
        { "term" : {"price" : 99.99}}
      ],
      "must_not" : {
        "term" : {"publish_date" : "2016-02-06"}
      }
    }
  }
}'

2.5 嵌套查询

以下sql查询命令查询等价于curl

SELECT * FROM books WHERE price = 35.99 OR ( publish_date = "2016-02-06" AND price = 99.99 )

curl -XGET 'http://192.168.218.101:9200/store/books/_search' -d '{
    "query": {
        "bool": {
            "should": [
                {
                    "term": {
                        "price": 35.99
                    }
                },
                {
                    "bool": {
                        "must": [
                            {
                                "term": {
                                    "publish_date": "2016-02-06"
                                }
                            },
                            {
                                "term": {
                                    "price": 99.99
                                }
                            }
                        ]
                    }
                }
            ]
        }
    }
}'

2.6 range范围过滤

#SELECT * FROM books WHERE price >= 10 AND price < 99
#gt : > 大于
#lt : < 小于
#gte : >= 大于等于
#lte : <= 小于等于

curl -XGET 'http://192.168.218.100:9200/store/books/_search' -d '{
    "query": {
        "range" : {
            "price" : {
                "gte" : 10,
                "lt" : 99
            }
        }
    }
}’

#name和author都必须包含Guide，并且价钱等于33.99或者188.99

curl -XGET 'http://192.168.218.102:9200/store/books/_search' -d '{
    "query": {
        "bool": {
            "must": {
                "multi_match": {
                    "operator": "and",
                    "fields": [
                        "name",
                        "author"
                    ],
                    "query": "Guide"
                }
            },
            "filter": {
                "terms": {
                    "price": [
                        35.99,
                        188.99
                    ]
                }
            }
        }
    }
}'