🥇Einführung in Elasticsearch Schritt für Schritt

Hallo!
Heute werden wir über die Full-Text-Suchmaschine Elasticsearch (im Folgenden ES) sprechen, mit der
die Plattform Docsvision 5.5 arbeitet.

1. Installation

Die aktuelle Version kann über den folgenden Link heruntergeladen werden: www.elastic.co/downloads/elasticsearch
Der Screenshot des Installationsprogramms ist unten:

2. Funktionsprüfung

Nach Abschluss der Installation gehen Sie zu der Adresse
http://localhost:9200/
Es sollte eine Seite mit dem Status von ES angezeigt werden, Beispiel unten:

Wenn die Seite nicht geöffnet wird, stellen Sie sicher, dass der Elasticsearch-Dienst läuft. Auf Windows ist dies
der Elasticsearch-Dienst.

3. Verbindung zu Docsvision

Die Verbindung zu Elasticsearch wird auf der Seite des Full-Text-Services
für die Indizierung konfiguriert.

Hier müssen Sie angeben:
1. Adresse des Elasticsearch-Servers (wird bei der Installation festgelegt).
2. Verbindungszeichenfolge zur DBMS.
3. Adresse Docsvision (im Format ConnectAddress=http://SERVER/DocsVision/StorageServer/StorageServerService.
asmx)
4. Auf den Registerkarten „Karten“ und „Verzeichnisse“ müssen die Daten konfiguriert werden, die
indiziert werden sollen.
Es muss auch sichergestellt werden, dass das Benutzerkonto, unter dem der Dienst Docsvision
Fulltext Indexing service läuft, Zugriff auf die Docsvision-Datenbank auf MS SQL hat.
Nach der Verbindung sollte sichergestellt werden, dass in der MS SQL-Datenbank Aufgaben mit dem Präfix erstellt wurden:
„DV:FullText__CardWithFilesPrepareRange“

Nach den Einstellungen wird das Suchfeld im Windows-Client freigeschaltet.

4. REST API Elastic

Der Administrator kann verschiedene Informationen über die Funktionsweise von Elasticsearch über die
bereitgestellte REST API abrufen.
In den folgenden Beispielen verwenden wir den Insomnia Rest Client.

Abrufen von allgemeinen Informationen

Sobald der Dienst gestartet ist und funktioniert (http://localhost:9200/ im Browser), können Sie
die Abfrage ausführen:
http://localhost:9200/_cat/health?v

Wir erhalten eine Antwort über den Status des Elasticsearch-Dienstes (im Browser):

Antwort über den Status in Insomnia:

Beachten Sie den Status — Grün, Gelb, Rot. Die offizielle Dokumentation sagt zu den Statusfolgendes:
• Grün — Alles in Ordnung (Cluster voll funktionsfähig)
• Gelb — Alle Daten sind verfügbar, aber einige Replikate im Cluster sind derzeit noch nicht zugewiesen
• Rot — Ein Teil der Daten ist aus irgendeinem Grund nicht verfügbar (der Cluster funktioniert jedoch normal)
Abrufen der Zustände der Knoten im Cluster und deren Zustand (ich habe 1 Knoten):
http://localhost:9200/_cat/nodes?v

Alle ES-Indizes:
http://localhost:9200/_cat/indices?v

Neben den Indizes von Docsvision können auch Indizes anderer Anwendungen vorhanden sein — heartbeat,
kibana — wenn Sie diese verwenden. Nützliche von unnötigen können gefiltert werden. Zum Beispiel
Lass uns nur die Indizes nehmen, deren Namen rd% enthalten:
http://localhost:9200/_cat/indices/*card*?v&s=index

Konfiguration von Elasticsearch

Abrufen von Einstellungen für Elasticsearch:
http://localhost:9200/_nodes
Das Ergebnis wird ziemlich umfangreich sein, einschließlich der Pfade zu den Protokollen:

Wie wir die Liste der Indizes herausfinden, wissen wir bereits, Docsvision macht dies automatisch, indem es den Indexnamen im Format vergibt:
<imnamebd+typeIndexedCard>
Es ist auch möglich, einen eigenen unabhängigen Index zu erstellen:
http://localhost:9200/customer?pretty
Nur wird dies kein GET-, sondern ein PUT-Anfrage sein:

Ergebnis:

Die folgende Anfrage zeigt alle Indizes an, einschließlich der neuen (Kunde):
http://localhost:9200/_cat/indices?v

5. Abruf von Informationen über indizierte Daten

Zustand der Elasticsearch-Indizes

Nachdem die ursprüngliche Konfiguration von Docsvision durchgeführt wurde, sollte der Dienst bereit zur Arbeit und zum Start der Indizierung von Daten sein.
Zuerst prüfen wir, ob die Indizes gefüllt sind und ihre Größe größer ist als die Standard-„Bytes“ mit der für uns bereits bekannten Anfrage:
http://localhost:9200/_cat/indices?v
Als Ergebnis sehen wir: 87 „Aufträge“ und 72 „Dokumente“ wurden indiziert, wenn wir in Begriffen unseres EDS sprechen:

Nach einiger Zeit sind die Ergebnisse so (standardmäßig wird der Indizierungsjob alle 5 Minuten gestartet):

Dabei sehen wir, dass die Anzahl der Dokumente zugenommen hat.

Wie erkennt man, dass die benötigte Karte indiziert wurde?

• Erstens muss sichergestellt werden, dass der Kartentyp in Docsvision mit den in den Elasticsearch-Einstellungen angegebenen Daten übereinstimmt.
• Zweitens muss man auf die Indizierung des Kartenarrays warten - es kann einige Zeit dauern, bis die Daten in Docsvision im Speicher erscheinen.
• Drittens kann man die Karte nach CardID suchen. Dies kann mit der folgenden Anfrage geschehen:

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

Falls die Karte im Speicher vorhanden ist, sehen wir ihre „rohen“ Daten, andernfalls erhalten wir eine Antwort wie die folgende:

Suche nach Karte im Elasticsearch-Knoten

Dokument nach exakter Übereinstimmung des Feldes Beschreibung finden:
http://localhost:9200/_search?q=description: Ausgehende tv1
Ergebnis:

Dokument suchen, dessen Beschreibung das Wort ‚Eingehend‘ enthält
http://localhost:9200/_search?q=description like Eingehend
Ergebnis:

Suche nach Karte anhand des Inhalts der angehängten Datei
http://localhost:9200/_search?q=content like ‚AGILE‘
Ergebnis:

Lass uns alle Karten vom Typ Dokument finden:
http://localhost:9200/_search?q=_type:CardDocument

oder alle Karten vom Typ Aufgabe:
http://localhost:9200/_search?q=_type:CardTask

Durch die Verwendung von Konstruktionen and und den Parametern, die Elasticsearch in Form von JSON ausgibt, kann man eine solche Anfrage zusammenstellen:
http://localhost:9200/_search?q=_type:CardTask and Employee_RoomNumber: Orël büro and Employee_FirstName:Konstantin

Es zeigt alle Karten vom Typ Aufgabe unter den Benutzern an, deren Vorname = Konstantin ist und die sich im Büro Orël befinden.
Außerdem LIKE gibt es auch andere dokumentierte Parameter:
unlike, fields, docs, content usw.
Alle sind beschrieben hier.

Für heute ist alles!

#docsvision #docsvisionECM

Nützliche Links:

Quelle: habr.com