წარმოგიდგენთ Elasticsearch-ს ეტაპობრივად

Hello!
დღეს ვისაუბრებთ სრული ტექსტის საძიებო სისტემაზე Elasticsearch (შემდგომში ES), რომლითაც
მუშაობს Docsvision 5.5 პლატფორმა.

1. მონტაჟი

მიმდინარე ვერსია შეგიძლიათ ჩამოტვირთოთ ბმულიდან: www.elastic.co/downloads/elasticsearch
ინსტალერის ეკრანის სურათი ქვემოთ:

2. ფუნქციონალურობის შემოწმება

ინსტალაციის დასრულების შემდეგ გადადით
http://localhost:9200/
ES სტატუსის გვერდი უნდა იყოს ნაჩვენები, მაგალითად ქვემოთ:

თუ გვერდი არ იხსნება, დარწმუნდით, რომ Elasticsearch სერვისი მუშაობს. ვინდოუსზე ეს არის
Elasticsearch სერვისი.

3. დაუკავშირდით Docsvision-ს

Elasticsearch-თან კავშირი კონფიგურირებულია სრული ტექსტის სერვისის გვერდზე
ინდექსირება.


აქ თქვენ უნდა მიუთითოთ:
1. Elasticsearch სერვერის მისამართი (დაყენებულია ინსტალაციის დროს).
2. კავშირის სტრიქონი DBMS-თან.
3. Docsvision მისამართი (ფორმატით ConnectAddress=http://SERVER/DocsVision/StorageServer/StorageServerService.
asmx)
4. „ბარათების“ და „დირექტორიების“ ჩანართზე, თქვენ უნდა დააკონფიგურიროთ მონაცემები, რომლებიც
საჭიროებს ინდექსირებას.
თქვენ ასევე უნდა დარწმუნდეთ, რომ ანგარიში, რომლითაც მუშაობს Docsvision სერვისი
Fulltext Indexing სერვისს აქვს წვდომა Docsvision მონაცემთა ბაზაზე MS SQL-ზე.
დაკავშირების შემდეგ, თქვენ უნდა დარწმუნდეთ, რომ სამუშაოები პრეფიქსით შექმნილია MS SQL მონაცემთა ბაზაში:
"DV:FullText_<DBNAME>_CardWithFilesPrepareRange"


პარამეტრების დასრულების შემდეგ, საძიებო ზოლი განიბლოკება Windows კლიენტში.

4. REST API ელასტიური

ადმინისტრატორს შეუძლია მიიღოს სხვადასხვა ინფორმაცია Elasticsearch-ის მუშაობის შესახებ
მოწოდებულია REST API-ით.
შემდეგ მაგალითებში ჩვენ გამოვიყენებთ Insomnia Rest Client-ს.

ზოგადი ინფორმაციის მიღება

