GroupDocs.Search for .NET 26.11 זמין כעת. גרסה זו עושה חיפושים חוזרים ובמקביל למהירים הרבה יותר, מצמצמת את זיכרון שהוקצה על ידי אינדקסינג עד 4.5 פעמים ומאבטחת את רשת החיפוש עם אימות צמתים. אינדקסינג ברשת חיפוש הוא 5 עד 20 פעמים מהיר יותר, וחבילת NuGet של GroupDocs.Search כוללת כעת בניות עבור .NET Framework 4.8, .NET 6.0, .NET 8.0 ו‑.NET 10.0.

מאגרי אינדקס שנוצרו בגרסה 26.10 נפתחים ללא המרה. הגרסה מכילה 18 שינויים: 5 תכונות חדשות, 12 שיפורים ו‑1 תיקון.

נקודות מרכזיות בביצועים

ההערות המלאות של הגרסה מתארות את תצורת הבדיקה של כל תרשים.

מה שיפור ב‑26.11
חיפוש רגולרי חוזר עד 300 פעמים מהיר יותר
חיפוש מעורפל חוזר 4 עד 30 פעמים מהיר יותר
חיפושים במקביל של אינדקס זמן ממוצע של 8 חיפושים במקביל מ‑5.6 ms ל‑0.18 ms; 4 עד 18% יותר חיפושים לשנייה
חיפוש מעורפל עם טעות אחת 1.8 פעמים מהיר יותר, 4.5 פעמים מהיר יותר עם 8 חוטי חיפוש
חיפוש בטווח תאריכים עד 10 פעמים מהיר יותר, עד 59 פעמים מהיר יותר בחלקים; טווחים ארוכים מחזירים תוצאות שלמות
זיכרון שהוקצה על ידי אינדקסינג עד 4.5 פעמים פחות
אינדקסינג עם טקסט מסמך שמור עד 2.2 פעמים מהיר יותר
קבלת טקסט מסמך שמור 3.5 פעמים מהיר יותר, 11 פעמים פחות זיכרון
מיזוג אינדקסים 3.5 פעמים מהיר יותר, כמעט 50 פעמים פחות זיכרון
אינדקסינג ברשת חיפוש 5 עד 20 פעמים מהיר יותר, הרבה פחות מקטעי אינדקס בחלקים
רישום 20,000 מסמכים בצומת הראשי מ‑27.1 שניות ל‑0.12 שניות, 0.8 MB נכתבו לדיסק במקום 7.6 GB
שטח דיסק של אינדקס ניתן לצמצם על חשבון מהירות הטעינה

מה חדש בגרסה זו

מפתח סיכום קטגוריה
SEARCHNET-3729 הוספת אפשרות לצמצם את שטח הדיסק שתופס אינדקס על חשבון מהירות הטעינה תכונה
SEARCHNET-3730 הוספת אימות לצמתים ברשת חיפוש תכונה
SEARCHNET-3731 הוספת תמיכה ב‑OCR לחילוץ מסמכים בתהליך נפרד תכונה
SEARCHNET-3732 הוספת חיפוש בחלקים במאגר אינדקסים תכונה
SEARCHNET-3733 הוספת הדגשת מילים שמוצרות על ידי מפצל מילים מותאם תכונה
SEARCHNET-3734 אופטימיזציית חיפוש בחלקים שיפור
SEARCHNET-3735 הוספת בריכת חוטים משותפת לחיפושים מקבילים של אינדקס שיפור
SEARCHNET-3736 הוספת שימוש חוזר במילים תואמות בחיפושים חוזרים שיפור
SEARCHNET-3737 הוספת הממשק IDisposable למחלקת Cancellation שיפור
SEARCHNET-3738 הרחבת האלפבית ברירת המחדל עם תסריטים נוספים שיפור
SEARCHNET-3739 האצת חיפוש בטווח תאריכים והבטחת תוצאות שלמות לטווחים ארוכים שיפור
SEARCHNET-3740 צמצום צריכת הזיכרון של אינדקסינג ושל פעולות עם טקסטים של מסמכים שמורים שיפור
SEARCHNET-3741 האצת אינדקסינג ברשת חיפוש עם מספר גדול של מסמכים שיפור
SEARCHNET-3742 הוספת אינדקסינג באצוות ועיבוד מקביל של בקשות חלקים ברשת חיפוש שיפור
SEARCHNET-3743 הוספת תבנית השחרור במחלקות Index, IndexRepository, Cancellation, ExtractionHost ו‑SearchNetworkNode שיפור
SEARCHNET-3693 הוספת אסטרטגיית אריזת TFM‑Split לחבילת NuGet של GroupDocs.Search שיפור
SEARCHNET-3747 הוספת חבילות NuGet עבור .NET Framework 4.8, .NET 6.0, .NET 8.0, .NET 10.0 שיפור
SEARCHNET-3746 תיקון המתנות אינסופיות של רשת חיפוש לצמתים אבודים או בלתי מגיבים תיקון

