GroupDocs.Search for .NET 26.11 artık kullanılabilir. Bu sürüm tekrarlanan ve eşzamanlı aramaları çok daha hızlı hale getirir, indeksleme sırasında ayrılan belleği 4,5 kata kadar azaltır ve düğüm kimlik doğrulamasıyla arama ağını güvence altına alır. Bir arama ağında indeksleme 5 ila 20 kat daha hızlıdır ve GroupDocs.Search NuGet paketi artık .NET Framework 4.8, .NET 6.0, .NET 8.0 ve .NET 10.0 için derlemeler içeriyor.

26.10 sürümüyle oluşturulan indeksler dönüştürme olmadan açılır. Bu sürüm 18 değişiklik içerir: 5 yeni özellik, 12 iyileştirme ve 1 düzeltme.

Performans özetleri

Tam sürüm notları her şeklin test kurulumunu açıklar.

Ne 26.11’de Kazanç
Tekrarlanan düzenli ifade araması 300 kata kadar daha hızlı
Tekrarlanan bulanık arama 4 ila 30 kata daha hızlı
Bir indeksin eşzamanlı aramaları 8 eşzamanlı aramanın medyan süresi 5,6 ms’den 0,18 ms’ye; saniyede %4 ila %18 daha fazla arama
Bir hata ile bulanık arama 1,8 kata daha hızlı, 8 arama iş parçacığıyla 4,5 kata daha hızlı
Tarih aralığı araması 10 kata kadar daha hızlı, parçalarla 59 kata kadar daha hızlı; uzun aralıklar tam sonuçlar döndürür
İndeksleme sırasında ayrılan bellek 4,5 kata kadar daha az
Depolanmış belge metniyle indeksleme 2,2 kata kadar daha hızlı
Depolanmış belge metnini alma 3,5 kata daha hızlı, 11 kata daha az bellek
İndeksleri birleştirme 3,5 kata daha hızlı, neredeyse 50 kata daha az bellek
Bir arama ağında indeksleme 5 ila 20 kata daha hızlı, parçacıklarda çok daha az indeks segmenti
Ana düğümde 20.000 belge kaydetme 27,1 s’den 0,12 s’ye, 7,6 GB yerine 0,8 MB disk’e yazıldı
Bir indeksin disk alanı Yükleme hızı pahasına azaltılabilir

Bu sürümde yenilikler

Anahtar Özet Kategori
SEARCHNET-3729 İndeksin kapladığı disk alanını yükleme hızı pahasına azaltma seçeneği ekleyin Özellik
SEARCHNET-3730 Arama ağı düğümlerinin kimlik doğrulamasını uygulayın Özellik
SEARCHNET-3731 Ayrı bir süreçte belge çıkarımı için OCR desteği ekleyin Özellik
SEARCHNET-3732 İndeks deposunda parçalarla arama uygulayın Özellik
SEARCHNET-3733 Özel bir kelime ayırıcı tarafından üretilen kelimelerin vurgulanmasını uygulayın Özellik
SEARCHNET-3734 Parçalarla aramayı optimize edin İyileştirme
SEARCHNET-3735 Bir indeksin eşzamanlı aramaları için paylaşımlı iş parçacığı havuzu uygulayın İyileştirme
SEARCHNET-3736 Tekrarlanan aramalarda eşleşen kelimelerin yeniden kullanılmasını uygulayın İyileştirme
SEARCHNET-3737 Cancellation sınıfında IDisposable arayüzünü uygulayın İyileştirme
SEARCHNET-3738 Varsayılan alfabeyi ek betiklerle genişletin İyileştirme
SEARCHNET-3739 Tarih aralığı aramasını hızlandırın ve uzun tarih aralıkları için tam sonuçları garanti edin İyileştirme
SEARCHNET-3740 İndeksleme ve depolanmış belge metinleriyle yapılan işlemlerin bellek tüketimini azaltın İyileştirme
SEARCHNET-3741 Çok sayıda belge içeren bir arama ağında indekslemeyi hızlandırın İyileştirme
SEARCHNET-3742 Arama ağında toplu indeksleme ve parça isteklerinin paralel işlenmesini uygulayın İyileştirme
SEARCHNET-3743 Index, IndexRepository, Cancellation, ExtractionHost ve SearchNetworkNode sınıflarında dispose desenini uygulayın İyileştirme
SEARCHNET-3693 GroupDocs.Search NuGet Paketi için TFM-Split Paketleme Stratejisini uygulayın İyileştirme
SEARCHNET-3747 .NET Framework 4.8, .NET 6.0, .NET 8.0, .NET 10.0 için NuGet paketleri ekleyin İyileştirme
SEARCHNET-3746 Kayıp veya yanıt vermeyen düğümler için bir arama ağının süresiz beklemesi düzeltildi Düzeltme

