Elasticsearchi tutvustamine samm-sammult

Tere!
Täna tuleb juttu täisteksti otsingumootorist Elasticsearch (edaspidi ES), millega
Docsvision 5.5 platvorm töötab.

1. Paigaldamine

Praeguse versiooni saate alla laadida lingilt: www.elastic.co/downloads/elasticsearch
Installeri ekraanipilt allpool:

2. Funktsionaalsuse kontroll

Kui installimine on lõpetatud, minge aadressile
http://localhost:9200/
Kuvatakse ES oleku leht, näiteks allpool:

Kui leht ei avane, veenduge, et teenus Elasticsearch töötab. Windowsis on see nii
Elasticsearch teenus.

3. Ühendage Docsvisioniga

Ühendus Elasticsearchiga on konfigureeritud täistekstiteenuse lehel
indekseerimine.


Siin peate märkima:
1. Elasticsearch serveri aadress (määratakse installimise ajal).
2. Ühendusstring DBMS-iga.
3. Docsvisioni aadress (vormingus ConnectAddress=http://SERVER/DocsVision/StorageServer/StorageServerService.
asmx)
4. Vahekaartidel "Kaardid" ja "Kataloogid" peate konfigureerima andmed, mis
tuleb indekseerida.
Samuti peate veenduma, et konto, mille all teenus Docsvision töötab
Täisteksti indekseerimise teenus, millel on juurdepääs Docsvisioni andmebaasile MS SQL-is.
Pärast ühenduse loomist peate veenduma, et MS SQL-i andmebaasis luuakse eesliitega tööd:
"DV:FullText_<DBNAME>_CardWithFilesPrepareRange"


Pärast sätete lõpetamist avatakse Windowsi kliendi otsinguriba.

4. REST API elastik

Administraator saab Elasticsearchi toimimise kohta mitmesugust teavet kasutades
pakub REST API.
Järgmistes näidetes kasutame Insomnia Rest Clienti.

Üldise teabe saamine

Kui teenus on valmis (http://localhost:9200/ brauseris), saate seda teha
käivitage taotlus:
http://localhost:9200/_cat/health?v

Saame vastuse Elasticsearchi teenuse oleku kohta (brauseris):

Unetuse seisundi reaktsioon:

Pöörame tähelepanu olekule – roheline, kollane, punane. Ametlik dokumentatsioon ütleb olekute kohta järgmist:
• Roheline – kõik on hästi (klaster on täielikult töökorras)
• Kollane – kõik andmed on saadaval, kuid mõned klastri koopiad pole sellele veel eraldatud
• Punane – osa andmetest pole mingil põhjusel saadaval (klaster ise töötab normaalselt)
Olekute hankimine klastri sõlmede ja nende oleku kohta (mul on 1 sõlm):
http://localhost:9200/_cat/nodes?v


Kõik ES indeksid:
http://localhost:9200/_cat/indices?v


Lisaks Docsvisioni indeksitele võivad olla ka muude rakenduste indeksid - südamelöögid,
kibana - kui te neid kasutate. Vajalikud saab ebavajalike hulgast sorteerida. Näiteks,
Võtame ainult indeksid, mille nimes on %card%:
http://localhost:9200/_cat/indices/*card*?v&s=index

Elasticsearchi konfiguratsioon

Elasticsearchi seadete hankimine:
http://localhost:9200/_nodes
Tulemus on üsna ulatuslik, sealhulgas teed logideni:


Me juba teame, kuidas indeksite loendit välja selgitada; Docsvision teeb seda automaatselt, andes indeksile nime järgmises vormingus:
<andmebaasi nimi+indekseeritud kaardi tüüp>
Saate luua ka oma sõltumatu indeksi:
http://localhost:9200/customer?pretty
Ainult see ei ole GET-i, vaid PUT-i päring:


Tulemus:


järgmine päring näitab kõiki indekseid, sealhulgas uusi (klient):
http://localhost:9200/_cat/indices?v

5. Info hankimine indekseeritud andmete kohta

Elasticsearchi indeksi olek

Pärast Docsvisioni esialgse konfigureerimise lõpetamist peaks teenus olema töövalmis ja alustama andmete indekseerimist.
Kõigepealt kontrollime meile juba tuttava päringu abil, kas indeksid on täidetud ja nende suurus on suurem kui standardsed “baitid”:
http://localhost:9200/_cat/indices?v
Selle tulemusena näeme: 87 "ülesannet" ja 72 "dokumenti" indekseeriti, rääkides meie EDMS-ist:


Mõne aja pärast on tulemused järgmised (vaikimisi käivitatakse indekseerimistööd iga 5 minuti järel):


Näeme, et dokumentide arv on kasvanud.

Kuidas aru saada, et vajalik kaart on indekseeritud?

• Esiteks peate veenduma, et kaardi tüüp Docsvisionis ühtib Elascticsearch seadetes määratud andmetega.
• Teiseks oodake, kuni kaartide massiiv on indekseeritud – kui see Docsvisioni jõuab, peab mööduma mõni aeg, enne kui andmed salvestusruumi ilmuvad.
• Kolmandaks saab kaarti otsida CardID järgi. Seda saate teha järgmise taotlusega:

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

Kui kaart on salvestusruumis, näeme selle "tooreid" andmeid; kui ei, siis näeme midagi sellist:

Kaardi otsimine Elasticsearchi sõlmest

Otsige dokument välja Kirjelduse täpse vaste järgi:
http://localhost:9200/_search?q=description: Исходящий tv1
Tulemus:


otsige dokumenti, mille kirjelduses on kirje "Sissetulev".
http://localhost:9200/_search?q=description like Входящий
Tulemus:


Otsige kaarti lisatud faili sisu järgi
http://localhost:9200/_search?q=content like ‘AGILE’
tulemus:


Leiame kõik dokumenditüübi kaardid:
http://localhost:9200/_search?q=_type:CardDocument

või kõik ülesande tüüpi kaardid:
http://localhost:9200/_search?q=_type:CardTask

Disainilahenduste kasutamine ja ja parameetrid, mille Elasticsearch annab JSON-i kujul, saate koostada järgmise päringu:
http://localhost:9200/_search?q=_type:CardTask and Employee_RoomNumber: Орёл офиc and Employee_FirstName:Konstantin

See näitab kõiki ülesande tüüpi kaarte kasutajate seas, kelle eesnimi = Konstantin ja kes on Eagle Office'is.
Kuid SAMASUGUNE On ka teisi dokumenteeritud parameetreid:
erinevalt väljadest, dokumentidest, sisust jne.
Kõiki neid kirjeldatakse siin.

See on tänaseks kõik!

#docsvision #docsvisionECM

Kasulikud lingid:

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

Allikas: www.habr.com