תכונות מרכזיות

חיפוש

  • חיפושים חוזרים עם תו כללי, ביטוי רגולרי, טווח מספרי וחיפוש מעורפל משתמשים מחדש במילים שנמצאו בחיפושים קודמים עם אותה שאילתה עד שהאינדקס משתנה. המילים הנשמרות תופסות עד 8 MB של זיכרון לכל אינדקס.
  • חיפושים במקביל של אינדקס חולקים את חוטי החיפוש שלו (IndexSettings.SearchThreads), ולכן חיפושים קצרים אינם מחכים יותר לחיפושים ארוכים.
  • חיפוש בטווח תאריכים קורא כל יום, חודש ושנה מהאינדקס פעם אחת במקום לחפש כל תאריך בטווח בנפרד. טווחים ארוכים אינם נחתכים יותר במגבלת ההתרחשויות, וטווח של כל התאריכים האפשריים, שכשל לפני, מחופש כעת בשניות.
  • חיפוש בחלקים מקבל את כל השיפורים הללו, וכעת ניתן לחפש במאגר אינדקסים בחלקים גם כן: IndexRepository.SearchNext ממשיך את החיפוש אינדקס אחרי אינדקס.
  • הדגשה ו‑Index.GetDocumentText יכולים לחלק את הטקסט עם מפצל המילים המותאם המשמש לאינדקסינג, כך שהמילים שהמפצל מייצר, לדוגמה מילים בטקסט ללא רווחים, מודגשות גם הן.
  • האלפבית ברירת המחדל של אינדקסים חדשים כולל עברית, דוואנגרי, גאורגית, לטינית מורחבת, יוונית ואותיות האנגול והסימנים המשולבים. מילים כגון “Việt” אינן מפוצלות יותר לחלקים, ומילים בקוריאנית ובעברית מאונדקסות ונמצאות במלואן.

אינדקסינג ואחסון אינדקס

  • ההגדרה החדשה IndexSettings.UseFastLoading מאפשרת לאינדקס על הדיסק לוותר על הנתונים הנוספים שמאיצים את טעינתו כמה פעמים: האינדקס תופס פחות מקום בדיסק אך נטען זמן ארוך יותר. ניתן לשנות את ההגדרה בכל זמן, גם עבור אינדקס שכבר מכיל מסמכים.
  • אינדקסינג מקצה עד 4.5 פעמים פחות זיכרון לכל מסמך ועם טקסט מסמך שמור פועל עד 2.2 פעמים מהיר יותר. קבלת הטקסט השמור היא 3.5 פעמים מהירה יותר עם 11 פעמים פחות זיכרון, ומיזוג אינדקסים הוא 3.5 פעמים מהיר יותר עם כמעט 50 פעמים פחות זיכרון.
  • הטקסט של תמונות במסמכים שחולצו בתהליך נפרד ניתן כעת לזיהוי: ExtractionHost.OcrConnector מגדיר את מחבר ה‑OCR של תהליך החילוץ. אם הזיהוי מופעל אך לתהליך החילוץ אין מחבר OCR, האינדקס מדווח על כך דרך אירוע ErrorOccurred.

