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.SearchNextaramayı 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.UseFastLoadingayarı, 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 bunuErrorOccurredolayı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.ResponseTimeoutayrıca ana düğümün yanıt bekleme süresini sınırlayabilir.
API ve paketleme
Index,IndexRepository,Cancellation,ExtractionHostveSearchNetworkNodestandart .NET dispose desenini uygular, böylece türetilen sınıflar kendi kaynaklarını serbest bırakabilir. BirCancellationnesnesinin dispose edilmesi,CancelAfterile 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çinfalseolarak 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)veSearchResult SearchNext(ChunkSearchToken, Cancellation)– bir indeks deposunda parçalarla aramayı devam ettirir.
GroupDocs.Search.Options.TextOptions:IWordSplitter WordSplitter– vurgulama veIndex.GetDocumentTexttarafından kullanılan kelime ayırıcı;HighlightOptionstarafından devralınır.
GroupDocs.Search.Common.Cancellationnow implementsIDisposable:void Dispose()– planlanmış bir iptalin zamanlayıcısını serbest bırakır; planlanan iptal istenmez.
Index,IndexRepository,Cancellation,ExtractionHostandSearchNetworkNode: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.NETFrameworkpaketiniGroupDocs.Searchile 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.NETFrameworksü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.NetworkKeyayarlayı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
SearchExceptionfırlatır ve belgeleri diğer düğümlere gönderilir veyaErrorOccurredolayıyla raporlanır. Varsayılan olarak ana düğüm yanıtları sınırsız bekler; beklemeyi sınırlamak içinTcpSettings.ResponseTimeoutayarlayın. IndexSettings.SearchThreadsbir 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 ×SearchThreadsyerine max(K,SearchThreads) iş parçacığında çalışır.- Yalnızca yeni indeksler genişletilmiş alfabeyi alır.
IndexUpdaterile güncellenenler dahil, önceki sürümlerin indeksleri bu betiklerin kelimelerini önceki gibi ayırır veIndex.Mergeyeni bir indeksi eski bir indeksle birleştirmeyi reddeder. Birleştirmek için, eski indeksinAlphabetveTokenizationDictionaryöğeleriniExportDictionaryile dışa aktarın ve belgeleri eklemeden önceClearveImportDictionaryile yeni indekse içe aktarın. - Oluşum sınırları tarih parçalarını bir kez sayar.
SearchOptions.MaxTotalOccurrenceCountveMaxOccurrenceCountPerTerm, 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.
IsChunkSearchileIndexRepository.Searchilk indeksin ilk parçasını döndürür.SearchResult.NextChunkSearchTokennull olana kadarIndexRepository.SearchNextile 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.IndexingProgressChangedbir parçanın her yanıtı için bir kez gerçekleşir; bu yanıt birden fazla belge raporlayabilir, bu yüzdenProcessedDocumentsbirden 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
- Direct Download – .NET ve .NET Framework için derlenmiş derlemeleri resmi sürüm sayfasından indirin:
https://releases.groupdocs.com/search/net/new-releases/groupdocs.search-for-.net-26.11-dlls-only/
https://releases.groupdocs.com/search/net/new-releases/groupdocs.search-for-.net-26.11/
Kaynaklar
- Tam Sürüm Notları – https://releases.groupdocs.com/search/net/release-notes/2026/groupdocs-search-for-net-26-11-release-notes/
- Geçiş Notları – https://docs.groupdocs.com/search/net/migration-notes/#migrating-to-version-2611
- Dokümantasyon – https://docs.groupdocs.com/search/net/
- Kod Örnekleri – https://github.com/groupdocs-search/GroupDocs.Search-for-.NET/
- Free Support Forum – https://forum.groupdocs.com/c/search/
- AI ajanlarından kullanın – the GroupDocs.Search MCP server runs this engine locally for Claude, Cursor and Copilot: https://docs.groupdocs.com/search/mcp/ · Bir klasördeki belgeler hakkında sorular sormak için vektör veritabanına mı ihtiyacınız var?