🥇Tutvumine Elasticsearchiga samm-sammult

Tere tulemast!
Täna räägime otsingumootorist Elasticsearch (edaspidi ES), millega
töötleb Docsvision 5.5 platvorm.

1. Installimine

Praeguse versiooni allalaadimiseks külasta linki: www.elastic.co/downloads/elasticsearch
Allpool on installeerija ekraanipilt:

2. Töökindluse kontrollimine

Pärast installimist minge aadressile
http://localhost:9200/
Peaks avanema ES-i oleku leht, näide allpool:

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

3. Ühendamine Docsvisioniga

Ühendamine Elasticsearchiga seadistatakse täisteksti indekseerimise teenuse lehel.
Siin tuleb määrata:

1. Elasticsearch serveri aadress (seatakse installimise ajal).
2. Andmebaasi ühenduse string.
3. Docsvisioni aadress (formaadis ConnectAddress=
asmxhttp://SERVER/DocsVision/StorageServer/StorageServerService.
4. Vahekaardil "Kardid" ja "Aruanded" tuleb seadistada indekseerimiseks vajalik teave.)
Samuti tuleb veenduda, et Docsvision Fulltext Indexing teenuse jooksva konto juurdepääs MS SQL andmebaasile on lubatud.
Pärast ühendust tuleb veenduda, et MS SQL andmebaasis on loodud ülesanded prefiksiga:
"DV:FullText__CardWithFilesPrepareRange"
Täisteksti indekseerimise teenus, millel on juurdepääs Docsvisioni andmebaasile MS SQL-is.
Pärast ühendamist peate veenduma, et MS SQL andmebaasis on loodud ülesanded prefiksiga:
„DV:FullText__CardWithFilesPrepareRange”

Windowsi kliendis seadistuste lõpetamisel vabastatakse otsinguriba.

4. REST API Elastic

Administraator saab erinevat teavet Elasticsearchi töö kohta
pakutava REST API abil.
Järgmistes näidetes kasutame Insomnia Rest Client'i.

Üldise teabe saamine

Niipea kui teenus on käivitatud ja töötab (http://localhost:9200/ brauseris), saab
teha päringu:
http://localhost:9200/_cat/health?v

Saame vastuse Elasticsearchi teenuse seisundi kohta (brauseris):

Seisundi vastus Insomnias:

Pöörame tähelepanu State'ile — Green, Yellow, Red. Ametlik dokumentatsioon ütleb staatuste kohta järgmist:
• Green — Kõik on hästi (Klaster töötab täielikult)
• Yellow — Kõik andmed on saadaval, kuid mõned koopiad klastris pole hetkel määratud
• Red — Osa andmeid on mis tahes põhjusel kättesaamatud (klaster toimib normaalselt)
Klastri sõlmede staatuste saamine ja nende seisund (mul on 1 sõlm):
http://localhost:9200/_cat/nodes?v

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

Lisaks Docsvision'i indeksitele võivad olla ka teiste rakenduste indeksid — heartbeat,
kibana — kui kasutate neid. Vajalikud saab soovimatutest eristada. Näiteks
возьмём только индексы, в имени которых есть %card% в названии:
http://localhost:9200/_cat/indices/*card*?v&s=index

Elasticsearchi konfiguratsioon

Elasticsearchi seade saamine:
http://localhost:9200/_nodes
Tulemus on üsna ulatuslik, sealhulgas logide teed:

Kuidas saada indeksite nimekirja, me juba teame, et Docsvision teeb seda automaatselt, andes indeksile nime formaadis:
<имябд+видИндексируемойКарточки>
Samuti on võimalik luua oma sõltumatu indeks:
http://localhost:9200/customer?pretty
Aga see ei ole GET, vaid PUT päring:

Tulemus:

järgnev päring näitab kõiki indeksit, sealhulgas uusi (customer):
http://localhost:9200/_cat/indices?v

5. Indekseeritud andmete teabe saamine

Elasticsearchi indeksite staatus

Pärast seda, kui Docsvisioni algseade on tehtud, peab teenus olema tööks valmis ja andmete indekseerimise alustamiseks.
Esiteks kontrollime, et indeksid täienevad ja nende suurus on suurem kui standardne "bait", meie tuttava päringuga:
http://localhost:9200/_cat/indices?v
tulemusena näeme: indekseeritud on 87 "ülesannet" ja 72 "dokument" kui rääkida meie SED-i mõistetest:

Mõne aja pärast on tulemused sellised (vaikimisi käivitub indekseerimise ülesanne iga 5 minuti järel):

Näeme, et dokumentide arv on suurenenud.

Kuidas aru saada, et vajalik kaardike on indekseeritud?

• Esiteks tuleb veenduda, et Docsvisioni kaardi tüüp vastab Elasticsearchi seadetes näidatud andmetele.
• Teiseks tuleb oodata kaardimassi indekseerimist — Docsvisionisse sisestamisel peab andmete ilmumiseks salvestusse mööduma teatud aeg.
• Kolmandaks saab kaarti otsida CardID järgi. Seda saab teha päringuga:

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

Kui kaart on salvestuses olemas, näeme selle „tooreid” andmeid; kui ei, saame umbkaudu sellise vastuse:

Kaardi otsimine Elasticsearchi sõlmes

Leidke dokument täpse Description välja vastavuse järgi:
http://localhost:9200/_search?q=description: Väljuv tv1
Tulemus:

dokumentide otsimine, mille Descriptionis on 'Sisenemine'
http://localhost:9200/_search?q=description like Sisenemine
Tulemus:

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

Otsime kõiki dokumentide tüüpi kaarte:
http://localhost:9200/_search?q=_type:CardDocument

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

Kasutades konstruktsioone ja ja parameetreid, mida Elasticsearch tagastab JSON vormingus, saab koostada järgmise päringu:
http://localhost:9200/_search?q=_type:CardTask and Employee_RoomNumber: Orjol büroo and Employee_FirstName: Konstantin

See näitab kõiki ülesande tüüpi kaarte, kasutajate seas, kelle eesnimi on Konstantin ja kes asuvad Orjol büroos.
Lisaks LIKE on ka teisi dokumenteeritud parameetreid:
erinevalt, valdkonnad, dokumendid, sisu jne.
Kõik need on kirjeldatud siin.

Sellega on kõik!

#docsvision #docsvisionECM

Kasulikud lingid: