Elasticsearch索引和文檔操作的示例分析

這篇文章主要介紹了Elasticsearch索引和文檔操作的示例分析，具有一定借鑒價(jià)值，感興趣的朋友可以參考下，希望大家閱讀完這篇文章之后大有收獲，下面讓小編帶著大家一起了解一下。

列出所有索引

GET /_cat/indices?v

返回內(nèi)容如下：

health status index   uuid                   pri rep docs.count docs.deleted store.size pri.store.size
yellow open   .kibana XYZPR5XGQGWj8YlyZ1et_w   1   1          1            0      3.1kb          3.1kb

可以看到在集群中有一個(gè)索引

創(chuàng)建索引

現(xiàn)在讓我們創(chuàng)建一個(gè)名叫 customer 的索引，然后再次列出所有的索引

PUT /customer?pretty
GET /_cat/indices?v

執(zhí)行第一行返回以下內(nèi)容，這里我們使用PUT謂詞創(chuàng)建了一個(gè)名叫 customer 的索引，在后面跟上 pretty 表示如果有數(shù)據(jù)返回的話,用格式化后的JSON返回?cái)?shù)據(jù)

{  "acknowledged": true,  "shards_acknowledged": true}

執(zhí)行第二行返回以下內(nèi)容，結(jié)果告訴我們，已經(jīng)創(chuàng)建了一個(gè)名叫 customer 的索引，它有5個(gè)主分片和1個(gè)復(fù)制分片（默認(rèn)情況下是1個(gè)），在這個(gè)索引中還沒有文檔。

health status index    uuid                   pri rep docs.count docs.deleted store.size pri.store.size
yellow open   .kibana  XYZPR5XGQGWj8YlyZ1et_w   1   1          1            0      3.1kb          3.1kb
yellow open   customer M8i1ZxhsQJqk7HomOA7c_Q   5   1          0            0       650b           650b

可能你已經(jīng)注意到 customer 索引的健康值被標(biāo)記為 yellow ，回顧我們前面討論的內(nèi)容， yellow 表示該索引的復(fù)制分片（副本）還沒有被分配。該索引出現(xiàn)這種情況的原因是, Elasticsearch 默認(rèn)會(huì)為該索引創(chuàng)建1個(gè)副本，由于此時(shí)我們只有1個(gè)節(jié)點(diǎn)，那么這副本就沒法被分配（為了高可用），直到以后為該集群加入了另一個(gè)節(jié)點(diǎn)。一旦該副本分配到了另一個(gè)節(jié)點(diǎn)，該索引的健康狀態(tài)就會(huì)變成 green 。

索引和查詢文檔

接下來(lái)我們放一些東西到 customer 索引中。之前提過(guò)的，為了索引某個(gè)文檔，我們必須告訴 Elasticsearch ，該文檔應(yīng)該屬于該索引的哪個(gè)類型，下面我們索引一個(gè)簡(jiǎn)單的文檔到 customer 索引，類型名稱為 external ，  并且ID為1

PUT /customer/external/1?pretty
{  "name": "John Doe"}

返回內(nèi)容如下：

{  "_index": "customer",  "_type": "external",  "_id": "1",  "_version": 1,  "result": "created",  "_shards": {"total": 2,"successful": 1,"failed": 0
  },  "created": true}

從以上可以看出，一個(gè)新的客戶文檔成功被索引到 customer索引的 extenal 類型中，并且我們?cè)谒饕臅r(shí)候指定文檔的內(nèi)部id值為1。

值得注意的是， Elasticsearch 不需要在你索引文檔到某個(gè)索引之前，明確的創(chuàng)建一個(gè)索引。比如上一個(gè)例子，如果 customer索引不存在， Elasticsearch將自動(dòng)創(chuàng)建該索引。

再來(lái)看下我們剛剛索引的文檔

GET /customer/external/1?pretty

返回內(nèi)容如下：

{  "_index": "customer",  "_type": "external",  "_id": "1",  "_version": 1,  "found": true,  "_source": {"name": "John Doe"
  }
}

這里比較特殊的是found字段，它說(shuō)明我們查到了一個(gè)id為1的文檔，另一特殊的字段_source,保存了在上一個(gè)步驟索引的的文檔。

刪除索引

現(xiàn)在讓我們刪除剛剛已經(jīng)創(chuàng)建的索引，并再次查看所有索引。

DELETE /customer?pretty
GET /_cat/indices?v

第一行返回內(nèi)容以下：

{  "acknowledged": true}

第二行返回內(nèi)容如下：

