第三章-簡單的API
萬丈高樓平地起
ES提供了多種運算元據的方式,其中較為常見的方式就是RESTful風格的API。
簡單的體驗
利用Postman發起HTTP請求(當然也可以在命令列中使用curl命令)。
索引Index
建立索引
建立一個名叫demo
的索引:
PUT http://localhost:9200/demo
ES響應:
{
"acknowledged": true,
"shards_acknowledged": true,
"index": "demo"
}
在建立索引時,可指定主分片和分片副本的數量:
PUT http://localhost:9200/demo
{
"settings":{
"number_of_shards":1,
"number_of_replicas":1
}
}
ES響應:
{
"acknowledged": true,
"shards_acknowledged": true,
"index": "demo"
}
檢視指定索引
GET http://localhost:9200/demo
ES響應:
{
"demo": {
"aliases": {},
"mappings": {},
"settings": {
"index": {
"creation_date": "1561110747038",
"number_of_shards": "1",
"number_of_replicas": "1",
"uuid": "kjPqDUt6TMyywg1P7qgccw",
"version": {
"created": "5060499"
},
"provided_name": "demo"
}
}
}
}
查詢ES中的索引
查詢ES中索引情況:
GET http://localhost:9200/_cat/indices?v
ES響應:
health | status | index | uuid | pri | rep | docs.count | docs.deleted | store.size | pri.store.size |
---|---|---|---|---|---|---|---|---|---|
yellow | open | demo | wqkto5CCTpWNdP3HGpLfxA | 5 | 1 | 0 | 0 | 810b | 810b |
yellow | open | .kibana | pwKW9hJyRkO7_pE0MNE05g | 1 | 1 | 1 | 0 | 3.2kb | 3.2kb |
可以看到當前ES中一共有2個索引,一個是我們剛建立的demo
,另一個是kibana建立的索引.kibana
。表格中有一些資訊代表了索引的一些狀態。
health:健康狀態,red表示不是所有的主分片都可用,即部分主分片可用。yellow表示主分片可用備分片不可用,常常是單機ES的健康狀態,greens表示所有的主分片和備分片都可用。(官方對叢集健康狀態的說明,https://www.elastic.co/guide/en/elasticsearch/guide/master/cluster-health.html)
status:索引狀態,open表示開啟可對索引中的文件資料進行讀寫,close表示關閉此時索引佔用的記憶體會被釋放,但是此時索引不可進行讀寫操作。
index:索引
uuid:索引標識
pri:索引的主分片數量
rep:索引的分片副本數量,1表示有一個分片副本(有多少主分片就有多少備分片,此處表示5個備分片)。
docs.count:文件數量
docs.deleted:被刪除的文件數量
store.size:索引大小
pri.store.size:主分片佔用的大小
刪除索引
刪除demo
索引,刪除索引等同於刪庫跑路,請謹慎操作。
DELETE http://localhost:9200/demo
ES響應:
{
"acknowledged": true
}
型別Type(同時定義對映Mapping欄位及型別)
建立型別
在前面基本術語中我們提到型別Type類似關係型資料庫中的表,對映Mapping定義表結構。建立型別Type時需要配合對映Mapping。
建立索引demo
的型別為example_type
,包含兩個欄位:created
型別為date,message
型別為keyword:
方式一:
PUT http://localhost:9200/demo/_mapping/example_type
{
"properties":{
"created":{
"type":"date"
},
"message":{
"type":"keyword"
}
}
}
此時再次執行查詢索引的操作,已經可以發現型別Type被建立了,遺憾的是,如果型別Type(或者對映Mapping)一旦定義,就不能刪除,只能修改,為了保證本教程順利進行方式二建立型別,所以此處執行DELETE http://localhost:9200/demo
刪除索引。刪除索引後不要再建立索引,下面的這種方式是在建立索引的同時建立Type並定義Mapping
方式二:
PUT http://localhost:9200/demo
{
"mappings":{
"example_type":{
"properties":{
"created":{
"type":"date"
},
"message":{
"type":"keyword"
}
}
}
}
}
此時執行GET http://localhost:9200/demo
,可以看到我們在ES中建立了第一個索引以及建立的表結構,接下來插入就是資料(即文件)。
文件Document
插入文件
系統定義_id
POST http://localhost:9200/demo/example_type
{
"created":1561135459000,
"message":"test1"
}
ES響應:
{
"_index": "demo",
"_type": "example_type",
"_id": "AWt67Ql_Tf0FgxupYlBX",
"_version": 1,
"result": "created",
"_shards": {
"total": 2,
"successful": 1,
"failed": 0
},
"created": true
}
查詢文件
ElasticSearch的核心功能——搜尋。
POST http://localhost:9200/demo/example_type/_search?pretty
ES響應:
{
"took": 183,
"timed_out": false,
"_shards": {
"total": 5,
"successful": 5,
"skipped": 0,
"failed": 0
},
"hits": {
"total": 1,
"max_score": 1,
"hits": [
{
"_index": "demo",
"_type": "example_type",
"_id": "AWt67Ql_Tf0FgxupYlBX",
"_score": 1,
"_source": {
"created": 1561135459000,
"message": "test1"
}
}
]
}
}
關於文件的查詢是ElasticSearch的核心,後面的章節會詳細介紹一些基本的簡單查詢和更為高階的複雜查詢,此處僅作為對插入資料的驗證,不做過多展開。
修改文件
根據文件_id
修改
POST http://localhost:9200/demo/example_type/AWt67Ql_Tf0FgxupYlBX/_update
{
"doc":{
"message":"updated"
}
}
ES響應:
{
"_index": "demo",
"_type": "example_type",
"_id": "AWt67Ql_Tf0FgxupYlBX",
"_version": 2,
"result": "updated",
"_shards": {
"total": 2,
"successful": 1,
"failed": 0
}
}
刪除文件
刪除_id
為AWt67Ql_Tf0FgxupYlBX的文件
DELETE http://localhost:9200/demo/example_type/AWt67Ql_Tf0FgxupYlBX
ES的響應:
{
"found": true,
"_index": "demo",
"_type": "example_type",
"_id": "AWt67Ql_Tf0FgxupYlBX",
"_version": 2,
"result": "deleted",
"_shards": {
"total": 2,
"successful": 1,
"failed": 0
}
}
關注公眾號:CoderBuff,回覆“es”獲取《ElasticSearch6.x實戰教程》完整版PDF,回覆“抽獎”參與《從Lucene到Elasticsearch:全文檢索實戰》圖書抽獎活動(7.17-7.21)。