Iepazīstinām ar Elasticsearch soli pa solim

Sveiki!
Šodien mēs runāsim par pilna teksta meklētājprogrammu Elasticsearch (turpmāk ES), ar kuru
Darbojas platforma Docsvision 5.5.

Iepazīstinām ar Elasticsearch soli pa solim

1. UzstādīŔana

PaÅ”reizējo versiju varat lejupielādēt no saites: www.elastic.co/downloads/elasticsearch
InstalÄ“Å”anas programmas ekrānuzņēmums zemāk:
Iepazīstinām ar Elasticsearch soli pa solim

2. Funkcionalitātes pārbaude

Kad instalēŔana ir pabeigta, dodieties uz
http://localhost:9200/
Ir jāparāda ES statusa lapa, piemēram:
Iepazīstinām ar Elasticsearch soli pa solim

Ja lapa netiek atvērta, pārliecinieties, vai darbojas Elasticsearch pakalpojums. Operētājsistēmā Windows tas ir
Elasticsearch pakalpojums.
Iepazīstinām ar Elasticsearch soli pa solim

3. Izveidojiet savienojumu ar Docsvision

Savienojums ar Elasticsearch ir konfigurēts pilna teksta pakalpojuma lapā
indeksēŔana.
Iepazīstinām ar Elasticsearch soli pa solim

Šeit jums jānorāda:
1. Elasticsearch servera adrese (iestatÄ«ta instalÄ“Å”anas laikā).
2. Savienojuma virkne ar DBVS.
3. Docsvision adrese (formātā ConnectAddress=http://SERVER/DocsVision/StorageServer/StorageServerService.
asmx
)
4. Cilnēs ā€œKartesā€ un ā€œKatalogiā€ ir jākonfigurē dati, kas
ir jāindeksē.
Jums arī jāpārliecinās, vai konts, kurā darbojas pakalpojums Docsvision
Pilna teksta indeksÄ“Å”anas pakalpojums, ir piekļuve Docsvision datubāzei MS SQL.
Pēc savienojuma izveides jums jāpārliecinās, ka MS SQL datu bāzē ir izveidoti darbi ar prefiksu:
"DV:FullText_<DBNAME>_CardWithFilesPrepareRange"
Iepazīstinām ar Elasticsearch soli pa solim

Pēc iestatÄ«jumu pabeigÅ”anas Windows klientā meklÄ“Å”anas josla tiks atbloķēta.

4. REST API elastīgs

Administrators var iegūt dažādu informāciju par Elasticsearch darbību, izmantojot
nodroŔina REST API.
Turpmākajos piemēros mēs izmantosim Insomnia Rest Client.

Vispārīgas informācijas iegūŔana