health status index   uuid                   pri rep docs.count docs.deleted store.size pri.store.size
yellow open   .kibana XYZPR5XGQGWj8YlyZ1et_w   1   1          1            0      3.1kb          3.1kb

從以上內(nèi)容可以看到我們的 customer索引已經(jīng)被刪除了。

在繼續(xù)學(xué)習(xí)之前，讓我們快速回顧一下，本節(jié)學(xué)的API命令

PUT /customer
PUT /customer/external/1{  "name": "John Doe"}
GET /customer/external/1DELETE /customer

如果仔細(xì)學(xué)習(xí)了以上命令，應(yīng)該會(huì)發(fā)現(xiàn) elasticsearch 訪問數(shù)據(jù)所使用的模式，概括如下：

<REST Verb> /<Index>/<Type>/<ID>

使用REST 訪問模式，在所有的API命令中是十分普遍的，如果你可以簡(jiǎn)單記住它，對(duì)于掌握 Elasticsearch ，那么已經(jīng)開了一個(gè)好頭。

修改數(shù)據(jù)

Elasticsearch 具有近實(shí)時(shí)的操作和查詢數(shù)據(jù)的能力，默認(rèn)情況下，從你索引，更新或者刪除你的數(shù)據(jù)到用戶可以搜索到新的結(jié)果這個(gè)過(guò)程大概需要1秒（基于refresh 頻率）。它們和類似SQL這樣的平臺(tái)不一樣，SQL的數(shù)據(jù)在事務(wù)完成后就馬上就生效，不會(huì)有延遲。

索引/替換文檔

之前已經(jīng)演示了怎么索引單個(gè)文檔，再來(lái)回顧一下：

PUT /customer/external/1?pretty
{  "name": "John Doe"}

上面的命令將會(huì)索引指定文檔到 customer 索引的 external 類型，文檔的id值是1。如果我們用不同的文檔內(nèi)容（或者相同）再次執(zhí)行上面的命令，elasticsearch將會(huì)用一個(gè)新的文檔取代舊的文檔（即重建索引）。

PUT /customer/external/1?pretty
{  "name": "Jane Doe"}

上面的操作把id為1的文檔的name字段由"john doe"改成"jane doe"。另一方面，如果我們使用不同的id執(zhí)行上述命令，將會(huì)創(chuàng)建一個(gè)新的文檔，舊的文檔會(huì)保持原樣。

PUT /customer/external/2?pretty
{  "name": "Jane Doe"}

以上操作索引了一個(gè)新的id為2文檔。

索引新文檔的時(shí)候，id值是可選的。如果沒有指定， elasticsearch 將會(huì)為文檔生成一個(gè)隨機(jī)的id。實(shí)際生成的id將會(huì)保存在調(diào)用api接口的返回結(jié)果中。

下面的例子展示不指定文檔id的時(shí)候是如何索引文檔的：

POST /customer/external?pretty
{  "name": "Jane Doe"}

返回內(nèi)容如下：

{  "_index": "customer",  "_type": "external",  "_id": "AVyc9L6dtgHksqXKpTlM",  "_version": 1,  "result": "created",  "_shards": {"total": 2,"successful": 1,"failed": 0
  },  "created": true}

注意，在上面的例子中，因?yàn)闆]有指定id，我們需要使用POST謂詞取代之前的PUT謂詞。

更新文檔

除了可以索引和替換文檔之外，我們還可以更新文檔。注意， elasticsearch 并沒有在原來(lái)的文檔基礎(chǔ)上進(jìn)行更新，每當(dāng)進(jìn)行更新時(shí)， Elasticsearch 將刪除舊的文檔，然后索引新的文檔。以下例子演示了如何更新文檔，把之前ID為1的name字段改為"Jane Doe":

POST /customer/external/1/_update?pretty
{  "doc": { "name": "Jane Doe" }
}

以下例子演示了如何更新先前ID為1的文檔，改變name字段為"Jane Doe" 的同時(shí)添加age字段

POST /customer/external/1/_update?pretty
{  "doc": { "name": "Jane Doe", "age": 20 }
}

也可以使用簡(jiǎn)單的腳本來(lái)執(zhí)行更新。以下示例使用腳本將年齡增加5：

POST /customer/external/1/_update?pretty
{  "script" : "ctx._source.age += 5"}

在以上例子中， ctx._source 指當(dāng)前即將被更新的源文檔。請(qǐng)注意，在撰寫本文時(shí)，只能一次更新單個(gè)文檔。將來(lái)， Elasticsearch 可能會(huì)提供通過(guò)查詢條件（如SQL UPDATE-WHERE語(yǔ)句）更新多個(gè)文檔的功能。