Ana özellikler

Arama

  • Tekrarlanan joker karakter, düzenli ifade, sayısal aralık ve bulanık aramalar, aynı sorgu ile önceki aramalarda bulunan kelimeleri indeks değişene kadar yeniden kullanır. Saklanan kelimeler indeks başına 8 MB’a kadar bellek kaplar.
  • Bir indeksin eşzamanlı aramaları, arama iş parçacıklarını (IndexSettings.SearchThreads) paylaşır, böylece kısa aramalar uzun aramaları beklemek zorunda kalmaz.
  • Tarih aralığı araması, aralığın her tarihini ayrı ayrı aramak yerine, her gün, ay ve yılı indeksten bir kez okur. Uzun aralıklar artık oluşum sınırında kesilmez ve daha önce başarısız olan tüm olası tarih aralığı şimdi saniyeler içinde aranır.
  • Parçalarla arama bu tüm avantajları sağlar ve bir indeks deposu da artık parçalarla aranabilir: IndexRepository.SearchNext aramayı indeks indeks devam ettirir.
  • Vurgulama ve Index.GetDocumentText, indeksleme için kullanılan özel kelime ayırıcıyla metni bölerek, örneğin boşluksuz bir metindeki kelimeler gibi ayırıcı tarafından üretilen kelimeleri de vurgular.
  • Yeni indekslerin varsayılan alfabesi İbranice, Devanagari, Gürcüce, genişletilmiş Latin, Yunanca ve Hangul harflerini ve birleştirici diakritik işaretleri içerir. “Việt” gibi kelimeler artık parçalara ayrılmaz ve Korece ve İbranice kelimeler bütün olarak indekslenir ve bulunur.

İndeksleme ve indeks depolama

  • Yeni IndexSettings.UseFastLoading ayarı, bir indeksin disk üzerindeki ek verileri bırakmasını sağlar; bu veri indeksin yüklenmesini birkaç kat daha hızlı yapar: indeks daha az disk alanı kaplar ancak daha uzun sürede yüklenir. Bu ayar her zaman değiştirilebilir, hatta zaten belge içeren bir indeks için de.
  • İndeksleme, belge başına 4,5 kata kadar daha az bellek ayırır ve depolanmış belge metniyle birlikte 2,2 kata kadar daha hızlı çalışır. Depolanmış metni almak 3,5 kata daha hızlıdır ve 11 kata daha az bellek kullanır, indeksleri birleştirmek ise 3,5 kata daha hızlıdır ve neredeyse 50 kata daha az bellek tüketir.
  • Ayrı bir süreçte çıkarılan belgelerdeki görüntülerin metni artık tanınabilir: ExtractionHost.OcrConnector çıkarma sürecinin OCR bağlayıcısını ayarlar. Tanıma etkinleştirilmiş ancak çıkarma sürecinde OCR bağlayıcısı yoksa, indeks bunu ErrorOccurred olayıyla rapor eder.

Arama ağı

  • Düğümler, paylaşılan bir gizli anahtar (TcpSettings.NetworkKey) ile birbirlerini kimlik doğrular ve her mesaj imzalanır: anahtarı olmayan bir bilgisayar ne bir düğüme komut gönderir ne de bir düğüm için yanıt verir. Anahtar ağ üzerinden asla gönderilmez. Bir yardımcı düğüm, ana düğümden kabul ettiği adresleri (TcpSettings.AllowedMasterAddresses) de kısıtlayabilir.
  • İndeksleme 5 ila 20 kata daha hızlıdır ve çok daha az indeks segmenti oluşturur: bir parça meşgulken gelen belgeler 1 000 belgeye ya da 16 MB’ye kadar toplu olarak indekslenir ve bir düğümün parçaları isteklerini paralel olarak işler.
  • Ana düğümde indekslenmiş belgelerin kaydedilmesi, sayı artınca artık yavaşlamaz ve bir parçanın belge listesi, bir yazma hatası ya da süreç çökmesi durumunda güvenli bir şekilde tutulur.
  • Ana düğüm kayıp ve yanıt vermeyen düğümleri tespit eder: bir yardımcı düğüm her 5 saniyede bir rapor verir ve bir düğüm kaybolduğunda çağrılar sonsuza kadar beklemez. TcpSettings.ResponseTimeout ayrıca ana düğümün yanıt bekleme süresini sınırlayabilir.