רשת חיפוש

  • הצמתים מאמתים זה את זה עם מפתח סודי משותף (TcpSettings.NetworkKey), וכל הודעה נחתמת: מחשב ללא המפתח אינו יכול לתת פקודות לצומת ולא לענות עבורו. המפתח לעולם אינו נשלח ברשת. צומת משני יכול גם להגביל את הכתובות שממנה הוא מקבל את הצומת הראשי (TcpSettings.AllowedMasterAddresses).
  • אינדקסינג הוא 5 עד 20 פעמים מהיר יותר ויוצר הרבה פחות מקטעי אינדקס: מסמכים שמגיעים בזמן שחלק עסוק מאונדקסים באצוות של עד 1,000 מסמכים או 16 MB, והחלקים של צומת מעבדים את הבקשות שלהם במקביל.
  • רישום מסמכים מאונדקסים בצומת הראשי אינו מאט יותר ככל שמספרם גדל, ורשימת המסמכים של חלק נשמרת בבטחה כאשר כתיבה נכשלה או שהתהליך קרס.
  • צומת הראשי מזהה צמתים אבודים ובלתי מגיבים: צומת משני מדווח כל 5 שניות, והקריאות אינן מחכות לנצח לצומת שנעלם. TcpSettings.ResponseTimeout יכול גם להגביל כמה זמן צומת הראשי מחכה לתגובה.

API ואריזה

  • Index, IndexRepository, Cancellation, ExtractionHost ו‑SearchNetworkNode מיישמים את תבנית השחרור הסטנדרטית של .NET, כך שמחלקות שיורשות יכולות לשחרר משאבים משלהן. שחרור של Cancellation משחרר את הטיימר של ביטול מתוזמן על ידי CancelAfter.
  • חבילת NuGet של GroupDocs.Search כוללת כעת בניות עבור .NET Framework 4.8, .NET 6.0, .NET 8.0 ו‑.NET 10.0 בנוסף ל‑.NET Framework 4.6.2 ו‑.NET Standard 2.1, והיא בוחרת את הבנייה עבור מסגרת היעד של הפרויקט באופן אוטומטי.

שינויים ב‑API ציבורי

החברים הבאים נוספו:

  • GroupDocs.Search.IndexSettings:

    • Boolean UseFastLoading – משמר את הנתונים הנוספים שמאיצים את טעינת אינדקס על הדיסק כמה פעמים. מופעל כברירת מחדל; הגדר ל‑false כדי לחסוך במקום בדיסק.
  • GroupDocs.Search.Scaling.Configuring.TcpSettings:

    • String NetworkKey – מפתח הסודי של רשת החיפוש, באורך של לפחות 16 תווים והזהה בכל הצמתים.
    • String[] AllowedMasterAddresses – כתובות IPv4 או שמות מארחים שממנה צומת משני מקבל את חיבור הצומת הראשי.
    • Int32 ResponseTimeout – הזמן במילישניות שהצומת הראשי מחכה לתגובה של צומת לבקשה. ללא מגבלה כברירת מחדל.
  • GroupDocs.Search.ExtractionHost:

    • IOcrConnector OcrConnector – מחבר ה‑OCR של תהליך החילוץ הנפרד.
  • GroupDocs.Search.IndexRepository:

    • SearchResult SearchNext(ChunkSearchToken) ו‑SearchResult SearchNext(ChunkSearchToken, Cancellation) – ממשיכים חיפוש בחלקים במאגר אינדקסים.
  • GroupDocs.Search.Options.TextOptions:

    • IWordSplitter WordSplitter – מפצל המילים שבו משתמשים בהדגשה ו‑Index.GetDocumentText; יורש על‑ידי HighlightOptions.
  • GroupDocs.Search.Common.Cancellation כעת מיישם IDisposable:

    • void Dispose() – משחרר את הטיימר של ביטול מתוזמן; הביטול המתוזמן אינו מתבקש.
  • Index, IndexRepository, Cancellation, ExtractionHost ו‑SearchNetworkNode:

    • protected virtual void Dispose(Boolean disposing) – שיטת תבנית השחרור למחלקות שיורשות.

שינויים בהתנהגות שעשויים לדרוש שינוי בקוד שלכם מפורטים בהערות השדרוג למטה.

דוגמאות קוד

חיפוש במאגר אינדקסים בחלקים

הדוגמה הבאה מחפשת שני אינדקסים במאגר בחלקים, אינדקס אחרי אינדקס.

string indexFolder1 = @"c:\MyIndex1\"; // Specify the path to the first index folder
string indexFolder2 = @"c:\MyIndex2\"; // Specify the path to the second index folder
string documentsFolder1 = @"c:\MyDocuments1\"; // Specify the path to a folder containing documents to index
string documentsFolder2 = @"c:\MyDocuments2\"; // Specify the path to another folder containing documents to index