刪除文檔

刪除文檔非常簡(jiǎn)單，以下例子演示了怎么刪除 customer 索引下ID為2的文檔，查閱Delete By Query API 刪除與特定查詢匹配的所有文檔。值得注意的是，直接刪除整個(gè)索引比通過(guò)query api 刪除所有文檔更高效。

DELETE /customer/external/2?pretty

批處理

除了能夠索引，更新和刪除單個(gè)文檔之外， Elasticsearch 也提供了使用 _bulk API 批量執(zhí)行上述任何操作的功能。這個(gè)功能是非常重要的，因?yàn)樗峁┝艘粋€(gè)非常有效的機(jī)制來(lái)盡可能快地進(jìn)行多個(gè)操作，并且盡可能減少網(wǎng)絡(luò)的往返行程。簡(jiǎn)單舉個(gè)例子，下面會(huì)在一個(gè) bulk操作中索引兩個(gè)文檔：

POST /customer/external/_bulk?pretty
{"index":{"_id":"1"}}
{"name": "John Doe" }
{"index":{"_id":"2"}}
{"name": "Jane Doe" }

返回內(nèi)容如下：

{  "took": 27,  "errors": false,  "items": [
    {      "index": {"_index": "customer","_type": "external","_id": "1","_version": 1,"result": "created","_shards": {          "total": 2,          "successful": 1,          "failed": 0},"created": true,"status": 201  }
    },
    {      "index": {"_index": "customer","_type": "external","_id": "2","_version": 1,"result": "created","_shards": {          "total": 2,          "successful": 1,          "failed": 0},"created": true,"status": 201  }
    }
  ]
}

下面的例子會(huì)在一個(gè)操作內(nèi)更新第一個(gè)文檔同時(shí)刪除第二個(gè)文檔：

POST /customer/external/_bulk?pretty
{"update":{"_id":"1"}}
{"doc": { "name": "John Doe becomes Jane Doe" } }
{"delete":{"_id":"2"}}

返回內(nèi)容如下：

{  "took": 25,  "errors": false,  "items": [
    {      "update": {"_index": "customer","_type": "external","_id": "1","_version": 2,"result": "updated","_shards": {          "total": 2,          "successful": 1,          "failed": 0},"status": 200  }
    },
    {      "delete": {"found": true,"_index": "customer","_type": "external","_id": "2","_version": 2,"result": "deleted","_shards": {          "total": 2,          "successful": 1,          "failed": 0},"status": 200  }
    }
  ]
}

注意以上的刪除操作，在它之后并沒有相應(yīng)的源文檔，因?yàn)橹恍枰臋n的ID就能刪除。

如果某個(gè)操作因某些原因執(zhí)行失敗，不會(huì)影響后面的操作，它會(huì)繼續(xù)執(zhí)行剩下的操作。api返回結(jié)果時(shí)，每一個(gè)操作都會(huì)提供狀態(tài)（和接收到的順序一致），你可以通過(guò)這個(gè)狀態(tài)檢查操作是否執(zhí)行成功。

總結(jié)

簡(jiǎn)單的索引操作

1、查看集群中的索引， GET /_cat/indices?v

2、創(chuàng)建索引 PUT /product?pretty 。（es會(huì)自動(dòng)建立index和type，不需要提前創(chuàng)建，而且es默認(rèn)會(huì)對(duì)document每個(gè)field都建立倒排索引，讓其可以被搜索）

3、刪除索引， DELETE /test_index?pretty

文檔的CRUD操作

1、新增商品

PUT /product/goods/1{"goods_id": "10","goods_name": "索愛C702c","createTime": "2016-12-21","goods_type": ["華為","樂視","小米"]
}

2、查詢商品， GET /product/goods/1

3、修改商品

方式1：替換文檔（和創(chuàng)建一樣，所有字段必須寫全）

PUT /product/goods/4{"goods_id": "40","goods_name": "聯(lián)想筆記本","createTime": "2017-05-21","goods_type": ["電腦"]
}

字段不寫全的情況

方式2：更新文檔

POST /product/goods/1/_update
{  "doc":{"goods_name":"iphone手機(jī)"
  }
}

比較創(chuàng)建，更新，替換文檔返回結(jié)果：

感謝你能夠認(rèn)真閱讀完這篇文章，希望小編分享的“Elasticsearch索引和文檔操作的示例分析”這篇文章對(duì)大家有幫助，同時(shí)也希望大家多多支持億速云，關(guān)注億速云行業(yè)資訊頻道，更多相關(guān)知識(shí)等著你來(lái)學(xué)習(xí)!