API ve paketleme

  • Index, IndexRepository, Cancellation, ExtractionHost ve SearchNetworkNode standart .NET dispose desenini uygular, böylece türetilen sınıflar kendi kaynaklarını serbest bırakabilir. Bir Cancellation nesnesinin dispose edilmesi, CancelAfter ile planlanan iptal zamanlayıcısını serbest bırakır.
  • GroupDocs.Search NuGet paketi artık .NET Framework 4.6.2 ve .NET Standard 2.1’in yanı sıra .NET Framework 4.8, .NET 6.0, .NET 8.0 ve .NET 10.0 için derlemeler içerir ve bir projenin hedef çerçevesi için derlemeyi otomatik olarak seçer.

Genel API değişiklikleri

Aşağıdaki üyeler eklendi:

  • GroupDocs.Search.IndexSettings:
    • Boolean UseFastLoading – bir indeksin disk üzerinde birkaç kat daha hızlı yüklenmesini sağlayan ek verileri tutar. Varsayılan olarak etkindir; disk alanı tasarrufu için false olarak ayarlayın.
  • GroupDocs.Search.Scaling.Configuring.TcpSettings:
    • String NetworkKey – arama ağının gizli anahtarı, en az 16 karakter uzunluğunda ve tüm düğümlerde aynı.
    • String[] AllowedMasterAddresses – bir yardımcı düğümün ana düğüm bağlantısını kabul ettiği IPv4 adresleri veya ana bilgisayar adları.
    • Int32 ResponseTimeout – ana düğümün bir isteğe bir düğümün yanıtını milisaniye cinsinden beklediği süre. Varsayılan olarak sınırsız.
  • GroupDocs.Search.ExtractionHost:
    • IOcrConnector OcrConnector – ayrı çıkarma sürecinin OCR bağlayıcısı.
  • GroupDocs.Search.IndexRepository:
    • SearchResult SearchNext(ChunkSearchToken) ve SearchResult SearchNext(ChunkSearchToken, Cancellation) – bir indeks deposunda parçalarla aramayı devam ettirir.
  • GroupDocs.Search.Options.TextOptions:
    • IWordSplitter WordSplitter – vurgulama ve Index.GetDocumentText tarafından kullanılan kelime ayırıcı; HighlightOptions tarafından devralınır.
  • GroupDocs.Search.Common.Cancellation now implements IDisposable:
    • void Dispose() – planlanmış bir iptalin zamanlayıcısını serbest bırakır; planlanan iptal istenmez.
  • Index, IndexRepository, Cancellation, ExtractionHost and SearchNetworkNode:
    • protected virtual void Dispose(Boolean disposing) – türetilen sınıflar için dispose deseni yöntemi.

Kodunuzda değişiklik yapmanızı gerektirebilecek davranış değişiklikleri aşağıdaki yükseltme notlarında listelenmiştir.

Kod örnekleri

Bir indeks deposunu parçalarla arama

Aşağıdaki örnek, bir deponun iki indeksini parça parça, birini diğerinin ardından arar.

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);
    }
}

Paylaşımlı bir anahtar ile arama ağını koruma

Bir arama ağının her düğümü aynı gizli anahtarı alır. Bir yardımcı düğüm, ana düğümü yalnızca kendi adresinden kabul eder ve ana düğüm düğümlerin yanıtlarını bekleme süresini sınırlar.

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();

Bir indeksin disk alanını azaltma

Aşağıdaki örnek, daha az disk alanı kaplayan bir indeks oluşturur ve ardından tekrar hızlı yüklenmesini sağlar.

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
}

Yükseltme notları

