🥇Zoznámenie sa s Elasticsearch krok za krokom

Dobrý deň!
Dnes si povieme niečo o fulltextovom vyhľadávači Elasticsearch (ďalej ES), s ktorým
Platforma Docsvision 5.5 je spustená.

1. Inštalácia

Aktuálnu verziu si môžete stiahnuť z odkazu: www.elastic.co/downloads/elasticsearch
Snímka obrazovky inštalátora nižšie:

2. Kontrola funkčnosti

Po dokončení inštalácie prejdite na
http://localhost:9200/
Mala by sa zobraziť stránka stavu ES, príklad nižšie:

Ak sa stránka neotvorí, skontrolujte, či je spustená služba Elasticsearch. V systéme Windows je to tak
Služba elastického vyhľadávania.

3. Pripojte sa k Docsvision

Pripojenie k Elasticsearch sa konfiguruje na stránke fulltextovej služby
indexovanie.

Tu je potrebné špecifikovať:
1. Adresa servera Elasticsearch (nastavená počas inštalácie).
2. Reťazec pripojenia k DBMS.
3. Adresa Docsvision (vo formáte ConnectAddress=http://SERVER/DocsVision/StorageServer/StorageServerService.
asmx)
4. Na karte „Karty“ a „Adresáre“ musíte nakonfigurovať údaje, ktoré
je potrebné indexovať.
Musíte sa tiež uistiť, že účet, pod ktorým je spustená služba Docsvision
Služba Fulltext Indexing, má prístup k databáze Docsvision na MS SQL.
Po pripojení sa musíte uistiť, že úlohy s prefixom sú vytvorené v databáze MS SQL:
"DV:FullText_<DBNAME>_CardWithFilesPrepareRange"

Po dokončení nastavení sa v klientovi Windows odomkne vyhľadávací panel.

4. REST API Elastické

Správca môže získať rôzne informácie o prevádzke Elasticsearch pomocou
poskytuje REST API.
V nasledujúcich príkladoch použijeme Insomnia Rest Client.

Získanie všeobecných informácií

Po spustení služby (http://localhost:9200/ v prehliadači) môžete
spustiť požiadavku:
http://localhost:9200/_cat/health?v

Poďme získať odpoveď o stave služby Elasticsearch (v prehliadači):

Reakcia na stav nespavosti:

Venujme pozornosť Stavu - Zelená, Žltá, Červená. Oficiálna dokumentácia hovorí o stavoch:
• Zelená – všetko je v poriadku (klaster je plne funkčný)
• Žltá – všetky údaje sú dostupné, ale niektoré repliky v klastri pre ne ešte nie sú pridelené
• Červená – časť údajov je z akéhokoľvek dôvodu nedostupná (samotný klaster funguje normálne)
Získanie stavov o uzloch v klastri a ich stave (mám 1 uzol):
http://localhost:9200/_cat/nodes?v

Všetky ES indexy:
http://localhost:9200/_cat/indices?v

Okrem indexov z Docsvision môžu existovať aj indexy iných aplikácií - srdcový tep,
kibana - ak ich používate. Môžete triediť potrebné od nepotrebných. Napríklad,
Zoberme si len indexy, ktoré majú v názve %card%:
http://localhost:9200/_cat/indices/*card*?v&s=index

Konfigurácia elastického vyhľadávania

Získanie nastavení Elasticsearch:
http://localhost:9200/_nodes
Výsledok bude pomerne rozsiahly, vrátane ciest k protokolom:

Už vieme, ako zistiť zoznam indexov; Docsvision to robí automaticky a dáva indexu názov vo formáte:
<názov databázy+typ indexovanej karty>
Môžete si tiež vytvoriť svoj vlastný nezávislý index:
http://localhost:9200/customer?pretty
Len to nebude požiadavka GET, ale PUT:

Výsledok:

nasledujúci dotaz zobrazí všetky indexy vrátane nových (zákazník):
http://localhost:9200/_cat/indices?v

5. Získavanie informácií o indexovaných údajoch

Stav indexu elastického vyhľadávania

Po dokončení počiatočnej konfigurácie spoločnosťou Docsvision by služba mala byť pripravená na prevádzku a začať indexovať údaje.
Najprv skontrolujte, či sú indexy vyplnené a ich veľkosť je väčšia ako štandardné „bajty“ pomocou nám už známeho dopytu:
http://localhost:9200/_cat/indices?v
V dôsledku toho vidíme: 87 „úloh“ a 72 „dokumentov“ bolo indexovaných, v zmysle nášho EDMS:

Po určitom čase sú výsledky nasledovné (v predvolenom nastavení sa úlohy indexovania spúšťajú každých 5 minút):

Vidíme, že počet dokumentov sa zvýšil.

Ako viete, že karta, ktorú potrebujete, bola indexovaná?

• Najprv sa musíte uistiť, že typ karty v Docsvision sa zhoduje s údajmi zadanými v nastaveniach Elascticsearch.
• Po druhé, počkajte, kým sa pole kariet indexuje – keď sa dostane do Docsvision, musí uplynúť nejaký čas, kým sa údaje objavia v úložisku.
• Po tretie, môžete vyhľadať kartu podľa CardID. Môžete to urobiť pomocou nasledujúcej žiadosti:

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

Ak je karta v úložisku, uvidíme jej „surové“ dáta; ak nie, uvidíme niečo takéto:

Hľadanie karty v uzle Elasticsearch

Nájdite dokument podľa presnej zhody poľa Popis:
http://localhost:9200/_search?q=description: Исходящий tv1
Výsledok:

vyhľadajte dokument, ktorý má v popise položku „Prichádzajúce“.
http://localhost:9200/_search?q=description like Входящий
Výsledok:

Vyhľadajte kartu podľa obsahu priloženého súboru
http://localhost:9200/_search?q=content like ‘AGILE’
výsledok:

Nájdite všetky karty typu dokumentu:
http://localhost:9200/_search?q=_type:CardDocument

alebo všetky karty typu úlohy:
http://localhost:9200/_search?q=_type:CardTask

Používanie vzorov a a parametre, ktoré Elasticsearch poskytuje vo forme JSON, môžete zostaviť nasledujúcu požiadavku:
http://localhost:9200/_search?q=_type:CardTask and Employee_RoomNumber: Орёл офиc and Employee_FirstName:Konstantin

Zobrazí všetky karty typu úlohy medzi používateľmi, ktorých meno = Konstantin a ktorí sú v kancelárii Orla.
Mimo LIKE Existujú ďalšie zdokumentované parametre:
na rozdiel od polí, dokumentov, obsahu atď.
Všetky sú popísané tu.

To je na dnes všetko!

#docsvision #docsvisionECM

Užitočné odkazy: