مقدمة إلى Elasticsearch خطوة بخطوة

أهلا وسهلا!
سنتحدث اليوم عن محرك البحث بالنص الكامل Elasticsearch (المشار إليه فيما يلي باسم ES) ، والذي بواسطته
تعمل منصة Docsvision 5.5.

1. التثبيت

يمكنك تنزيل الإصدار الحالي من الرابط: www.elastic.co/downloads/elasticsearch
لقطة شاشة المثبت أدناه:

2. اختبار الوظيفة

بعد اكتمال التثبيت ، انتقل إلى
http://localhost:9200/
يجب عرض صفحة حالة ES ، المثال أدناه:

إذا لم تفتح الصفحة ، فتأكد من تشغيل خدمة Elasticsearch. على Windows هذا
خدمة البحث المرن.

3. الاتصال بـ Docsvision

تم تكوين الاتصال بـ Elasticsearch في صفحة خدمة النص الكامل.
الفهرسة.


هنا تحتاج إلى تحديد:
1. عنوان خادم Elasticsearch (يتم تعيينه أثناء التثبيت).
2. سلسلة اتصال DBMS.
3. عنوان Docsvision (بتنسيق ConnectAddress =http://SERVER/DocsVision/StorageServer/StorageServerService.
com.asmx)
4. في علامتي التبويب "البطاقات" و "المراجع" ، تحتاج إلى تكوين البيانات التي
يحتاج إلى فهرسته.
تحتاج أيضًا إلى التأكد من أن الحساب الذي تعمل تحته خدمة Docsvision
خدمة فهرسة النص الكامل ، لديها حق الوصول إلى قاعدة بيانات Docsvision على MS SQL.
بعد الاتصال ، تحتاج إلى التأكد من إنشاء المهام ذات البادئة في قاعدة بيانات MS SQL:
"DV: FullText_ <DBNAME> _CardWithFilesPrepareRange"


بعد الانتهاء من الإعدادات في عميل Windows ، سيتم إلغاء قفل شريط البحث.

4. مرونة REST API

يمكن للمسؤول الحصول على معلومات متنوعة حول تشغيل Elasticsearch باستخدام
مقدمة من REST API.
في الأمثلة التالية ، سوف نستخدم برنامج Insomnia Rest Client.

الحصول على معلومات عامة