Önceki bir sürümden yükseltirken aşağıdaki değişiklikleri göz önünde bulundurun:

  • 26.11 sürümüyle değiştirilen indeksler daha eski sürümler tarafından açılamaz. 26.11 sürümü, 26.10 sürümünün indekslerini dönüştürme olmadan açar, ancak bir indeks oluşturduğunda veya değiştirdiğinde (indeksleme, belge silme, optimizasyon veya ayar değişikliğiyle), daha eski sürümler artık onu açamaz. Bir indeks klasörünü paylaşan tüm uygulamaları, arama ağı düğümleri dahil, aynı anda yükseltin.
  • .NET Framework projeleri GroupDocs.Search paketini kullanır. GroupDocs.Search.NETFramework paketini GroupDocs.Search ile değiştirin; bu paket artık .NET Framework 4.6.2 ve 4.8 derlemelerini içerir ve doğru derlemeyi otomatik olarak seçer. GroupDocs.Search.NETFramework sürümü 26.11 mevcut değildir.
  • Bir arama ağının tüm düğümleri birlikte yükseltilir. 26.10 ve 26.11 sürümündeki düğümler bağlanmaz. Ağı korumak için her düğümde aynı TcpSettings.NetworkKey ayarlayın: farklı anahtara sahip düğümler ya da bir anahtarı olan ve olmayan bir düğüm bağlanmaz ve her ikisi de nedeni günlüklerine yazar. Anahtarı olmayan bir düğüm önceki gibi çalışır ve günlüğüne bir uyarı yazar.
  • Bir arama ağının mesajları imzalanır ancak şifrelenmez. Düğümleri güvenilir bir ağda tutun veya şifreli bir tünel üzerinden bağlayın.
  • Kayıp düğümler tespit edilir. 15 saniye boyunca hiçbir şey göndermeyen bir düğüm, örneğin bir hata ayıklayıcıda duraklatılmış bir süreç, kayıp olarak değerlendirilir: ona bekleyen çağrılar SearchException fırlatır ve belgeleri diğer düğümlere gönderilir veya ErrorOccurred olayıyla raporlanır. Varsayılan olarak ana düğüm yanıtları sınırsız bekler; beklemeyi sınırlamak için TcpSettings.ResponseTimeout ayarlayın.
  • IndexSettings.SearchThreads bir indeksin tüm aramaları tarafından paylaşılır. Bir arama önceki gibi aynı sayıda iş parçacığı kullanır, ancak K eşzamanlı arama artık K × SearchThreads yerine max(K, SearchThreads) iş parçacığında çalışır.
  • Yalnızca yeni indeksler genişletilmiş alfabeyi alır. IndexUpdater ile güncellenenler dahil, önceki sürümlerin indeksleri bu betiklerin kelimelerini önceki gibi ayırır ve Index.Merge yeni bir indeksi eski bir indeksle birleştirmeyi reddeder. Birleştirmek için, eski indeksin Alphabet ve TokenizationDictionary öğelerini ExportDictionary ile dışa aktarın ve belgeleri eklemeden önce Clear ve ImportDictionary ile yeni indekse içe aktarın.
  • Oluşum sınırları tarih parçalarını bir kez sayar. SearchOptions.MaxTotalOccurrenceCount ve MaxOccurrenceCountPerTerm, bir gün, ay veya yılın her oluşumunu arama başına bir kez veya parça başına bir kez sayar; aralıktaki her tarih için bir kez saymaz. Daha önce bir sınıra ulaşan bir tarih aralığı artık tüm tarihlerini bulabilir.
  • Bir indeks deposunda parçalarla arama indeks indeks ilerler. IsChunkSearch ile IndexRepository.Search ilk indeksin ilk parçasını döndürür. SearchResult.NextChunkSearchToken null olana kadar IndexRepository.SearchNext ile devam edin veya tüm belgeleri tek bir sonuçta almak için parçalar olmadan arama yapın.
  • Ayrı bir çıkarma sürecindeki OCR, ExtractionHost.OcrConnector’ı kullanır. Bağlayıcıyı çıkarma sürecinin programında ayarlayın ve bu programı uygulama ile aynı GroupDocs.Search sürümüyle derleyin. İndeksleme seçeneklerinin OCR bağlayıcısı burada kullanılmaz.
  • Ağ indeksleme ilerlemesi parça yanıtı başına raporlanır. NodeEventHub.IndexingProgressChanged bir parçanın her yanıtı için bir kez gerçekleşir; bu yanıt birden fazla belge raporlayabilir, bu yüzden ProcessedDocuments birden fazla artabilir.

Güncellemeyi nasıl alabilirsiniz

NuGet

  • NuGet – En son paketi kurun. .NET ve .NET Framework projelerinde çalışır ve hedef çerçeve için derlemeyi otomatik olarak seçer: .NET Framework 4.6.2 veya 4.8, .NET Standard 2.1, .NET 6.0, .NET 8.0 veya .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

Doğrudan indirme

Kaynaklar