正如我們提到的，文件不能被修改，它們只能被替換掉。更新API也必須遵循這一法則。從表面看來，貌似是文件被替換了。對內而言，它必須按照找回-修改-索引的流程來進行操作與管理。不同之處在於這個流程是在一個片(shard) 中完成的，因此可以節省多個請求所帶來的網路開銷。除了節省了步驟，同時我們也能減少多個程序造成衝突的可能性。

使用更新請求最簡單的一種用途就是新增新資料。新的資料會被合併到現有資料中，而如果存在相同的欄位，就會被新的資料所替換。例如我們可以為我們的employee新增tags和views欄位：

curl -XPOST "http://localhost:9200/megacorp/employee/1/_update"
 
 -d '
{
    "doc" : {
      "tags" : [ "testing" ],
      "views": 0
   }
}'

如果請求成功，我們就會收到一個類似於索引時返回的內容:

{
    "_index": "megacorp",
    "_type": "employee",
    "_id": "1",
    "_version": 21,
    "result": "updated",
    "_shards": {
        "total": 2,
        "successful": 1,
        "failed
 
": 0
    }
}

再次取回資料，你可以在_source中看到更新的結果：

{
  "_index" : "megacorp",
  "_type" : "employee",
  "_id" : "1",
  "_version" : 21,
  "found" : true,
  "_source" : {
    "first_name" : "John",
    "last_name" : "Aires",
    "age" : 24,
    "about" : "I love to go rock climbing",
    "interests" : [
      "sports"
 
,
      "food"
    ],
    "views" : 0,
    "tags" : [
      "testing"
    ]
  }
}

新的資料已經新增到了欄位_source中。

更新一篇可能不存在的文件

想象一下，我們可能需要在Elasticsearch中儲存一個頁面計數器。每次使用者訪問這個頁面，我們就增加一下當前頁面的計數器。但是如果這是個新的頁面，我們不能確保這個計數器已經存在。如果我們試著去更新一個不存在的文件，更新操作就會失敗。

為了防止上述情況的發生，我們可以使用upsert引數來設定文件不存在時，它應該被建立：

curl -XPOST "http://localhost:9200/megacorp/employee/1/_update" -d '
{
   "script" : "ctx._source.views+=1",
   "upsert": {
       "views": 1
   }
}'

首次執行這個請求時，upsert的內容會被索引成新的文件，它將views欄位初始化為1。當之後再請求時，文件已經存在，所以指令碼更新就會被執行，views計數器就會增加。

更新和衝突

在本節的開篇我們提到了當取回與重新索引兩個步驟間的時間越少，發生改變衝突的可能性就越小。但它並不能被完全消除，在更新的過程中還可能存在另一個程序進行重新索引的可能性。

為了避免丟失資料，更新API會在獲取步驟中獲取當前文件中的_version，然後將其傳遞給重新索引步驟中的索引請求。如果其他的程序在這兩部之間修改了這個文件，那麼_version就會不同，這樣更新就會失敗。

對於很多的區域性更新來說，文件有沒有發生變化實際上是不重要的。例如，兩個程序都要增加頁面瀏覽的計數器，誰先誰後其實並不重要 —— 發生衝突時只需要重新來過即可。

你可以通過設定retry_on_conflict引數來設定自動完成這項請求的次數，它的預設值是0。

curl -XPOST "http://localhost:9200/megacorp/employee/1/_update?retry_on_conflict=5 <1>" -d '
{
   "script" : "ctx._source.views+=1",
   "upsert": {
       "views": 0
   }
}

失敗前重新嘗試5次

這個引數非常適用於類似於增加計數器這種無關順序的請求，但是還有些情況的順序就是很重要的。例如上一節提到的情況，你可以參考樂觀併發控制以及悲觀併發控制來設定文件的版本號。