GroupDocs.Search for .NET 26.11 متاح الآن. هذا الإصدار يجعل عمليات البحث المتكررة والمتزامنة أسرع بكثير، يقلل الذاكرة المخصصة للفهرسة حتى 4.5 مرة وي يؤمن شبكة البحث باستخدام مصادقة العقد. الفهرسة في شبكة البحث أسرع من 5 إلى 20 مرة، وحزمة GroupDocs.Search NuGet الآن تتضمن إصدارات لـ .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 مللي ثانية إلى 0.18 مللي ثانية؛ 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 ميغابايت مكتوبة على القرص بدلاً من 7.6 جيجابايت
مساحة القرص للفهرس يمكن تقليلها على حساب سرعة التحميل

ما الجديد في هذا الإصدار

المفتاح الملخص الفئة
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 لحزمة GroupDocs.Search NuGet تحسين
SEARCHNET-3747 تنفيذ حزم NuGet لـ .NET Framework 4.8، .NET 6.0، .NET 8.0، .NET 10.0 تحسين
SEARCHNET-3746 تم إصلاح الانتظار غير المحدود لشبكة البحث للعقد المفقودة أو غير المستجيبة إصلاح

الميزات الرئيسية

بحث

  • تُعيد عمليات البحث المتكررة باستخدام الأحرف العامة، التعبير النمطي، نطاق الأرقام والبحث التقريبي استخدام الكلمات التي وجدت في عمليات البحث السابقة بنفس الاستعلام حتى يتغير الفهرس. الكلمات المحفوظة تشغل حتى 8 ميغابايت من الذاكرة لكل فهرس.
  • تشارك عمليات البحث المتزامنة على فهرس خيوط البحث الخاصة به (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 ميغابايت، وتُعالج قطع العقدة طلباتها بشكل متوازي.
  • تسجيل المستندات المفهرسة على العقدة الرئيسية لم يعد يتباطأ مع زيادة عددها، وتُحفظ قائمة مستندات القطعة بأمان عندما يفشل كتابة أو يتعطل العملية.
  • العقدة الرئيسية تكتشف العقد المفقودة وغير المستجيبة: العقدة التابعة تُرسل تقريرًا كل 5 ثوانٍ، ولا تنتظر المكالمات إلى الأبد عقدة مفقودة. يمكن أيضًا لـ TcpSettings.ResponseTimeout تحديد مدة انتظار العقدة الرئيسية للرد.

API والتعبئة

  • Index و IndexRepository و Cancellation و ExtractionHost و SearchNetworkNode تنفذ نمط التخلص القياسي في .NET، بحيث يمكن للفئات المشتقة تحرير مواردها الخاصة. التخلص من Cancellation يُحرّر مؤقت الإلغاء المجدول بواسطة CancelAfter.
  • حزمة GroupDocs.Search NuGet الآن تتضمن إصدارات لـ .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

التحميل المباشر

الموارد