文章目錄

• 1 Search API的基本用法
• 1.1 查詢所有資料
• 1.2 響應資訊說明
• 1.3 timeout機制
• 1.4 查詢多索引和多型別中的資料
• 2 URI Search的使用
• 2.1 GET請求攜帶引數查詢
• 2.2 URI Search的引數列表
• 2.3 URI Search用法示例
• 2.4 不指定field時的搜尋機制
• 版權宣告

1 Search API的基本用法

1.1 查詢所有資料

GET _search

1.2 響應資訊說明

{
    "took": 6,		// 整個搜尋請求消耗的時間, 單位是毫秒. 包括執行緒池中的等待時間, 和在叢集中分散式搜尋+收集結果的時間
    "timed_out": false,		// 預設不啟用超時機制, 若啟用, 需要設定具體的時間值
    "_shards": {			// 搜尋用到的shard數, 以及成功/失敗的shard數
        "total": 5,
        "successful": 5,
        "failed": 0			// 一個Shard的Primary和Replicas都掛掉, 它才被認為失敗
    },
    "hits"
 
: {
        "total": 10,		// 本次搜尋命中(搜尋到)的結果總數
        "max_score": 1,		// 本次搜尋的所有結果中, 最大的相關度分數
        "hits": [			// 預設顯示查詢結果中的前10條記錄, 根據_score降序排序
            {
                "_index": ".kibana",
                "_type": "config",
                "_id": "5.6.10",
                "_score": 1,	// 相關度得分, 越相關, 分值越大, 排位越靠前
 

                "_source": {
                    "buildNum": 14695
                }
            }
        ]
    }
}

1.3 timeout機制

指定每個Shard必須在timeout規定的時間內, 將搜尋到的資料 (可能只搜尋到了部分資料, 也可能搜尋到了全部資料) 立即返回給客戶端, 而不是等待查詢操作完全完成後再返回.

—— 確保在指定時間內返回資料, 無論查詢是否完成.

ES的搜尋預設不開啟timeout, 查詢持續的時間(latency)將根據查詢的完整性(completeness)自動延遲, 可以手動指定timeout, 使用示例:

GET _search?timeout=10ms
# 可用的單位: timeout=10ms | timeout=1s | timeout=1m

結果說明: 查詢請求能在1分鐘內查詢到符合條件的全部2000條資料, 在指定 timeout=10 之後, 就會在10ms時返回查詢到的部分結果, 此時可能只查詢到了100條資料.

1.4 查詢多索引和多型別中的資料

一次性搜尋多個索引(multi-index)和多個型別(multi-type)在的資料:

# 搜尋指定一個index下的所有資料
GET index1/_search

# 同時搜尋兩個index下的資料
GET index1,index2/_search

# 按照萬用字元匹配搜尋多個index下的資料
GET *1,*2/_search 

# 搜尋一個index下指定的type的資料
GET index1/type1/_search 

# 搜尋一個index下多個type的資料
GET index1/type1,type2/_search 

# 搜尋多個index下的多個type的資料
GET index1,index2/type1,type2/_search

# _all, 搜尋所有index下指定type的資料
GET _all/type1,type2/_search  

2 URI Search的使用

Elasticsearch支援通過在URI中攜帶請求引數執行搜尋.

2.1 GET請求攜帶引數查詢

// 分頁查詢: 
GET _search
{
    "from": 0,
    "size": 10
}

• HTTP協議一般不允許GET請求攜帶Request Body, 但由於GET更加符合查詢資料的操作, 因此可以攜帶Request Body. 而很多瀏覽器也都支援GET+request body模式.

• 如果遇到不支援的場景, 也可以用POST方式查詢, 即:

  POST _search
  {
      "from":0,
      "size":10
  }
  

• 或使用拼接請求引數的方式進行查詢:

  GET _search?from=0&size=10
  

上述拼接的請求引數就是Query String, 這個串拼接的欄位內容都是String, ES底層會對各個field的型別進行對映.

2.2 URI Search的引數列表

2.3 URI Search用法示例

// 查詢index1的type1中, field1=test的所有文件
GET index1/type1/_search?q=field1:test

// 查詢index1的type1中, 必須滿足field1=test的所有文件
GET index1/type1/_search?q=+test_field:test

// 查詢index1的type1中, 不滿足field1=test的所有文件
GET index1/type1/_search?q=-test_field:test

// 如果我們只想知道是否存在與查詢條件相匹配的文件, 而對文件的具體資訊不感興趣, 此時可以設定size=0. 
// 還可以設定terminate_after=1, 指明只要在每個shard中找到第一個匹配的文件, 就終止查詢: 
GET _search?q=field1:test&size=0&terminate_after=1

2.4 不指定field時的搜尋機制

GET index1/type1/_search?q=test
// 同樣, 可以使用"+"或"-"來控制是否包含某個關鍵字, 
// 比如, 查詢不包含java的所有文件: 
GET shop/it_book/_search?q=-java

ES預設為每個文件配置了_all元欄位, 將各個文件的所有field的值用字串拼接起來, 這個長字串就作為_all field的值, 同時建立索引.

查詢時, 如果不指定關鍵字所屬的field, ES將從_all欄位中搜索, 所有文件中只要存在field包含指定的關鍵字, 就算作匹配, 並將作為結果返回.

示例:

// 文件內容如下: 
{
    "name": "Java併發程式設計的藝術",
    "author": "方騰飛",
    "date": "2015-07",
    "publisher": "機械工業出版社"
}
// 搜尋條件
GET shop/it_book/_search?q=java

// 該文件_all欄位的值為: "Java併發程式設計的藝術 方騰飛 2015-07 機械工業出版社", _all欄位中包含java, 所以能夠匹配. 

說明: 生產環境中不建議開啟_all, 也不建議通過_all欄位進行查詢操作.

版權宣告

作者: ma_shoufeng(馬瘦風)

出處: CSDN 馬瘦風的部落格

您的支援是對博主的極大鼓勵, 感謝您的閱讀.

本文版權歸博主所有, 歡迎轉載, 但未經博主同意必須保留此段宣告, 且在文章頁面明顯位置給出原文連結, 否則博主保留追究相關人員法律責任的權利.