《ElasticSearch6.x實戰教程》之簡單的API

OKevin發表於2019-07-19

第三章-簡單的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)。

這是一個能給程式設計師加buff的公眾號 (CoderBuff)
《ElasticSearch6.x實戰教程》之簡單的API

相關文章