using (IndexRepository repository = new IndexRepository()) // Creating an index repository
{
    Index index1 = repository.Create(indexFolder1); // Creating the first index in the repository
    index1.Add(documentsFolder1); // Indexing documents from the first folder
    Index index2 = repository.Create(indexFolder2); // Creating the second index in the repository
    index2.Add(documentsFolder2); // Indexing documents from the second folder

    SearchOptions options = new SearchOptions();
    options.IsChunkSearch = true; // Enabling search by chunks

    SearchResult result = repository.Search("Einstein", options); // Getting the first chunk of the first index
    Console.WriteLine("Documents: " + result.DocumentCount);
    while (result.NextChunkSearchToken != null)
    {
        result = repository.SearchNext(result.NextChunkSearchToken); // Getting the next chunk, index by index
        Console.WriteLine("Documents: " + result.DocumentCount);
    }
}

הגנת רשת חיפוש עם מפתח משותף

כל צומת ברשת חיפוש מקבל את אותו מפתח סודי. צומת משני מקבל את הצומת הראשי רק מכתובת שלו, והצומת הראשי מגביל את ההמתנה לתגובות הצמתים.

string basePath = @"c:\SearchNetwork\"; // Specify the path to the folder of the search network
string networkKey = Environment.GetEnvironmentVariable("SEARCH_NETWORK_KEY"); // The same key of at least 16 characters on every node

// On the server of slave node 1: the connection of the master node is accepted from 10.0.0.5 only
TcpSettings slaveSettings = new TcpSettings(49101, 10000, 10000, 10000, 1000);
slaveSettings.NetworkKey = networkKey;
slaveSettings.AllowedMasterAddresses = new string[] { "10.0.0.5" };
SearchNetworkNode node1 = SearchNetworkNode.CreateSlaveNode(1, basePath + "Node1", slaveSettings);
node1.Start();

// On the server of the master node (10.0.0.5): the responses of the nodes are awaited no longer than 10 minutes
Configuration configuration = Configuration.Load(basePath + "Configuration.xml"); // Loading the search network configuration
TcpSettings masterSettings = new TcpSettings(49100, 10000, 10000, 10000, 1000);
masterSettings.NetworkKey = networkKey;
masterSettings.ResponseTimeout = 600000;
SearchNetworkNode node0 = SearchNetworkNode.CreateMasterNode(
    0, basePath + "Node0", masterSettings, new FileLogger(basePath + "Log.txt", 4.0), configuration);
node0.ConfigureAllNodes();
node0.Start();

צמצום שטח הדיסק של אינדקס

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

string indexFolder = @"c:\MyIndex\"; // Specify the path to the index folder
string documentsFolder = @"c:\MyDocuments\"; // Specify the path to a folder containing documents to index

IndexSettings settings = new IndexSettings();
settings.UseFastLoading = false; // The index takes less disk space but loads longer
using (Index index = new Index(indexFolder, settings, true)) // Creating an index with the settings
{
    index.Add(documentsFolder); // Indexing documents from the specified folder
}

using (Index index = new Index(indexFolder)) // Opening the existing index
{
    index.IndexSettings.UseFastLoading = true; // The data is created the next time the index is loaded
}

הערות שדרוג

