第七章:文档的操作

一.创建文档

    创建文档的有两种方式

    PUT创建文档: 需要指定文档的Id

    POST创建文档: 不需要指定文档ID,Elasticsearch 可以帮我们自动生成 ID,自动生成的 ID 是 URL-safe、 基于 Base64 编码且长度为20个字符的 GUID 字符串

PUT /website/blog/123
{
  "title": "My first blog entry",
  "text":  "Just trying this out...",
  "date":  "2014/01/01"
}
POST /website/blog/
{
  "title": "My second blog entry",
  "text":  "Still trying this out...",
  "date":  "2014/01/01"
} 

二.获取文档

获取详细文档信息在请求的后面加上pretty  : GET /website/blog/123?pretty

获取显示指定字段的信息使用_source,后面跟要显示字段  : GET /website/blog/123?_source=title,text

获取只显示文档中的字段的信息  : GET /website/blog/123/_source

获取文档下的所有的信息  : GET /website/blog/_search

使用_mget获取多个文档

GET /_mget
{
   "docs" : [
      {
         "_index" : "website",
         "_type" :  "blog",
         "_id" :    123
      },
      {
         "_index" : "megacorp",
         "_type" :  "employee",
         "_id" :    1,
         "_source": [
           "title","text"
           ]
      }
   ]
}

在相同的索引的文档下获取多条数据

GET /website/blog/_mget
{
   "docs" : [
      { "_id" : 2 },
      { "_type" : "pageviews", "_id" :   1 }
   ]
}

使用 Id获取文档

GET /website/blog/_mget
{
   "ids" : [ "2", "1" ]
}

三.判断文档

检查文档是否存在,使用HEAD : HEAD /website/blog/123

四.更新文档

1.使用PUT更新

PUT更新是对文档中字段全部进行更新

PUT /website/blog/123
{
  "title": "My first blog entry",
  "text":  "I am starting to get the hang of this...",
  "date":  "2014/01/02"
}

2.使用POST更新

POST更新需要使用_update,在更新文档是对文档的局部字段进行更新

POST /website/blog/123/_update
{
   "doc" : {
      "date": "2018/01/06",
      "tags": ["test","search"]
   }
}

3.使用脚本更新 例如:

POST /website/blog/123/_update
{
   "script" : "ctx._source.views+=1"
}

五.删除文档

删除文档 : DELETE /website/blog/12345

如果文档存在,删除会返回200 , 文档不存在,执行删除时会返回404

 

六.批量文档操作

使用 bulk 进行文档批量操作

action 必须是以下选项之一:

create

如果文档不存在，那么就创建它。详情请见 创建新文档。

index

创建一个新文档或者替换一个现有的文档。详情请见 索引文档 和 更新整个文档。

update

部分更新一个文档。详情请见 文档的部分更新。

delete

删除一个文档。详情请见 删除文档。

metadata 应该 指定被索引、创建、更新或者删除的文档的 _index 、 _type 和 _id 。

POST /_bulk
{ "delete": { "_index": "website", "_type": "blog", "_id": "1234" }} 
{ "create": { "_index": "website", "_type": "blog", "_id": "1234" }}
{ "title":    "My first blog post" }
{ "index":  { "_index": "website", "_type": "blog" }}
{ "title":    "My second blog post" }
{ "update": { "_index": "website", "_type": "blog", "_id": "1234", "_retry_on_conflict" : 3} }
{ "doc" : {"title" : "My updated blog post"} }