這篇文章主要介紹了Elasticsearch索引和文檔操作的示例分析,具有一定借鑒價值,感興趣的朋友可以參考下,希望大家閱讀完這篇文章之后大有收獲,下面讓小編帶著大家一起了解一下。
成都創(chuàng)新互聯(lián)從2013年開始,先為秭歸等服務(wù)建站,秭歸等地企業(yè),進(jìn)行企業(yè)商務(wù)咨詢服務(wù)。為秭歸企業(yè)網(wǎng)站制作PC+手機(jī)+微官網(wǎng)三網(wǎng)同步一站式服務(wù)解決您的所有建站問題。
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
可以看到在集群中有一個索引
現(xiàn)在讓我們創(chuàng)建一個名叫 customer 的索引,然后再次列出所有的索引
PUT /customer?pretty GET /_cat/indices?v
執(zhí)行第一行返回以下內(nèi)容,這里我們使用PUT謂詞創(chuàng)建了一個名叫 customer 的索引,在后面跟上 pretty 表示如果有數(shù)據(jù)返回的話,用格式化后的JSON返回數(shù)據(jù)
{ "acknowledged": true, "shards_acknowledged": true}
執(zhí)行第二行返回以下內(nèi)容,結(jié)果告訴我們,已經(jīng)創(chuàng)建了一個名叫 customer 的索引,它有5個主分片和1個復(fù)制分片(默認(rèn)情況下是1個),在這個索引中還沒有文檔。
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)會為該索引創(chuàng)建1個副本,由于此時我們只有1個節(jié)點(diǎn),那么這副本就沒法被分配(為了高可用),直到以后為該集群加入了另一個節(jié)點(diǎn)。一旦該副本分配到了另一個節(jié)點(diǎn),該索引的健康狀態(tài)就會變成 green 。
接下來我們放一些東西到 customer 索引中。之前提過的,為了索引某個文檔,我們必須告訴 Elasticsearch ,該文檔應(yīng)該屬于該索引的哪個類型,下面我們索引一個簡單的文檔到 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}
從以上可以看出,一個新的客戶文檔成功被索引到 customer索引的 extenal 類型中,并且我們在索引的時候指定文檔的內(nèi)部id值為1。
值得注意的是, Elasticsearch不需要在你索引文檔到某個索引之前,明確的創(chuàng)建一個索引。比如上一個例子,如果 customer索引不存在, Elasticsearch將自動創(chuàng)建該索引。
再來看下我們剛剛索引的文檔
GET /customer/external/1?pretty
返回內(nèi)容如下:
{ "_index": "customer", "_type": "external", "_id": "1", "_version": 1, "found": true, "_source": {"name": "John Doe" } }
這里比較特殊的是found字段,它說明我們查到了一個id為1的文檔,另一特殊的字段_source,保存了在上一個步驟索引的的文檔。
現(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)該會發(fā)現(xiàn) elasticsearch 訪問數(shù)據(jù)所使用的模式,概括如下:
/ / /
使用REST 訪問模式,在所有的API命令中是十分普遍的,如果你可以簡單記住它,對于掌握 Elasticsearch ,那么已經(jīng)開了一個好頭。
Elasticsearch 具有近實(shí)時的操作和查詢數(shù)據(jù)的能力,默認(rèn)情況下,從你索引,更新或者刪除你的數(shù)據(jù)到用戶可以搜索到新的結(jié)果這個過程大概需要1秒(基于refresh 頻率)。它們和類似SQL這樣的平臺不一樣,SQL的數(shù)據(jù)在事務(wù)完成后就馬上就生效,不會有延遲。
之前已經(jīng)演示了怎么索引單個文檔,再來回顧一下:
PUT /customer/external/1?pretty { "name": "John Doe"}
上面的命令將會索引指定文檔到 customer 索引的 external 類型,文檔的id值是1。如果我們用不同的文檔內(nèi)容(或者相同)再次執(zhí)行上面的命令,elasticsearch將會用一個新的文檔取代舊的文檔(即重建索引)。
PUT /customer/external/1?pretty { "name": "Jane Doe"}
上面的操作把id為1的文檔的name字段由"john doe"改成"jane doe"。另一方面,如果我們使用不同的id執(zhí)行上述命令,將會創(chuàng)建一個新的文檔,舊的文檔會保持原樣。
PUT /customer/external/2?pretty { "name": "Jane Doe"}
以上操作索引了一個新的id為2文檔。
索引新文檔的時候,id值是可選的。如果沒有指定, elasticsearch 將會為文檔生成一個隨機(jī)的id。實(shí)際生成的id將會保存在調(diào)用api接口的返回結(jié)果中。
下面的例子展示不指定文檔id的時候是如何索引文檔的:
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 并沒有在原來的文檔基礎(chǔ)上進(jìn)行更新,每當(dāng)進(jìn)行更新時, Elasticsearch 將刪除舊的文檔,然后索引新的文檔。以下例子演示了如何更新文檔,把之前ID為1的name字段改為"Jane Doe":
POST /customer/external/1/_update?pretty { "doc": { "name": "Jane Doe" } }
以下例子演示了如何更新先前ID為1的文檔,改變name字段為"Jane Doe" 的同時添加age字段
POST /customer/external/1/_update?pretty { "doc": { "name": "Jane Doe", "age": 20 } }
也可以使用簡單的腳本來執(zhí)行更新。以下示例使用腳本將年齡增加5:
POST /customer/external/1/_update?pretty { "script" : "ctx._source.age += 5"}
在以上例子中, ctx._source 指當(dāng)前即將被更新的源文檔。請注意,在撰寫本文時,只能一次更新單個文檔。將來, Elasticsearch 可能會提供通過查詢條件(如SQL UPDATE-WHERE
語句)更新多個文檔的功能。
刪除文檔非常簡單,以下例子演示了怎么刪除 customer 索引下ID為2的文檔,查閱Delete By Query API 刪除與特定查詢匹配的所有文檔。值得注意的是,直接刪除整個索引比通過query api 刪除所有文檔更高效。
DELETE /customer/external/2?pretty
除了能夠索引,更新和刪除單個文檔之外, Elasticsearch 也提供了使用 _bulk API 批量執(zhí)行上述任何操作的功能。這個功能是非常重要的,因?yàn)樗峁┝艘粋€非常有效的機(jī)制來盡可能快地進(jìn)行多個操作,并且盡可能減少網(wǎng)絡(luò)的往返行程。簡單舉個例子,下面會在一個 bulk操作中索引兩個文檔:
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 } } ] }
下面的例子會在一個操作內(nèi)更新第一個文檔同時刪除第二個文檔:
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就能刪除。
如果某個操作因某些原因執(zhí)行失敗,不會影響后面的操作,它會繼續(xù)執(zhí)行剩下的操作。api返回結(jié)果時,每一個操作都會提供狀態(tài)(和接收到的順序一致),你可以通過這個狀態(tài)檢查操作是否執(zhí)行成功。
1、查看集群中的索引, GET /_cat/indices?v
2、創(chuàng)建索引 PUT /product?pretty 。(es會自動建立index和type,不需要提前創(chuàng)建,而且es默認(rèn)會對document每個field都建立倒排索引,讓其可以被搜索)
3、刪除索引, DELETE /test_index?pretty
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索引和文檔操作的示例分析”這篇文章對大家有幫助,同時也希望大家多多支持創(chuàng)新互聯(lián),關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道,更多相關(guān)知識等著你來學(xué)習(xí)!