003 文档的操作

一 . 添加文档

在上面一节,我们删除了user索引.

现在我们执行下面的命令:

PUT /user/_doc/1
{
  "username" : "trek",
  "age" : 27
}

　可以得到下面的结果　

{
  "_index" : "user",
  "_type" : "_doc",
  "_id" : "1",
  "_version" : 1,
  "result" : "created",
  "_shards" : {
    "total" : 2,
    "successful" : 1,
    "failed" : 0
  },
  "_seq_no" : 0,
  "_primary_term" : 1
}

　　我们从result之中,可以得到,我们成功的添加了一个文档.

我们继续查询索引:

GET /user

　　可以得到如下的结果:

{
  "user" : {
    "aliases" : { },
    "mappings" : {
      "properties" : {
        "age" : {
          "type" : "long"
        },
        "username" : {
          "type" : "text",
          "fields" : {
            "keyword" : {
              "type" : "keyword",
              "ignore_above" : 256
            }
          }
        }
      }
    },
    "settings" : {
      "index" : {
        "creation_date" : "1569423964719",
        "number_of_shards" : "1",
        "number_of_replicas" : "1",
        "uuid" : "_7BZkTRISAm7zzCo5B17ow",
        "version" : {
          "created" : "7030299"
        },
        "provided_name" : "user"
      }
    }
  }
}

　　我们发现,我们在添加记录的时候,同时也创建了索引.

这就是nosql数据库的特点,它总是没有什么特定的要求的.

二 .文档的id

在上面,我们添加一个文档,并且制定了文档的id是1.

如果我们不指定,es会帮助我们自动生成一个文档的id.

如下:

POST /user/_doc
{
  "username":"tom",
  "age" : 33
}

　　得到的结果如下:

{
  "_index" : "user",
  "_type" : "_doc",
  "_id" : "6pr4aG0BsjQtAa68ty9w",
  "_version" : 1,
  "result" : "created",
  "_shards" : {
    "total" : 2,
    "successful" : 1,
    "failed" : 0
  },
  "_seq_no" : 1,
  "_primary_term" : 1
}

　　我们发现es给我们创建了一个随机的id值.

另外,我们可以得到这样的一个结论.

put请求的本质实际上是更新,如上.

post的请求本质上才是新增.当我们不指定id的时候,es就会执行新增操作.

如果指定了id,es的处理逻辑就是更新.

但是es是不允许更新文档内容的,它处理的逻辑是先删除,然后再添加一个新的文档.

由于我们之前不存在id=1的文档,因此es知道我们的本意其实是新增.

在这里我们说的put和post的区别,在后面也是相同的.

如果不分析这些,我们很容易的就认为put是新增操作,和一般的restful风格不一致.

四 .全量更新

在更新内容的时候,我们需要指定id.

如下:

PUT /user/_doc/1
{
  "username":"tim"
}

　　得到的结果如下:

{
  "_index" : "user",
  "_type" : "_doc",
  "_id" : "1",
  "_version" : 2,
  "result" : "updated",
  "_shards" : {
    "total" : 2,
    "successful" : 1,
    "failed" : 0
  },
  "_seq_no" : 2,
  "_primary_term" : 1
}

　　我们需要注意的是version的内容现在变成了2,这是乐观所的机制,在这里我们不去详细的说.

我们再去查询id=1的文档内容.

GET /user/_doc/1

　　得到如下的内容,我们关注下_source的内容.

{
  "_index" : "user",
  "_type" : "_doc",
  "_id" : "1",
  "_version" : 2,
  "_seq_no" : 2,
  "_primary_term" : 1,
  "found" : true,
  "_source" : {
    "username" : "tim"
  }
}

　　令我们感到惊讶的是,我们原本想更新username的内容,但是es不仅帮助我们更新了该字段,而且删除了age字段.

原因呢?

和我们上面介绍的内容其实是一致的,es的文档没有更新的操作,只有先删除后新增的功能.

我们上述的命令,本质上是就是如此,因此,新增的文档根本没有age字段,该字段丢失了.

很多情况下,我们不想出现这样的效果.

四 .局部更新--partial update操作.

看如下的命令:

我们首先创建如下的文档:

PUT /user/_doc/3
{
  "username":"john",
  "age":33
}

　　使用下面的命令进行更新:

POST /user/_update/3
{
  "doc":{
      "username":"john",
      "age":34
  }

}

　　我们使用的局部更新的操作,该操作会更新局部的内容.

五 .删除文档

DELETE /user/_doc/1

　　我们发送delete请求就可以正确的删除文档了.