安裝
在安裝 Elasticsearch 之前,請確保你的計算機已經安裝了 Java。目前 Elasticsearch 的最新版是 5.2,需要安裝 Java 8,如果你用的是老版本的 Elasticsearch,如 2.x 版,可用 Java 7,但還是推薦使用 Java 8。
可以使用如下的命令檢查 Java 的版本:
$ java -version
接著,我們可以從這里下載最新版本的 Elasticsearch,也可使用 wget 下載,如下:
$ wget https://artifacts.elastic.co/downloads/elasticsearch/elasticsearch-5.5.1.tar.gz
下載完后進行解壓:
$ tar -zxvf elasticsearch-5.5.1.tar.gz
運行
注意:啟動elasticsearch的用戶不能是root。
首先,我們進入到剛剛解壓出來的目錄中:
$ cd elasticsearch-5.5.1
接著,使用如下命令啟動 Elasticsearch:
$ ./bin/elasticsearch
此時,如果正常的話,你可以在終端看到類似如下的輸出:
[2017-03-04T23:25:09,961][INFO ][o.e.n.Node ] [] initializing ...
[2017-03-04T23:25:10,073][INFO ][o.e.e.NodeEnvironment ] [yO11WLM] using [1] data paths, mounts [[/ (/dev/disk0s2)]], net usable_space [141.1gb], net total_space [232.9gb], spins? [unknown], types [hfs]
[2017-03-04T23:25:10,074][INFO ][o.e.e.NodeEnvironment ] [yO11WLM] heap size [1.9gb], compressed ordinary object pointers [true]
[2017-03-04T23:25:10,095][INFO ][o.e.n.Node ] node name [yO11WLM] derived from node ID [yO11WLMOQDuAOpZbYZYjzw]; set [node.name] to override
[2017-03-04T23:25:10,100][INFO ][o.e.n.Node ] version[5.5.1], pid[7607], build[db0d481/2017-02-09T22:05:32.386Z], OS[Mac OS X/10.11.5/x86_64], JVM[Oracle Corporation/Java HotSpot(TM) 64-Bit Server VM/1.8.0_102/25.102-b14]
[2017-03-04T23:25:11,363][INFO ][o.e.p.PluginsService ] [yO11WLM] loaded module [aggs-matrix-stats]
...
上面的命令是在前臺運行的,如果想在后臺以守護進程模式運行,可以加 -d 參數。
Elasticsearch 啟動后,也啟動了兩個端口 9200 和 9300:
- 9200 端口:HTTP RESTful 接口的通訊端口
- 9300 端口:TCP 通訊端口,用于集群間節點通信和與 Java 客戶端通信的端口
默認運行端口
安裝成功后,Elastic 就會在默認的9200端口運行。
請求地址:
現在,讓我們做一些測試。在瀏覽器訪問鏈接http://localhost:9200/,或使用 curl 命令:
curl 'http://localhost:9200/?pretty'
我們可以看到類似如下的輸出:
{
"name": "MxO5-r8",
"cluster_name": "elasticsearch",
"cluster_uuid": "uQakSfM7Qi-cphDkxwRdxg",
"version": {
"number": "5.5.1",
"build_hash": "19c13d0",
"build_date": "2017-07-18T20:44:24.823Z",
"build_snapshot": false,
"lucene_version": "6.6.0"
},
"tagline": "You Know, for Search"
}
概念
在進一步使用 Elasticsearch 之前,讓我們先了解幾個關鍵概念。
在邏輯層面:
- Index (索引):這里的 Index 是名詞,一個 Index 就像是傳統關系數據庫的 - Database,它是 Elasticsearch 用來存儲數據的邏輯區域。我們唯一需要做的僅僅是選擇一個索引名。這個名字必須是全部小寫,不能以下劃線開頭,不能包含逗號。
- Type (類型):文檔歸屬于一種 Type,就像是關系數據庫中的一個 Table
- Document (文檔):Elasticsearch 使用 JSON 文檔來表示一個對象,就像是關系數據庫中一個 Table 中的一行數據
- Field (字段):每個文檔包含多個字段,類似關系數據庫中一個 Table 的列
在ElasticSearch中,我們常常會聽到Index、Type以及Document等概念,那么它們與傳統的熟知的關系型數據庫中名稱的類比如下:
Relational DB 和 Elasticsearch的區別:
Mysql | Elasticsearch |
---|---|
Database(數據庫) | Index(索引) |
Table(表) | Type(類型) |
Row(行) | Document(文檔) |
Column(列) | Field(字段) |
Schema(表設計) | Mapping(映射) |
Index(索引) | Everything Indexed by default(所有字段都被索引) |
SQL(結構化查詢語言) | Query DSL(查詢專用語言) |
在物理層面:
- Node (節點):node 是一個運行著的 Elasticsearch 實例,一個 node 就是一個單獨的 server
- Cluster (集群):cluster 是多個 node 的集合
- Shard (分片):數據分片,一個 index 可能會存在于多個 shard
其文件目錄結構如下:
elasticsearch---這是Elasticsearch解壓的目錄
bin---這里面是ES啟動的腳本
conf---elasticsearch.yml為ES的配置文件
data---這里是ES得當前節點的分片的數據,可以直接拷貝到其他的節點進行使用
logs---日志文件
plugins---這里存放一些常用的插件,如果有一切額外的插件,可以放在這里使用。
HTTP請求鏈接說明
一個 Elasticsearch 請求和任何 HTTP 請求一樣由若干相同的部件組成:
curl -X<VERB> '<PROTOCOL>://<HOST>:<PORT>/<PATH>?<QUERY_STRING>' -d '<BODY>'
被 < >
標記的部件:
參數 | 說明 |
---|---|
VERB | 適當的 HTTP 方法 或 謂詞 : GET 、 POST 、 PUT 、 HEAD 或者 DELETE 。 |
PROTOCOL |
http 或者 https (如果你在 Elasticsearch 前面有一個 https 代理) |
HOST | Elasticsearch 集群中任意節點的主機名,或者用 +localhost+ 代表本地機器上的節點。 |
PORT | 運行 Elasticsearch HTTP 服務的端口號,默認是 9200 。 |
PATH | API 的終端路徑(例如 _count 將返回集群中文檔數量)。Path 可能包含多個組件,例如:_cluster/stats 和 _nodes/stats/jvm 。 |
QUERY_STRING | 任意可選的查詢字符串參數 (例如 ?pretty 將格式化地輸出 JSON 返回值,使其更容易閱讀) |
BODY | 一個 JSON 格式的請求體 (如果請求需要的話) |
解決不能以root身份運行
在ElasticSearch 2.x版本中,默認是不允許以Root用戶身份運行實例,可以使用bin/elasticsearch -Des.insecure.allow.root=true來以Root身份啟動集群,此外還可以使用bin/elasticsearch -f -Des.path.conf=/path/to/config/dir參數來讀取相關的.yml或者.json配置。
Restful API
參考文檔:
https://juejin.im/entry/57e222528ac24700617b8c78
https://imququ.com/post/elasticsearch.html
http://blog.csdn.net/lvhong84/article/details/23936697