Cześć!
Dzisiaj porozmawiamy o wyszukiwarce pełnotekstowej Elasticsearch (zwanej dalej ES), z którą
Platforma Docsvision 5.5 jest uruchomiona.
1. Instalacja
Aktualną wersję można pobrać pod linkiem:
Poniżej zrzut ekranu instalatora:
2. Test działania
Po zakończeniu instalacji przejdź do
Powinna zostać wyświetlona strona stanu ES, przykład poniżej:
Jeśli strona nie otwiera się, upewnij się, że usługa Elasticsearch jest uruchomiona. W systemie Windows tak jest
Usługa Elasticsearch.
3. Połącz się z Docsvision
Połączenie z Elasticsearch konfiguruje się na stronie usługi pełnotekstowej
indeksowanie.
Tutaj musisz wskazać:
1. Adres serwera Elasticsearch (ustawiany podczas instalacji).
2. Parametry połączenia z DBMS.
3. Adres Docsvision (w formacie ConnectAddress=)
4. W zakładce „Karty” i „Katalogi” należy skonfigurować dane, które
trzeba indeksować.
Musisz także upewnić się, że konto, na którym działa usługa Docsvision
Usługa Fulltext Indexing, posiada dostęp do bazy Docsvision na MS SQL.
Po podłączeniu należy upewnić się, że w bazie MS SQL zostały utworzone zadania z prefiksem:
„DV:FullText_<DBNAME>_CardWithFilesPrepareRange”
Po zakończeniu ustawień pasek wyszukiwania zostanie odblokowany w kliencie Windows.
4. REST API Elastyczne
Administrator może uzyskać różne informacje na temat działania Elasticsearch za pomocą
udostępniane przez REST API.
W poniższych przykładach użyjemy klienta Insomnia Rest.
Uzyskiwanie informacji ogólnych
Gdy usługa zostanie uruchomiona (http://localhost:9200/ w przeglądarce), możesz to zrobić
uruchom żądanie:
Uzyskajmy odpowiedź o stanie usługi Elasticsearch (w przeglądarce):
Reakcja na stan bezsenności:
Zwróćmy uwagę na Status - Zielony, Żółty, Czerwony. Oficjalna dokumentacja mówi co następuje o statusach:
• Zielony — wszystko w porządku (klaster jest w pełni sprawny)
• Żółty — wszystkie dane są dostępne, ale niektóre repliki w klastrze nie zostały jeszcze dla nich przydzielone
• Czerwony — część danych jest z jakiegoś powodu niedostępna (sam klaster działa normalnie)
Uzyskiwanie stanów dotyczących węzłów w klastrze i ich stanu (mam 1 węzeł):
Wszystkie indeksy ES:
Oprócz indeksów z Docsvision mogą znajdować się także indeksy innych aplikacji - heartbeat,
kibana – jeśli ich używasz. Możesz oddzielić potrzebne od niepotrzebnych. Na przykład,
Weźmy tylko indeksy, które mają w nazwie %card%:
Konfiguracja Elasticsearch
Uzyskiwanie ustawień Elasticsearch:
Wynik będzie dość obszerny, łącznie ze ścieżkami do logów:
Wiemy już, jak znaleźć listę indeksów; Docsvision robi to automatycznie, nadając indeksowi nazwę w formacie:
<nazwa bazy danych+typ karty indeksowanej>
Możesz także stworzyć swój własny, niezależny indeks:
Tylko że to nie będzie żądanie GET, ale PUT:
Wynik:
poniższe zapytanie wyświetli wszystkie indeksy, łącznie z nowymi (klient):
5. Pozyskiwanie informacji o danych zaindeksowanych
Stan indeksu Elasticsearch
Po zakończeniu wstępnej konfiguracji przez Docsvision usługa powinna być gotowa do działania i rozpocząć indeksowanie danych.
Na początek sprawdźmy, czy indeksy są zapełnione i czy ich rozmiar jest większy od standardowych „bajtów”, korzystając ze znanego nam już zapytania:
W rezultacie widzimy: zindeksowanych zostało 87 „zadań” i 72 „dokumentów”, mówiąc w kategoriach naszego EDMS:
Po pewnym czasie wyniki przedstawiają się następująco (domyślnie zadania indeksowania uruchamiane są co 5 minut):
Widzimy, że liczba dokumentów wzrosła.
Skąd wiesz, że potrzebna Ci karta została zaindeksowana?
• Najpierw musisz upewnić się, że typ karty w Docsvision odpowiada danym określonym w ustawieniach Elascticsearch.
• Po drugie, poczekaj, aż tablica kart zostanie zindeksowana - gdy trafi ona do Docsvision, musi minąć trochę czasu, zanim dane pojawią się w magazynie.
• Po trzecie, możesz wyszukać kartę po CardID. Możesz to zrobić za pomocą następującego żądania:
Jeśli karta znajduje się w pamięci, zobaczymy jej „surowe” dane, jeśli nie, zobaczymy coś takiego:
Wyszukiwanie karty w węźle Elasticsearch
Znajdź dokument według dokładnego dopasowania pola Opis:
Wynik:
wyszukaj dokument, który w swoim opisie ma wpis „Przychodzący”.
Wynik:
Wyszukaj kartę po zawartości załączonego pliku
wynik:
Znajdźmy wszystkie karty typu dokument:
lub wszystkie karty typu zadanie:
Korzystanie z projektów i i parametry, które Elasticsearch podaje w postaci JSON, możesz złożyć następujące żądanie:
Wyświetli wszystkie karty typu zadanie, wśród użytkowników, których Imię = Konstantin i którzy znajdują się w Biurze Orła.
Ale LIKE Istnieją inne udokumentowane parametry:
w przeciwieństwie do pól, dokumentów, treści itp.
Wszystkie są opisane .
To wszystko na dzisiaj!
#dokumentacja #dokumentacjaECM
Przydatne linki:
- Klient odpoczynku bezsenności
Źródło: www.habr.com