היכרות עם Elasticsearch צעד אחר צעד

ברוכים הבאים!
היום נדבר על מנוע החיפוש בטקסט מלא Elasticsearch (להלן ES), איתו
פלטפורמת Docsvision 5.5 פועלת.

1. התקנה

אתה יכול להוריד את הגרסה הנוכחית מהקישור: www.elastic.co/downloads/elasticsearch
צילום מסך של המתקין למטה:

2. בדיקת פונקציונליות

לאחר השלמת ההתקנה, עבור אל
http://localhost:9200/
יש להציג את דף סטטוס ES, דוגמה להלן:

אם הדף לא נפתח, ודא ששירות Elasticsearch פועל. בווינדוס זה
שירות Elasticsearch.

3. התחבר ל-Docsvision

חיבור אל Elasticsearch מוגדר בדף השירות בטקסט מלא
אינדקס.


כאן אתה צריך לציין:
1. כתובת שרת Elasticsearch (מוגדרת במהלך ההתקנה).
2. מחרוזת חיבור ל-DBMS.
3. כתובת Docsvision (בפורמט ConnectAddress=http://SERVER/DocsVision/StorageServer/StorageServerService.
asmx)
4. בכרטיסייה "כרטיסים" ו"ספריות", אתה צריך להגדיר את הנתונים
צריך להיות אינדקס.
אתה גם צריך לוודא שהחשבון שתחתיו פועל שירות Docsvision
שירות Fulltext Indexing, בעל גישה למסד הנתונים של 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 "מסמכים" נוספו לאינדקס, במונחים של EDMS שלנו:


לאחר זמן מה, התוצאות הן כדלקמן (כברירת מחדל, עבודות אינדקס מופעלות כל 5 דקות):


אנו רואים שמספר המסמכים גדל.

איך אתה יודע שהכרטיס שאתה צריך עבר אינדקס?

• ראשית, עליך לוודא שסוג הכרטיס ב-Docsvision תואם לנתונים שצוינו בהגדרות Elascticsearch.
• שנית, המתן עד שמערך הכרטיסים יוכנס לאינדקס - כשהוא נכנס ל-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

זה יציג את כל הכרטיסים מסוג המשימה, בין משתמשים שהשם הפרטי שלהם = קונסטנטין, ושנמצאים במשרד אוראל.
מלבד LIKE ישנם פרמטרים מתועדים נוספים:
שלא כמו, שדות, מסמכים, תוכן וכו'.
כולם מתוארים כאן.

זה הכל להיום!

#docsvision #docsvisionECM

קישורים שימושיים:

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