Kad pakalpojums ir izveidots un darbojas (pārlūkprogrammā http://localhost:9200/), varat
izpildiet pieprasījumu:
http://localhost:9200/_cat/health?v

Saņemsim atbildi par pakalpojuma Elasticsearch stāvokli (pārlūkprogrammā):
Iepazīstinām ar Elasticsearch soli pa solim
Bezmiega stāvokļa reakcija:
Iepazīstinām ar Elasticsearch soli pa solim
PievērsÄ«sim uzmanÄ«bu Statusam ā€“ ZaļŔ, Dzeltens, Sarkans. Oficiālā dokumentācija par statusiem saka:
ā€¢ ZaļŔ ā€” viss ir labi (kopa pilnÄ«bā darbojas)
ā€¢ Dzeltens ā€” visi dati ir pieejami, taču dažas kopas kopas tam vēl nav pieŔķirtas.
ā€¢ Sarkans ā€” daļa datu kāda iemesla dēļ nav pieejami (pats klasteris darbojas normāli).
Stāvokļa iegūŔana par klastera mezgliem un to stāvokli (man ir 1 mezgls):
http://localhost:9200/_cat/nodes?v
Iepazīstinām ar Elasticsearch soli pa solim

Visi ES indeksi:
http://localhost:9200/_cat/indices?v
Iepazīstinām ar Elasticsearch soli pa solim

Papildus indeksiem no Docsvision var būt arī citu lietojumprogrammu indeksi - sirdsdarbība,
kibana - ja jÅ«s tos lietojat. VajadzÄ«gos var Ŕķirot no nevajadzÄ«gajiem. Piemēram,
Ņemsim tikai tos indeksus, kuru nosaukumā ir %card%:
http://localhost:9200/_cat/indices/*card*?v&s=index
Iepazīstinām ar Elasticsearch soli pa solim

Elasticsearch konfigurācija

Elasticsearch iestatījumu iegūŔana:
http://localhost:9200/_nodes
Rezultāts būs diezgan plaŔs, ieskaitot ceļus uz žurnāliem:
Iepazīstinām ar Elasticsearch soli pa solim

Mēs jau zinām, kā uzzināt indeksu sarakstu; Docsvision to dara automātiski, pieŔķirot indeksam nosaukumu Ŕādā formātā:
<datu bāzes nosaukums+indeksētās kartes veids>
Varat arī izveidot savu neatkarīgo indeksu:
http://localhost:9200/customer?pretty
Tikai tas nebūs GET, bet gan PUT pieprasījums:
Iepazīstinām ar Elasticsearch soli pa solim

Rezultāts:
Iepazīstinām ar Elasticsearch soli pa solim

Šis vaicājums parādīs visus indeksus, tostarp jaunos (klientu):
http://localhost:9200/_cat/indices?v
Iepazīstinām ar Elasticsearch soli pa solim

5. Informācijas iegÅ«Å”ana par indeksētajiem datiem

Elasticsearch indeksa statuss

Kad sākotnējā Docsvision konfigurācija ir pabeigta, pakalpojumam jābÅ«t gatavam darbam un jāsāk datu indeksÄ“Å”ana.
Vispirms pārbaudÄ«sim, vai indeksi ir aizpildÄ«ti un to izmērs ir lielāks par standarta ā€œbaitiemā€, izmantojot mums jau pazÄ«stamu vaicājumu:
http://localhost:9200/_cat/indices?v
kā rezultātā mēs redzam: 87 ā€œuzdevumiā€ un 72 ā€œdokumentiā€ tika indeksēti, runājot par mÅ«su EDMS:
Iepazīstinām ar Elasticsearch soli pa solim

Pēc kāda laika rezultāti ir Ŕādi (pēc noklusējuma indeksÄ“Å”anas darbi tiek palaisti ik pēc 5 minÅ«tēm):
Iepazīstinām ar Elasticsearch soli pa solim

Redzam, ka dokumentu skaits ir pieaudzis.

Kā zināt, ka vajadzīgā karte ir indeksēta?

ā€¢ Pirmkārt, jums ir jāpārliecinās, vai kartes veids programmā Docsvision atbilst Elascticsearch iestatÄ«jumos norādÄ«tajiem datiem.
ā€¢ Otrkārt, pagaidiet, lÄ«dz karÅ”u masÄ«vs tiks indeksēts ā€” kad tas nokļūst programmā Docsvision, jāpaiet zināmam laikam, lÄ«dz dati parādās krātuvē.
ā€¢ TreÅ”kārt, karti var meklēt pēc CardID. To var izdarÄ«t ar Ŕādu pieprasÄ«jumu:

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

Ja karte atrodas krātuvē, mēs redzēsim tās ā€œneapstrādātosā€ datus; ja nē, mēs redzēsim kaut ko lÄ«dzÄ«gu:
Iepazīstinām ar Elasticsearch soli pa solim

Kartes meklÄ“Å”ana Elasticsearch mezglā

Atrodiet dokumentu pēc precīzas atbilstības laukam Apraksts:
http://localhost:9200/_search?q=description: Š˜ŃŃ…Š¾Š“ящŠøŠ¹ tv1
Rezultāts:
Iepazīstinām ar Elasticsearch soli pa solim

meklēt dokumentu, kura aprakstā ir ieraksts "IenākoÅ”ais".
http://localhost:9200/_search?q=description like Š’Ń…Š¾Š“ящŠøŠ¹
Rezultāts:
Iepazīstinām ar Elasticsearch soli pa solim

Meklējiet karti pēc pievienotā faila satura
http://localhost:9200/_search?q=content like ā€˜AGILEā€™
rezultāts:
Iepazīstinām ar Elasticsearch soli pa solim

Atradīsim visas dokumenta veida kartes:
http://localhost:9200/_search?q=_type:CardDocument

vai visas uzdevuma veida kartes:
http://localhost:9200/_search?q=_type:CardTask

Izmantojot dizainus un un parametrus, ko Elasticsearch sniedz JSON formātā, varat apkopot Ŕādu pieprasījumu:
http://localhost:9200/_search?q=_type:CardTask and Employee_RoomNumber: ŠžŃ€Ń‘Š» Š¾Ń„Šøc and Employee_FirstName:Konstantin

Tajā tiks rādītas visas uzdevuma veida kartītes starp lietotājiem, kuru vārds = Konstantīns un kuri atrodas Orel birojā.
Bet LÄŖDZÄŖGI Ir arÄ« citi dokumentēti parametri:
atŔķirībā no laukiem, dokumentiem, satura utt.
Visi no tiem ir aprakstīti Ŕeit.

Tas arī viss Ŕodienai!

#docsvision #docsvisionECM

Noderīgas saites:

  1. Insomnia Rest klients 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

Avots: www.habr.com

Pievieno komentāru