es java api整體說明

elasticsearch讀寫文檔概述

data replication model定義 (該model基于primary-backup model )
ES的每個index都被分成多個shards 每個shard可能含有多個copies(備份) 這些copies被稱為一個 replication group當文件發(fā)生增加或刪除操作時,replication group必須同步保存,否則再讀取不同的copies是會得到不同的結果.

**primary-backup model定義 **
這個模式下,將replication group中的一個單獨的copy當做primary shard.其他copies 被稱為replica shards;primary shard 是所有索引操作的主記錄點. primary shard負責驗證操作的有效性和正確性.一旦一個操作在primary shard上生效了,那么這個primary shard就要負責將這個有效的操作復制到其他replica shards上.
Basic write model
Elasticsearch中的每個索引操作首先基于document ID通過routing定位到replication group .一旦replication group 被確定,這個操作就會發(fā)送到這個group的primary shard.而primary shard 負責驗證這個操作并將其傳送給其他replicas.由于replicas 可能不在線, primary不一定要傳送給所有的replicas. 而是由Elasticsearch維護一個需要接受這個操作的shard copies清單. 這個清單被稱為in-sync copies 并且由master node維護.

primary shard遵循如下流程:

  1. 驗證操作,如果操作無效則拒絕
  2. 執(zhí)行該操作. 這步中胡對field的內(nèi)容進行驗證,并在條件不滿足時拒絕該操作(Example: a keyword value is too long for indexing in Lucene).
  3. 發(fā)送該操作到當前in-sync copies set的每個replica.如果存在多個 replicas,會平行進行.
  4. 一旦所有replicas 都成功執(zhí)行了該操作并響應給了primary,primary 會通知client這個請求成功了.

操作失敗處理
case1: 如果primary無法處理這個操作,那么擁有該primary的節(jié)點會給master發(fā)送消息,這個索引操作會等待一段時間默認一分鐘,以便master去任命一個replica成為新的primary.然后這個操作會有新的primary來處理.(這種情況主要發(fā)生在擁有primary的節(jié)點與集群因為網(wǎng)絡原因而孤立的情況下)

case2: 如果primary成功的處理了index操作,in-sync replica set中的一個replica 沒有成功接收改操作. 那么primary會給master發(fā)送一個消息,請求將有問題的replica從in-sync replica set中刪除.

elasticsearch中常用的API分類如下:

  • 文檔API: 提供對文檔的增刪改查操作
  • 搜索API: 提供對文檔進行某個字段的查詢
  • 索引API: 提供對索引進行操作聚至,查看索引信息等
  • 查看API: 按照更直觀的形式返回數(shù)據(jù),更適用于控制臺請求展示

文檔類API

Index API

通過index API 可以添加獲更新某種類型的JSON文檔到特定的index ,并使之可搜索. 例如在 "twitter" index, type "tweet" , id =1 下新增一個JSON文檔

PUT twitter/tweet/1
{
    "user" : "kimchy",
    "post_date" : "2009-11-15T14:12:12",
    "message" : "trying out Elasticsearch"
}

以上操作的結果為:

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

_shards展示有關索引操作的replication process 信息.
total表示shard copies (primary and replica shards)的數(shù)量
successful表示執(zhí)行該操作成功的shard數(shù)量
failed 一個包含replication 相關錯誤的數(shù)組
successful至少1才能任務改index操作是成功了的.

注意:當一個 index 操作成功返回時,并不是所有replica shard都開始了該操作,(默認情況下只有primary是必須的,但是這個可以設置)也就是說,total 會等于 設置的number_of_replicas值,successful 會等于開始該操作的shards數(shù).

當一個index不存在的時候,默認自動創(chuàng)建相應的index和type 相應的mapping也會自動添加到特定type的mapping definition下.

如果不想自動添加則進行如下設置:
取消自動創(chuàng)建index: setting action.auto_create_index to false
取消自動創(chuàng)建mapping: setting index.mapper.dynamic to false

自動創(chuàng)建index還可以自定義配置,如:

action.auto_create_index to +aaa*,-bbb*,+ccc*,-*
(+ 表示允許創(chuàng)建, - 表示不允許).

版本號會作為index API請求響應的一部分

最后編輯于
?著作權歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌尸饺,老刑警劉巖,帶你破解...
    沈念sama閱讀 216,372評論 6 498
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異辰斋,居然都是意外死亡,警方通過查閱死者的電腦和手機瘸味,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,368評論 3 392
  • 文/潘曉璐 我一進店門宫仗,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人旁仿,你說我怎么就攤上這事藕夫。” “怎么了枯冈?”我有些...
    開封第一講書人閱讀 162,415評論 0 353
  • 文/不壞的土叔 我叫張陵毅贮,是天一觀的道長。 經(jīng)常有香客問我尘奏,道長滩褥,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,157評論 1 292
  • 正文 為了忘掉前任炫加,我火速辦了婚禮瑰煎,結果婚禮上铺然,老公的妹妹穿的比我還像新娘。我一直安慰自己酒甸,他們只是感情好魄健,可當我...
    茶點故事閱讀 67,171評論 6 388
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著插勤,像睡著了一般沽瘦。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上饮六,一...
    開封第一講書人閱讀 51,125評論 1 297
  • 那天其垄,我揣著相機與錄音,去河邊找鬼卤橄。 笑死绿满,一個胖子當著我的面吹牛,可吹牛的內(nèi)容都是我干的窟扑。 我是一名探鬼主播喇颁,決...
    沈念sama閱讀 40,028評論 3 417
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼嚎货!你這毒婦竟也來了橘霎?” 一聲冷哼從身側響起,我...
    開封第一講書人閱讀 38,887評論 0 274
  • 序言:老撾萬榮一對情侶失蹤殖属,失蹤者是張志新(化名)和其女友劉穎姐叁,沒想到半個月后,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體洗显,經(jīng)...
    沈念sama閱讀 45,310評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡外潜,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,533評論 2 332
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了挠唆。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片处窥。...
    茶點故事閱讀 39,690評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖玄组,靈堂內(nèi)的尸體忽然破棺而出滔驾,到底是詐尸還是另有隱情,我是刑警寧澤俄讹,帶...
    沈念sama閱讀 35,411評論 5 343
  • 正文 年R本政府宣布哆致,位于F島的核電站,受9級特大地震影響患膛,放射性物質(zhì)發(fā)生泄漏沽瞭。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 41,004評論 3 325
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望驹溃。 院中可真熱鬧,春花似錦延曙、人聲如沸豌鹤。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,659評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽布疙。三九已至,卻和暖如春愿卸,著一層夾襖步出監(jiān)牢的瞬間灵临,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,812評論 1 268
  • 我被黑心中介騙來泰國打工趴荸, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留儒溉,地道東北人。 一個月前我還...
    沈念sama閱讀 47,693評論 2 368
  • 正文 我出身青樓发钝,卻偏偏與公主長得像顿涣,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子酝豪,可洞房花燭夜當晚...
    茶點故事閱讀 44,577評論 2 353

推薦閱讀更多精彩內(nèi)容