קחו בחשבון את השינויים הבאים בעת השדרוג מגרסה קודמת:

  • אינדקסים ששונו בגרסה 26.11 אינם ניתנים לפתיחה בגרסאות קודמות. גרסה 26.11 פותחת אינדקסים של גרסה 26.10 ללא המרה, אך ברגע שהיא יוצרת או משנה אינדקס (באינדקסינג, מחיקת מסמכים, אופטימיזציה או שינוי הגדרות), גרסאות קודמות אינן יכולות לפתוח אותו יותר. עדכנו את כל היישומים שמשתפים תיקיית אינדקס בו‑זמנית, כולל הצמתים ברשת חיפוש.
  • פרויקטים של .NET Framework משתמשים בחבילת GroupDocs.Search. החליפו את GroupDocs.Search.NETFramework ב‑GroupDocs.Search, שכעת כוללת את הבניות של .NET Framework 4.6.2 ו‑4.8 ובוחרת את הבנייה המתאימה אוטומטית. אין גרסה 26.11 של GroupDocs.Search.NETFramework.
  • כל הצמתים ברשת חיפוש משודרגים יחד. צמתים של גרסאות 26.10 ו‑26.11 אינם מתחברים. כדי לאבטח את הרשת, הגדירו את אותו TcpSettings.NetworkKey בכל צומת: צמתים עם מפתחות שונים, או צומת עם מפתח וצומת ללא מפתח, אינם מתחברים, ושניהם כותבים את הסיבה ביומנים שלהם. צומת ללא מפתח פועל כבעבר וכותב אזהרה ביומנו.
  • הודעות ברשת חיפוש נחתמות אך אינן מוצפנות. שמרו את הצמתים ברשת מהימנה או חברו אותם דרך מנהרת הצפנה.
  • צמתים אבודים מזוהים. צומת שלא שולח דבר במשך 15 שניות, לדוגמה תהליך שהופסק במאתחן, מתייחס כלא קיים: קריאות שממתינות לו זורקות SearchException, והמסמכים שלו נשלחים לצמתים אחרים או מדווחים דרך אירוע ErrorOccurred. כברירת מחדל הצומת הראשי מחכה לתגובות ללא מגבלה; הגדירו TcpSettings.ResponseTimeout כדי להגביל את ההמתנה.
  • IndexSettings.SearchThreads משותף לכל החיפושים של אינדקס. חיפוש אחד משתמש באותו מספר חוטים כמו לפני, אך K חיפושים במקביל כעת פועלים על max(K, SearchThreads) חוטים במקום K × SearchThreads.
  • רק אינדקסים חדשים מקבלים את האלפבית המורחב. אינדקסים של גרסאות קודמות, כולל אלו שעודכנו על‑ידי IndexUpdater, מפצלים את המילים של תסריטים אלה כמו לפני, ו‑Index.Merge מסרב למזג אינדקס חדש עם ישן. כדי למזג אותם, ייצאו את Alphabet ו‑TokenizationDictionary של האינדקס הישן עם ExportDictionary וייבאו אותם לאינדקס החדש עם Clear ו‑ImportDictionary לפני הוספת מסמכים.
  • מגבלות ההתרחשויות סופרות את חלקי התאריכים פעם אחת. SearchOptions.MaxTotalOccurrenceCount ו‑MaxOccurrenceCountPerTerm סופרים כל הופעה של יום, חודש או שנה פעם אחת לכל חיפוש, או פעם אחת לכל חלק, במקום פעם לכל תאריך בטווח. טווח תאריכים שהגיע למגבלה לפני כן עשוי כעת למצוא את כל התאריכים שלו.
  • חיפוש בחלקים במאגר אינדקסים נע אינדקס אחרי אינדקס. IndexRepository.Search עם IsChunkSearch מחזיר את החלק הראשון של האינדקס הראשון. המשיכו עם IndexRepository.SearchNext כל עוד SearchResult.NextChunkSearchToken אינו ריק, או חפשו ללא חלקים כדי לקבל את כל המסמכים בתוצאה אחת.
  • OCR בתהליך חילוץ נפרד משתמש ב‑ExtractionHost.OcrConnector. הגדירו את המחבר בתוכנית של תהליך החילוץ ובנו את התוכנית עם אותה גרסת GroupDocs.Search כמו היישום. מחבר ה‑OCR של אפשרויות האינדקסינג אינו משמש שם.
  • התקדמות אינדקסינג ברשת מדווחת לפי תגובת חלק. NodeEventHub.IndexingProgressChanged מתרחש פעם אחת לכל תגובה של חלק, שיכולה לדווח על כמה מסמכים, ולכן ProcessedDocuments יכול לגדול ביותר מאחד.

איך לקבל את העדכון

NuGet

  • NuGet – התקנת החבילה העדכנית. היא עובדת בפרויקטים של .NET ו‑.NET Framework ובוחרת את הבנייה עבור מסגרת היעד אוטומטית: .NET Framework 4.6.2 או 4.8, .NET Standard 2.1, .NET 6.0, .NET 8.0 או .NET 10.0.
# Package Manager
NuGet\Install-Package GroupDocs.Search -Version 26.11.0

# .NET CLI
dotnet add package GroupDocs.Search --version 26.11.0

הורדה ישירה

משאבים