სერვისის ამოქმედების შემდეგ (http://localhost:9200/ ბრაუზერში), შეგიძლიათ
შეასრულეთ მოთხოვნა:
http://localhost:9200/_cat/health?v

მოდით მივიღოთ პასუხი Elasticsearch სერვისის მდგომარეობის შესახებ (ბრაუზერში):

უძილობის სტატუსის პასუხი:

ყურადღება მივაქციოთ სტატუსს - მწვანე, ყვითელი, წითელი. ოფიციალურ დოკუმენტაციაში ნათქვამია შემდეგი სტატუსების შესახებ:
• მწვანე — ყველაფერი კარგად არის (კლასტერი სრულად ფუნქციონირებს)
• ყვითელი - ყველა მონაცემი ხელმისაწვდომია, მაგრამ კლასტერში ზოგიერთი ასლი ჯერ არ არის გამოყოფილი მისთვის
• წითელი — მონაცემთა ნაწილი მიუწვდომელია რაიმე მიზეზით (თავად კლასტერი ნორმალურად ფუნქციონირებს)
კლასტერში არსებული კვანძების და მათი მდგომარეობის შესახებ მდგომარეობების მიღება (მე მაქვს 1 კვანძი):
http://localhost:9200/_cat/nodes?v


ყველა ES ინდექსი:
http://localhost:9200/_cat/indices?v


Docsvision-ის ინდექსების გარდა, შეიძლება არსებობდეს სხვა აპლიკაციების ინდექსებიც - გულისცემა,
კიბანა - თუ იყენებთ მათ. თქვენ შეგიძლიათ დაალაგოთ საჭიროები არასაჭიროდან. Მაგალითად,
ავიღოთ მხოლოდ ინდექსები, რომლებსაც აქვთ %card% სახელში:
http://localhost:9200/_cat/indices/*card*?v&s=index

Elasticsearch კონფიგურაცია

Elasticsearch პარამეტრების მიღება:
http://localhost:9200/_nodes
შედეგი იქნება საკმაოდ ვრცელი, მათ შორის ბილიკები ჟურნალებისკენ:


ჩვენ უკვე ვიცით, როგორ გავარკვიოთ ინდექსების სია; Docsvision ამას ავტომატურად აკეთებს, ინდექსს ასახელებს ფორმატში:
<მონაცემთა ბაზის სახელი+ინდექსირებული ბარათის ტიპი>
თქვენ ასევე შეგიძლიათ შექმნათ თქვენი დამოუკიდებელი ინდექსი:
http://localhost:9200/customer?pretty
მხოლოდ ეს არ იქნება GET, არამედ PUT მოთხოვნა:


შედეგი:


შემდეგი მოთხოვნა აჩვენებს ყველა ინდექსს, მათ შორის ახალს (მომხმარებელს):
http://localhost:9200/_cat/indices?v

5. ინდექსირებული მონაცემების შესახებ ინფორმაციის მოპოვება

Elasticsearch ინდექსის სტატუსი

Docsvision-ის მიერ საწყისი კონფიგურაციის დასრულების შემდეგ, სერვისი მზად უნდა იყოს ფუნქციონირებისთვის და დაიწყოს მონაცემების ინდექსირება.
უპირველეს ყოვლისა, მოდით შევამოწმოთ, რომ ინდექსები შევსებულია და მათი ზომა აღემატება სტანდარტულ „ბაიტებს“ ჩვენთვის უკვე ნაცნობი შეკითხვის გამოყენებით:
http://localhost:9200/_cat/indices?v
შედეგად, ჩვენ ვხედავთ: ინდექსირებული იყო 87 „დავალება“ და 72 „დოკუმენტი“, რაც ვსაუბრობთ ჩვენი EDMS-ის მიხედვით:


გარკვეული პერიოდის შემდეგ, შედეგები შემდეგია (ნაგულისხმევად, ინდექსირების სამუშაოები იწყება ყოველ 5 წუთში):


ჩვენ ვხედავთ, რომ საბუთების რაოდენობა გაიზარდა.

როგორ იცით, რომ თქვენთვის საჭირო ბარათი ინდექსირებულია?

• პირველ რიგში, თქვენ უნდა დარწმუნდეთ, რომ ბარათის ტიპი Docsvision-ში ემთხვევა Elascticsearch პარამეტრებში მითითებულ მონაცემებს.
• მეორეც, დაელოდეთ ბარათების მასივის ინდექსირებას - როდესაც ის მოხვდება Docsvision-ში, გარკვეული დრო უნდა გავიდეს, სანამ მონაცემები გამოჩნდება მეხსიერებაში.
• მესამე, შეგიძლიათ მოძებნოთ ბარათი CardID-ით. ამის გაკეთება შეგიძლიათ შემდეგი მოთხოვნით:

http://localhost:9200/_search?q=_id=2116C498-9D34-44C9-99B0-CE89465637C9

თუ ბარათი საცავშია, ჩვენ დავინახავთ მის „ნედლეულ“ მონაცემებს, თუ არა, ჩვენ ვნახავთ მსგავს რაღაცას:

ბარათის ძიება Elasticsearch კვანძში

იპოვეთ დოკუმენტი აღწერილობის ველის ზუსტი თანხვედრის მიხედვით:
http://localhost:9200/_search?q=description: Исходящий tv1
შედეგი:


მოძებნეთ დოკუმენტი, რომელსაც აქვს ჩანაწერი „შემომავალი“ მის აღწერაში
http://localhost:9200/_search?q=description like Входящий
შედეგი:


მოძებნეთ ბარათი თანდართული ფაილის შინაარსით
http://localhost:9200/_search?q=content like ‘AGILE’
შედეგი:


მოდი ვიპოვოთ დოკუმენტის ტიპის ყველა ბარათი:
http://localhost:9200/_search?q=_type:CardDocument

ან დავალების ტიპის ყველა ბარათი:
http://localhost:9200/_search?q=_type:CardTask

დიზაინის გამოყენება მდე და პარამეტრებს, რომლებსაც Elasticsearch იძლევა JSON-ის სახით, შეგიძლიათ შეაგროვოთ შემდეგი მოთხოვნა:
http://localhost:9200/_search?q=_type:CardTask and Employee_RoomNumber: Орёл офиc and Employee_FirstName:Konstantin

ის აჩვენებს ამოცანის ტიპის ყველა ბარათს, იმ მომხმარებლებს შორის, რომელთა FirstName = კონსტანტინე და რომლებიც არიან Orel Office-ში.
მაგრამ მსგავსი არსებობს სხვა დოკუმენტირებული პარამეტრები:
განსხვავებით, ველები, დოკუმენტები, შინაარსი და ა.შ.
ყველა მათგანი აღწერილია აქ.

დღეისთვის სულ ესაა!

#docsvision #docsvisionECM

სასარგებლო ბმულები:

1. Insomnia Rest კლიენტი https://insomnia.rest/download/#windows
2. https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-get.html
3. https://www.elastic.co/guide/en/elasticsearch/reference/1.4/_exploring_your_data.html
4. https://stackoverflow.com/questions/50278255/elasticsearch-backup-on-windows-and-restore-on-linux
5. https://z0z0.me/how-to-create-snapshot-and-restore-snapshot-with-elasticsearch/
6. https://www.elastic.co/guide/en/elasticsearch/reference/current/query-dsl-mlt-query.html#_document_input_parameters
7. http://qaru.site/questions/15663281/elasticsearch-backup-on-windows-and-restore-on-linux

წყარო: www.habr.com