بمجرد تشغيل الخدمة (http: // localhost: 9200 / في المستعرض) ، يمكنك ذلك
تنفيذ الاستعلام:
http://localhost:9200/_cat/health?v

احصل على رد حول حالة خدمة Elasticsearch (في المتصفح):

استجابة الحالة في الأرق:

دعنا ننتبه إلى الحالة - أخضر ، أصفر ، أحمر. توضح الوثائق الرسمية ما يلي حول الحالات:
• أخضر - كل شيء على ما يرام (الكتلة تعمل بكامل طاقتها)
• أصفر - جميع البيانات متاحة ، لكن بعض النسخ المتماثلة في المجموعة لم يتم تخصيصها لها بعد.
• الأحمر - جزء من البيانات غير متوفر لأي سبب من الأسباب (الكتلة نفسها تعمل بشكل طبيعي)
الحصول على حالات حول العقد في الكتلة وحالتها (لدي عقدة واحدة):
http://localhost:9200/_cat/nodes?v


جميع المؤشرات (المؤشرات) ES:
http://localhost:9200/_cat/indices?v


بالإضافة إلى الفهارس من Docsvision ، قد تكون هناك فهارس لتطبيقات أخرى - نبضات القلب ،
kibana - إذا كنت تستخدمها. يمكنك فرز ما تحتاجه مما لا تحتاجه. على سبيل المثال،
تأخذ فقط الفهارس التي تحتوي على٪ card٪ في أسمائها:
http://localhost:9200/_cat/indices/*card*?v&s=index

تكوين Elasticsearch

الحصول على إعدادات Elasticsearch:
http://localhost:9200/_nodes
ستكون النتيجة واسعة جدًا ، بما في ذلك المسارات المؤدية إلى السجلات:


كيف نكتشف قائمة الفهارس ، نعلم بالفعل أن Docsvision يقوم بذلك تلقائيًا عن طريق إعطاء اسم الفهرس بالتنسيق:
<اسم قاعدة البيانات + نوع البطاقة المفهرسة>
يمكنك أيضًا إنشاء فهرس مستقل خاص بك:
http://localhost:9200/customer?pretty
فقط لن يكون طلب GET ، بل طلب PUT:


النتيجة:


سيُظهر الاستعلام التالي جميع الفهارس ، بما في ذلك الفهارس الجديدة (العميل):
http://localhost:9200/_cat/indices?v

5. الحصول على معلومات حول البيانات المفهرسة

حالة فهارس Elasticsearch

بعد اكتمال التكوين الأولي بواسطة Docsvision ، يجب أن تكون الخدمة جاهزة للعمل وبدء فهرسة البيانات.
بادئ ذي بدء ، دعنا نتحقق من ملء الفهارس وأن حجمها أكبر من "البايت" القياسي مع الاستعلام المألوف لدينا بالفعل:
http://localhost:9200/_cat/indices?v
نتيجة لذلك ، نرى: 87 "مهمة" و 72 "مستندًا" مفهرسة ، تتحدث من حيث نظام إدارة الوثائق الإلكترونية الخاص بنا:


بعد مرور بعض الوقت ، تكون النتائج كما يلي (افتراضيًا ، يتم تشغيل وظيفة الفهرسة كل 5 دقائق):


نرى أن عدد الوثائق قد ازداد.

كيف نفهم أن البطاقة المطلوبة مفهرسة؟

• أولاً ، تحتاج إلى التأكد من أن نوع البطاقة في Docsvision يطابق البيانات المحددة في إعدادات Elasticsearch.
• ثانيًا ، انتظر حتى تتم فهرسة مجموعة البطاقات - عندما تصل إلى Docsvision ، يجب أن يمر بعض الوقت قبل ظهور البيانات في وحدة التخزين.
• ثالثًا ، يمكنك البحث عن بطاقة بواسطة CardID. يمكنك القيام بذلك باستعلام:

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

إذا كانت البطاقة في التخزين ، فسنرى بياناتها "الأولية" ، وإذا لم تكن كذلك ، فسنرى شيئًا مثل هذا الرد:

البحث عن بطاقة في عقدة Elasticsearch

ابحث عن مستند عن طريق المطابقة التامة لحقل الوصف:
http://localhost:9200/_search?q=description: Исходящий tv1
النتيجة:


ابحث عن مستند يحتوي وصفه على إدخال "وارد"
http://localhost:9200/_search?q=description like Входящий
النتيجة:


ابحث عن بطاقة بمحتوى الملف المرفق
http://localhost:9200/_search?q=content like ‘AGILE’
النتيجة:


البحث عن كافة البطاقات من نوع المستند:
http://localhost:9200/_search?q=_type:CardDocument

أو كل بطاقات من نوع المهمة:
http://localhost:9200/_search?q=_type:CardTask

باستخدام التركيبات و والمعلمات التي يقدمها Elasticsearch في شكل JSON ، يمكنك جمع مثل هذا الطلب:
http://localhost:9200/_search?q=_type:CardTask and Employee_RoomNumber: Орёл офиc and Employee_FirstName:Konstantin

سيعرض جميع البطاقات من نوع المهمة ، بين المستخدمين الذين لديهم FirstName = Konstantin ، والموجودين في Oryol Office.
إلا LIKE هناك خيارات أخرى موثقة:
على عكس الحقول والمستندات والمحتوى وما إلى ذلك.
كلهم موصوفون هنا.

هذا كل شيء لهذا اليوم!

#docsvision #docvisionECM

روابط مفيدة:

1. عميل راحة الأرق 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

المصدر: www.habr.com