Elasticsearch Demo

索引一个文档，使用自己的ID

hadoop@tinylcy:~$ curl -XPUT localhost:9200/website/blog/123 -d '
> {
>     "title" : "My first blog entry",
>     "text" : "Just trying this out...",
>     "date" : "2014/01/01"
> }
> '
{"_index":"website","_type":"blog","_id":"123","_version":1,"created":true}

索引一个文档，自增ID

hadoop@tinylcy:~$ curl -XPOST localhost:9200/website/blog/ -d '
> {
>     "title" : "My second blog entry",
>     "text" : "Still trying this out...",
>     "date" : "2014/01/01"
> }
> '
{"_index":"website","_type":"blog","_id":"AU8wPJKqtV1hoSdW50dt","_version":1,"created":true}

检索文档

hadoop@tinylcy:~$ curl -XGET localhost:9200/website/blog/123?pretty
{
  "_index" : "website",
  "_type" : "blog",
  "_id" : "123",
  "_version" : 1,
  "found" : true,
  "_source":
{
    "title" : "My first blog entry",
    "text" : "Just trying this out...",
    "date" : "2014/01/01"
}

}

hadoop@tinylcy:~$ curl -i -XGET localhost:9200/website/blog/124?pretty
HTTP/1.1 404 Not Found
Content-Type: application/json; charset=UTF-8
Content-Length: 83

{
  "_index" : "website",
  "_type" : "blog",
  "_id" : "124",
  "found" : false
}

检索文档的一部分

通常，GET 请求将返回文档的全部,存储在 _source 参数中。但是可能你感兴趣的字段只是 title 。请求个别字段可以使用 _source 参数。多个字段可以使用逗号分隔。

hadoop@tinylcy:~$  curl -XGET localhost:9200/website/blog/123?_source=title,text 
{"_index":"website","_type":"blog","_id":"123","_version":1,"found":true,"_source":{"text":"Just trying this out...","title":"My first blog entry"}}

或者你只想得到 _source 字段而不要其他的元数据,你可以这样请求:

hadoop@tinylcy:~$ curl -XGET localhost:9200/website/blog/123/_source

{
    "title" : "My first blog entry",
    "text" : "Just trying this out...",
    "date" : "2014/01/01"
}

检查文档是否存在

如果你想做的只是检查文档是否存在——你对内容完全不感兴趣——使用 HEAD 方法来代替 GET 。HEAD 请求不会返回响应体,只有HTTP头:

hadoop@tinylcy:~$ curl -i -XHEAD localhost:9200/website/blog/123
HTTP/1.1 200 OK
Content-Type: text/plain; charset=UTF-8
Content-Length: 0

hadoop@tinylcy:~$ curl -i -XHEAD localhost:9200/website/blog/124
HTTP/1.1 404 Not Found
Content-Type: text/plain; charset=UTF-8
Content-Length: 0

更新整个文档

文档在Elasticsearch中是不可变的——我们不能修改他们。如果需要更新已存在的文档,我们可以使用 index API 重建索引(reindex) 或者替换掉它。

hadoop@tinylcy:~$ curl -XPUT localhost:9200/website/blog/123 -d '
> {
>     "title" : "My first bolg entry",
>     "text" : "I am starting get the hang of this...",
>     "date" : "2014/01/02"
> }
> '
{"_index":"website","_type":"blog","_id":"123","_version":2,"created":false}

在响应中,我们可以看到Elasticsearch把 _version 增加了。
created 标识为 false 因为同索引、同类型下已经存在同ID的文档。
在内部,Elasticsearch已经标记旧文档为删除并添加了一个完整的新文档。旧版本文档不会立即消失,但你也不能去访问它。Elasticsearch会在你继续索引更多数据时清理被删除的文档。

创建一个新文档

当索引一个文档,我们如何确定是完全创建了一个新的还是覆盖了一个已经存在的呢?
_index 、_type 、_id 三者唯一确定一个文档。所以要想保证文档是新加入的,最简单的方式是使用 POST 方法让Elasticsearch自动生成唯一 _id。

然而,如果想使用自定义的 _id ,我们必须告诉Elasticsearch应该在 _index  、 _type 、_id 三者都不同时才接受请求。为了做到这点有两种方法,它们其实做的是同一件事情。

如果请求成功的创建了一个新文档，Elasticsearch将返回正常的元数据且响应状态码是 201 Created 。如果包含相同的  _index 、 _type 和 _id 的文档已经在,Elasticsearch将返回 409  Conflict 响应状态码。

hadoop@tinylcy:~$ curl -XPUT localhost:9200/website/blog/123?op_type=create -d '{
>     "title" : "My first bolg entry",
>     "text" : "I am starting get the hang of this...",
>     "date" : "2014/01/02"
> }
> '
{"error":"DocumentAlreadyExistsException[[website][4] [blog][123]: document already exists]","status":409}

hadoop@tinylcy:~$ curl -XPUT localhost:9200/website/blog/123/_create -d '
> {
>     "title" : "My first bolg entry",
>     "text" : "I am starting get the hang of this...",
>     "date" : "2014/01/02"
> }
> '
{"error":"DocumentAlreadyExistsException[[website][4] [blog][123]: document already exists]","status":409}