1. Lời Mở Đầu
chào các bạn, lại là mình đây, ở phần trước mình đã giới thiệu sơ qua về đặc điểm của elastic search cũng như cách cài đặt nó trên ubuntu, nếu các bạn chưa xem thì có thể nhấn link sau: Phần 1. Ở phần này, mình sẽ hướng dẫn cài đặt elastic trên windows cũng như thực hiện 1 vài truy vấn cơ bản
2. Cài Đặt Elastic Search Trên Windows
A. thông tin phiên bản
- Windows 10 Pro x64
- Elastic Search 7.12.1
- Kibana 7.12.1
B. Cài Java
cài java
các bạn có thể cài jdk 8 theo link sau: JDK
set up java home
vào mục enviroments variable->trong phần system variables thêm vào như sau
tìm vào biến PATH thêm đường dẫn /bin
các bạn có thể test xem cài được chưa bằng lệnh java –-version
C. Cài ElasticSearch
vào thư mục elasticsearch->bin->elasticsearch.bat và chờ khoảng 30 giây, nếu không có vấn đề gì thì khi bạn gõ lệnh curl localhost:9200
nó sẽ hiện ra như sau
D. Cài Kibana
tương tự với elasticsearch các bạn vào thư mục kibana phần bin/kibana.bat để mở tuy nhiên mình đã thử và không thấy hiện, mình đã thử tắt kibana đồng thời sửa phần config giống như mình đã làm với linux ở phần 1, sau đó mình mở lại kibana.bat và sau khoảng gần 1 phút cuối cùng nó cũng đã chạy, nói chung các bạn chờ 5 phút mà không thấy nó hiện thì thử tắt firewall ( không lên nữa thì tải elastic và kibana 6 thôi, nhiều thằng có mấy cái bug khó chịu lắm )
mình có thử tra qua vấn đề này trên mạng thì có vẻ đây là bug hay firewall gì đấy nói chung trước khi chạy các bạn thử tắt firewall thử, link bugs: https://discuss.elastic.co/t/kibana-bat-shows-nothing-on-windows-10/163611, không có kibana thì ban đầu dùng postman cũng ổn mà
3. Cách Sử dụng API
lưu ý: nếu các bạn không thể khởi động kibana do port đã bị process khác chiếm dụng thì các bạn có thể đổi port trong thư mục config hoặc làm theo cách sau:
sudo netstat -lpn |grep :8080
tìm processId của nó và gắn vào câu lệnh sau
kill -p <processID>
ở đây mình sẽ không nói lại về định nghĩa API cũng như các phương thức của nó , các bạn có thể tham khảo thông qua link dưới đây: API
A. Linux
cách 1. Truy cập trực tiếp thông qua Elastic
ở trên linux ta có thể dễ dàng sử dụng elastic thông qua câu lệnh curl
: curl -X PHƯƠNG_THỨC http://localhost:9200
VD:
curl -X GET http://localhost:9200
truy cập elasticsearch thông qua phương thức GET
tiếp theo ta sẽ gởi thông tin với dữ liệu JSON khi cần gửi dữ liệu JSON đi kèm, cần chỉ định HEADER Content-Type: application/json
để làm điều này cho vào tham số curl đoạn mã -H Content-Type: application/json
, sau đó là nội dung JSON-d {Nội dung JSON}
ví dụ : để tạo mới 1 dữ liệu bằng phương thức PUT
curl -X PUT "localhost:9200/customer/_doc/1?pretty" -H 'Content-Type: appliation/json' -d' { "name": "John Doe", "age": "20" }
cách 2. Tương tác với Elastic Thông qua Kibana
mở kibana thông qua port - 5601 : “localhost:5601“ hoặc “your-linux-machine-ip:5601“ nếu bạn dùng vmware
để chạy các dòng lệnh các bạn cần bôi đen chúng rồi nhấn vào biểu tượng play ở bên phải
B. Windows
đối với window ngoài việc sử dụng kibana, thì với bản chất là truy vấn API các bạn còn có thể sử dụng Postman
4. Truy vấn cơ bản trong ElasticSearch
A. Kiểm tra tình trạng của ElasticSearch
các bạn có thể thử sử dụng API bằng cách gọi API kiểm tra tình trạng của elastic: localhost:9200/_cat/health?v
LINUX
WINDOWS với postman
để ý cột status có 3 trạng thái chính • Green Mọi thứ OK, cluster có thể thực hiện đầy đủ chức năng • Yellow Dữ liệu ổn, nhưng có các bản backup replicas • Red dữ liệu có vấn đề
B. xây dựng data bằng phương thức POST và PUT
ở đây mình sẽ sử dụng dev tools của kibana cho nhanh
để thêm dữ liệu cho ElasticSearch đầu tiên ta tạo 1 index
PUT school
nếu tạo thành công nó sẽ trả về như sau:
{"acknowledged": true}
thêm vào index school 1 _doc có _id = 10
POST school/_doc/10
{ "name":"Saint Paul School", "description":"ICSE Afiliation", "street":"Dawarka", "city":"Delhi", "state":"Delhi", "zip":"110075", "location":[28.5733056, 77.0122136], "fees":5000, "tags":["Good Faculty", "Great Sports"], "rating":"4.5"
}
như các bạn có thể thấy dữ liệu được thêm vào sẽ nằm trong phần source
C. Các phương thức hỗ trợ xóa và sửa
phương thức xóa
bạn có thể xóa 1 index thông qua phương thức DELETE
ở đây mình xóa 1 _doc có _id = 10
DELETE school/_doc/10 nếu thành công bạn sẽ nhận được response sau:
{ "found":true, "_index":"schools", "_type":"school", "_id":"10", "_version":2, "_shards":{"total":2, "successful":1, "failed":0
}
phương thức sửa tham khảo thêm: https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-update.html sửa _doc trong index school có _id = 10
- sửa 1 dòng ở đây mình muốn sửa dữ liệu bên trên sname thành “Viablo School”
POST school/_update/10
{ "script" : { "source": "ctx._source.name = params.sname", gán source name = sname bên trong params "lang": "painless", "params" : { "sname" : "Viablo School" } } }
- sửa bên trong mảng ở đây mình muốn sửa bên trong mảng tags bên trên thêm “cool”
POST school/_update/10
{ "script" : { "source": " ctx._source.tags.add(params.tag)", "lang": "painless", "params" : { "tag" :”Cool" } } }
D. Phương thức tìm kiếm cơ bản
1. Tìm Kiếm Cơ Bản
- xem document thông qua 1 vài dòng
GET schools/_doc/10?_source_includes=name,fees
- Chỉ xem thông tin của phần
_source
như các bạn đã thấy ngoài phần source là thông tin chính mà chúng ta đã thêm vào còn rất nhiều thông tin không cần thiết, để dễ trong công việc sau này, ta phải loại bỏ chúng
GET schools/_doc/10?_source
- Lấy thông tin trên nhiều index
GET /index1,index2,index3/_search
<hình>
2. Tham Số Tìm Kiếm
lưu ý : những thông tin được trả ra khi sử dụng _search
sẽ được lưu trong trong thuộc tính “hits” dưới dạng mảng , các bạn cần chú ý khi sử dụng sau này
- tham số “q”: tìm kiếm thông tin trong 1 trường
POST school/_search/?q=city:Delhi
- tham số "fields": Lấy thông tin từ trường được chỉ định sẵn
POST school/_search
{ "fields": ["city"], "_source": false
}
- Tham Số "from":
POST school/_search/?from=0
đây là điểm bắt đầu trong index
giả sử trong index của bạn chỉ có 1 docs nhưng bạn lại để giá trị from là 1 thì sẽ giá trị trả về là rỗng
- tham số "sort": tham số này sẽ sort các cột theo giảm dần (desc) hoặc tăng dần (asc)
POST school/_search/?sort=fees:asc
- tham số "size": số lượng docs sẽ được trả về, mặc định là 10
POST school/_search/?size=20
4. Tổng Kết
Hello, cuối cùng đã kết thúc xong phần 2 của Series ElasticSearch, mình cũng vừa viết vừa học nên cũng không có nhiều kinh nghiệm lắm , ở phần sau mình dự định sẽ làm về các truy vấn nâng cao cũng như mình sẽ đào sâu 1 chút vào kibana, mình cũng dự định sẽ tìm cách kết hợp ElasticSearch với một database nào đó (ai cũng bảo nói là search engine bên cạnh database chính mà , như các bạn đã thấy ở trên nó thực hiện các lệnh thêm, sửa, xóa hơi dỏm tí ) thế nên mong các bạn đón xem
như thường lệ, nếu có vấn đề nào thắc mắc mong các bạn có thể comment để mình có thể support hết sức
LAST-EDIT: HÓNG MAY ~ FEST
5. Tham Khảo
- Các lệnh trong elastic - https://www.tutorialspoint.com/elasticsearch/index.htm
- Elastic cơ bản - https://xuanthulab.net/tao-va-cap-nhat-index-document-trong-elasticsearch.html
- Elastic docs apis (hướng dẫn cực kì cụ thể) - https://www.elastic.co/guide/en/elasticsearch/reference/current/rest-apis.html