Elastic Search权威指南 第一章 ES基础概念

1. 索引(名词)：一个集群中，可以有多个结点；一个结点中，也可以存在多个索引。一个索引索引着多个分片，所以一个索引索引着的分片，也就可以存在多个结点中。索引其实为一个逻辑命名空间，也就是非真实存在的，只是一个概念。

2. 集群健康
   green：主分片都可用，复制分片也都可用
   yellow：主分片都可用，复制分片不一定都可用
   red：主分片和复制分片都不一定可用

3. 遇到主结点故障时
   迅速将一个负结点升级为主结点，主结点中的主分片对应的复制分片，迅速升级为主分片。

4. 文档的元数据
   有三个：_index,_type,_id。
5. 每个文档都有一个_version
   每当文档发生变化的时候，_version都会加1。
6. 当更新了一个文档时，旧文档并不会立即消失，但是也不能被访问。旧文档会在稍后的索引数据时被清除。
7. 创建新文档
   怎样才能保证创建的文档是新的文档，而不是将之前的文档覆盖了呢？
   那么就要将当前的index/type/index和索引中已有的index/type/index进行比较，不同的才能进行插入

PUT index/type/id?op_type=create
or
PUT index/type/id/_create

如果不存在，则创建成功，否则，返回409状态码，例如：

{
    "error" : "DocumentAlreadyExistsException[[website][4] [blog][123]:
    document already exists]",
    "status" : 409
}

1. ES中的CAS
   为了避免两次相邻，且包含的更新数据一致的请求，互相覆盖导致数据覆盖，ES中可以根据version进行相应的更新

PUT /website/blog/1?version=2 <1>
{
    "title" : "sssssss",
    "text" : "aaaaaa"
}

<1> 保证只有当索引中的version==2时，才进行相应的更新，否则报错

{
"error" : "VersionConflictEngineException[[website][2] [blog][1]:
version conflict, current [2], provided [1]]",
"status" : 409
}

1. 局部更新
   通过update API，update API会自动检查更新期间，版本号是否变更，如果变更，则更新失败

POST /website/blog/1/_update
{
    "doc" : {
        "tags" : ["tag1"],
        "views" : 0
    }
}


key ： value

其中的doc就是局部更新的参数，会将key和value，放入到文档中，key作为域，value作为值
10. 使用脚本进行局部更新
不仅可以通过update API，还可以通过Groovy这种脚本语言进行局部更新

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

语法
{
    "script" : "ctx._source.域 操作"
}

还可以提高脚本的可重用性，增加参数

POST /website/blog/1/_update
{
    "script" : "ctx._source.tags+=new_tag",
    "params" : {
        "new_tag" : "search"
    }
}

语法：
{
    "params":{
        "param_key" : "param_value"
    }
}

这样"search"就会出现在tags域的值域中

1. setNX
   我们会遇到这种情景，如果域不存在，我就新建域，并且初始化。如果存在，就操作
   为了满足这种需求，可以使用upsert API

POST /website/blog/1/_upsert
{
    "script" : "ctx._source.views+=1",
    "upsert" : {
        "views" : 1
    }
}

存在 "script" : 
不存在 "upsert" : 

1. ReTry命令
   当命令不能执行发生错误时(例如：version发生了更改)

POST /website/blog/1_update?retry_on_conflict=5
{
    "script" : "ctx._source.views+=1",
    "upsert" : {
        "views":0 
    }
}

发生错误后重试5次

1. 检索多个文档
   使用mget API
   多次索引不如一次索引的效率高，所以建议一次性索引拥有相似index,type的文档

GET /_mget
{
    "docs":[
        {
            "_index" : "website",
            "_type" : "blog",
            "_id" : "1"
        },
        {
            "_index" : "website",
            "_type" : "blog",
            "_id" : "2",
            "_source" :"views"
        }
    ]
}
在docs数组中，包含查询的条件

返回的数据：

{
"docs" : [
        {
            "_index" : "website",
            "_id" : "2",
            "_type" : "blog",
            "found" : true,
            "_source" : {
            "text" : "This is a piece of cake...",
            "title" : "My first external blog entry"
            },
            "_version" : 10
        },
        {
            "_index" : "website",
            "_id" : "1",
            "_type" : "pageviews",
            "found" : true,
            "_version" : 2,
            "_source" : {
            "views" : 2
            }
        }
    ]
}

在命令中指定了index,type，就可以只在docs数组中写id

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

如果检索的文档不存在，则会被告知，但是这次的mget请求仍是成功的，因为mget请求到了数据，至于数据标识为存在还是不存在，就不是mget功能锁管控的范围内了。

假设1不存在
{
"docs" : [
    {
        "_index" : "website",
        "_type" : "blog",
        "_id" : "2",
        "_version" : 10,
        "found" : true,
        "_source" : {
        "title": "My first external blog entry",
        "text": "This is a piece of cake..."
        }
    },
    {
        "_index" : "website",
        "_type" : "blog",
        "_id" : "1",
        "found" : false <1>
    }
    ]
}

1. 批量操作
   使用bulk API

语法：
POST /_bulk
{"action" : {"metadata"}}
{"field" : "value" }
{"action" : {"metadata"}}
{"action" : {"metadata"}}

其中的
{"field" : "value"}
不是必选项，一般在使用 create、index命令的时候，才可能涉及到

举个例子：

POST /_bulk
{"create":{"_index":"website","_type":"blog","_id":"123"}}
{"title":"thats my first blog"}
{"index":{"_index":"website","_type":"blog","_id":"234"}}
{"title":"thats my second blog"}
{"delete":{"_index":"website","_type":"blog","_id":"123"}}
{"update":{"_index":"website","_type":"blog","_id":"234","_retry_on_conflict":"3"}}
{"doc":{"title":"i update my second blog"}}

响应结果
有错位，自己对应一下
{
"took": 4,
"errors": false, <1>
"items": [
{ "delete": {
"_index": "website",
"_type": "blog",
"_id": "123",
"_version": 2,
"status": 200,
"found": true
}},
{ "create": {
"_index": "website",
"_type": "blog",
"_id": "123",
"_version": 3,
"status": 201
}},
{ "create": {
"_index": "website",
"_type": "blog",
"_id": "EiwfApScQiiy7TIKFxRCTw",
"_version": 1,
"status": 201
}},
{ "update": {
"_index": "website",
"_type": "blog",
"_id": "123",
"_version": 4,
"status": 200
}}
]
}}

注意：bulk请求不是一个原子操作，不能保证事务
15. 批量索引
宗旨：杜绝重复，能够重复利用，坚决不重写

POST /website/blog/_bulk
{"index":{}}
{"title":"thats a new blog"}
{"index":{"_type":log}}      //重用
{"event":"thats not a blog,its a log"}