GroupDocs.Search for .NET 26.11 está agora disponível. Esta versão torna as buscas repetidas e simultâneas muito mais rápidas, reduz a memória alocada pela indexação em até 4,5 vezes e protege a rede de busca com autenticação de nós. A indexação em uma rede de busca é de 5 a 20 vezes mais rápida, e o pacote NuGet GroupDocs.Search agora inclui builds para .NET Framework 4.8, .NET 6.0, .NET 8.0 e .NET 10.0.
Índices criados pela versão 26.10 abrem sem conversão. A versão contém 18 alterações: 5 novos recursos, 12 melhorias e 1 correção.
Destaques de desempenho
As notas completas de lançamento descrevem a configuração de teste de cada figura.
| O que | Ganho em 26.11 |
|---|---|
| Busca repetida por expressão regular | Até 300 vezes mais rápida |
| Busca difusa repetida | De 4 a 30 vezes mais rápida |
| Buscas simultâneas de um índice | Tempo mediano de 8 buscas simultâneas de 5,6 ms a 0,18 ms; de 4 a 18% mais buscas por segundo |
| Busca difusa com um erro | 1,8 vezes mais rápida, 4,5 vezes mais rápida com 8 threads de busca |
| Busca por intervalo de datas | Até 10 vezes mais rápida, até 59 vezes mais rápida por blocos; intervalos longos retornam resultados completos |
| Memória alocada pela indexação | Até 4,5 vezes menos |
| Indexação com texto de documento armazenado | Até 2,2 vezes mais rápida |
| Recuperação de texto de documento armazenado | 3,5 vezes mais rápida, 11 vezes menos memória |
| Mesclando índices | 3,5 vezes mais rápida, quase 50 vezes menos memória |
| Indexação em uma rede de busca | De 5 a 20 vezes mais rápida, muito menos segmentos de índice nos shards |
| Registrando 20.000 documentos no nó mestre | De 27,1 s a 0,12 s, 0,8 MB gravados em disco ao invés de 7,6 GB |
| Espaço em disco de um índice | Pode ser reduzido ao custo da velocidade de carregamento |
O que há de novo nesta versão
| Chave | Resumo | Categoria |
|---|---|---|
| SEARCHNET-3729 | Implementar uma opção para reduzir o espaço em disco ocupado por um índice ao custo da velocidade de carregamento | Recurso |
| SEARCHNET-3730 | Implementar autenticação de nós da rede de busca | Recurso |
| SEARCHNET-3731 | Implementar suporte a OCR para extração de documentos em um processo separado | Recurso |
| SEARCHNET-3732 | Implementar busca por blocos em um repositório de índices | Recurso |
| SEARCHNET-3733 | Implementar realce de palavras produzidas por um divisor de palavras personalizado | Recurso |
| SEARCHNET-3734 | Otimizar busca por blocos | Melhoria |
| SEARCHNET-3735 | Implementar um pool de threads compartilhado para buscas concorrentes de um índice | Melhoria |
| SEARCHNET-3736 | Implementar reutilização de palavras correspondentes em buscas repetidas | Melhoria |
| SEARCHNET-3737 | Implementar a interface IDisposable na classe Cancellation | Melhoria |
| SEARCHNET-3738 | Estender o alfabeto padrão com scripts adicionais | Melhoria |
| SEARCHNET-3739 | Acelerar busca por intervalo de datas e garantir resultados completos para intervalos de datas longos | Melhoria |
| SEARCHNET-3740 | Reduzir consumo de memória da indexação e das operações com textos de documentos armazenados | Melhoria |
| SEARCHNET-3741 | Acelerar a indexação em uma rede de busca com grande número de documentos | Melhoria |
| SEARCHNET-3742 | Implementar indexação em lote e processamento paralelo de solicitações de shard em uma rede de busca | Melhoria |
| SEARCHNET-3743 | Implementar o padrão de descarte nas classes Index, IndexRepository, Cancellation, ExtractionHost e SearchNetworkNode | Melhoria |
| SEARCHNET-3693 | Implementar Estratégia de Empacotamento TFM-Split para o pacote NuGet GroupDocs.Search | Melhoria |
| SEARCHNET-3747 | Implementar pacotes NuGet para .NET Framework 4.8, .NET 6.0, .NET 8.0, .NET 10.0 | Melhoria |
| SEARCHNET-3746 | Corrigidos esperas indefinidas de uma rede de busca por nós perdidos ou não responsivos | Correção |
Principais recursos
Busca
- Buscas repetidas por curinga, expressão regular, intervalo numérico e difusas reutilizam as palavras encontradas por buscas anteriores com a mesma consulta até que o índice mude. As palavras mantidas ocupam até 8 MB de memória por índice.
- Buscas simultâneas de um índice compartilham seus threads de busca (
IndexSettings.SearchThreads), de modo que buscas curtas não esperam mais por buscas longas. - A busca por intervalo de datas lê cada dia, mês e ano do índice uma única vez ao invés de buscar cada data do intervalo separadamente. Intervalos longos não são mais cortados no limite de ocorrências, e um intervalo de todas as datas possíveis, que antes falhava, agora é buscado em segundos.
- A busca por blocos obtém todos esses ganhos, e um repositório de índices agora também pode ser buscado por blocos:
IndexRepository.SearchNextcontinua a busca índice por índice. - O realce e
Index.GetDocumentTextpodem dividir o texto com o divisor de palavras personalizado usado na indexação, de modo que as palavras que o divisor produz, por exemplo palavras de um texto sem espaços, também sejam realçadas. - O alfabeto padrão de novos índices inclui hebraico, devanágari, georgiano, latim estendido, grego e letras Hangul e marcas diacríticas combinadas. Palavras como “Việt” não são mais divididas em partes, e palavras coreanas e hebraicas são indexadas e encontradas inteiras.
Indexação e armazenamento de índice
- A nova configuração
IndexSettings.UseFastLoadingpermite que um índice em disco descarte os dados adicionais que tornam seu carregamento várias vezes mais rápido: o índice ocupa menos espaço em disco, mas carrega mais lentamente. A configuração pode ser alterada a qualquer momento, também para um índice que já contém documentos. - A indexação aloca até 4,5 vezes menos memória por documento e, com texto de documento armazenado, executa até 2,2 vezes mais rápido. Recuperar texto armazenado é 3,5 vezes mais rápido com 11 vezes menos memória, e mesclar índices é 3,5 vezes mais rápido com quase 50 vezes menos memória.
- O texto de imagens em documentos extraído em um processo separado agora pode ser reconhecido:
ExtractionHost.OcrConnectordefine o conector OCR do processo de extração. Se o reconhecimento estiver habilitado mas o processo de extração não tiver conector OCR, o índice relata isso através do eventoErrorOccurred.
Rede de busca
- Os nós autenticam uns aos outros com uma chave secreta compartilhada (
TcpSettings.NetworkKey), e cada mensagem é assinada: um computador sem a chave não pode dar comandos a um nó nem responder por ele. A chave nunca é enviada pela rede. Um nó escravo também pode restringir os endereços dos quais aceita o nó mestre (TcpSettings.AllowedMasterAddresses). - A indexação é de 5 a 20 vezes mais rápida e cria muito menos segmentos de índice: documentos que chegam enquanto um shard está ocupado são indexados em lotes de até 1 000 documentos ou 16 MB, e os shards de um nó processam suas solicitações em paralelo.
- Registrar documentos indexados no nó mestre não desacelera mais à medida que seu número cresce, e a lista dos documentos de um shard é mantida com segurança quando uma gravação falha ou o processo trava.
- O nó mestre detecta nós perdidos e não responsivos: um nó escravo relata a cada 5 segundos, e chamadas não esperam mais indefinidamente por um nó que desapareceu.
TcpSettings.ResponseTimeouttambém pode limitar quanto tempo o nó mestre espera por uma resposta.
API e empacotamento
Index,IndexRepository,Cancellation,ExtractionHosteSearchNetworkNodeimplementam o padrão padrão de descarte do .NET, de modo que classes derivadas podem liberar seus próprios recursos. Dispor umCancellationlibera o temporizador de um cancelamento agendado porCancelAfter.- O pacote NuGet GroupDocs.Search agora inclui builds para .NET Framework 4.8, .NET 6.0, .NET 8.0 e .NET 10.0 além de .NET Framework 4.6.2 e .NET Standard 2.1, e seleciona automaticamente o build para o framework de destino de um projeto.
Alterações na API pública
Os seguintes membros foram adicionados:
GroupDocs.Search.IndexSettings:Boolean UseFastLoading– mantém os dados adicionais que fazem um índice em disco carregar várias vezes mais rápido. Habilitado por padrão; defina comofalsepara economizar espaço em disco.
GroupDocs.Search.Scaling.Configuring.TcpSettings:String NetworkKey– a chave secreta da rede de busca, com pelo menos 16 caracteres e a mesma em todos os nós.String[] AllowedMasterAddresses– endereços IPv4 ou nomes de host dos quais um nó escravo aceita a conexão do nó mestre.Int32 ResponseTimeout– o tempo em milissegundos que o nó mestre espera pela resposta de um nó a uma solicitação. Sem limite por padrão.
GroupDocs.Search.ExtractionHost:IOcrConnector OcrConnector– o conector OCR do processo de extração separado.
GroupDocs.Search.IndexRepository:SearchResult SearchNext(ChunkSearchToken)eSearchResult SearchNext(ChunkSearchToken, Cancellation)– continuam uma busca por blocos em um repositório de índices.
GroupDocs.Search.Options.TextOptions:IWordSplitter WordSplitter– o divisor de palavras usado pelo realce eIndex.GetDocumentText; herdado porHighlightOptions.
GroupDocs.Search.Common.Cancellationnow implementsIDisposable:void Dispose()– libera o temporizador de um cancelamento agendado; o cancelamento agendado não é solicitado.
Index,IndexRepository,Cancellation,ExtractionHostandSearchNetworkNode:protected virtual void Dispose(Boolean disposing)– o método do padrão de descarte para classes derivadas.
Alterações de comportamento que podem exigir mudanças no seu código estão listadas nas notas de atualização abaixo.
Exemplos de código
Buscar um repositório de índices por blocos
O exemplo a seguir busca dois índices de um repositório bloco a bloco, um índice após o outro.
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);
}
}
Proteger uma rede de busca com uma chave compartilhada
Cada nó de uma rede de busca recebe a mesma chave secreta. Um nó escravo aceita o nó mestre apenas de seu endereço, e o nó mestre limita a espera por respostas dos nós.
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();
Reduzir o espaço em disco de um índice
O exemplo a seguir cria um índice que ocupa menos espaço em disco, e então o faz carregar rapidamente novamente.
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
}
Notas de atualização
Considere as seguintes mudanças ao atualizar de uma versão anterior:
- Índices alterados pela versão 26.11 não podem ser abertos por versões anteriores. A versão 26.11 abre índices da versão 26.10 sem conversão, mas assim que cria ou altera um índice (por indexação, exclusão de documentos, otimização ou mudança de configurações), versões anteriores não podem mais abri-lo. Atualize todas as aplicações que compartilham uma pasta de índice ao mesmo tempo, incluindo os nós de uma rede de busca.
- Projetos .NET Framework usam o pacote GroupDocs.Search. Substitua
GroupDocs.Search.NETFrameworkporGroupDocs.Search, que agora inclui os builds .NET Framework 4.6.2 e 4.8 e seleciona automaticamente o build correto. Não existe versão 26.11 deGroupDocs.Search.NETFramework. - Todos os nós de uma rede de busca são atualizados juntos. Nós das versões 26.10 e 26.11 não se conectam. Para proteger a rede, defina a mesma
TcpSettings.NetworkKeyem todos os nós: nós com chaves diferentes, ou um nó com chave e outro sem, não se conectam, e ambos registram o motivo em seus logs. Um nó sem chave funciona como antes e grava um aviso em seu log. - Mensagens de uma rede de busca são assinadas mas não criptografadas. Mantenha os nós em uma rede confiável ou conecte-os através de um túnel criptografado.
- Nós perdidos são detectados. Um nó que não envia nada por 15 segundos, por exemplo um processo pausado em um depurador, é tratado como perdido: chamadas que esperam por ele lançam
SearchException, e seus documentos são enviados a outros nós ou relatados pelo eventoErrorOccurred. Por padrão o nó mestre espera por respostas sem limite; definaTcpSettings.ResponseTimeoutpara limitar a espera. IndexSettings.SearchThreadsé compartilhado por todas as buscas de um índice. Uma busca usa tantos threads quanto antes, mas K buscas simultâneas agora rodam em max(K,SearchThreads) threads ao invés de K ×SearchThreads.- Somente novos índices recebem o alfabeto estendido. Índices de versões anteriores, incluindo os atualizados por
IndexUpdater, dividem as palavras desses scripts como antes, eIndex.Mergerecusa mesclar um novo índice com um mais antigo. Para mesclá-los, exporte oAlphabete oTokenizationDictionarydo índice mais antigo comExportDictionarye importe-os no novo índice comCleareImportDictionaryantes de adicionar documentos. - Limites de ocorrência contam as partes das datas uma vez.
SearchOptions.MaxTotalOccurrenceCounteMaxOccurrenceCountPerTermcontam cada ocorrência de um dia, mês ou ano uma vez por busca, ou uma vez por bloco, ao invés de uma vez para cada data do intervalo. Um intervalo de datas que atingiu um limite antes agora pode encontrar todas as suas datas. - Busca por blocos em um repositório de índices avança índice por índice.
IndexRepository.SearchcomIsChunkSearchretorna o primeiro bloco do primeiro índice. Continue comIndexRepository.SearchNextenquantoSearchResult.NextChunkSearchTokennão for nulo, ou busque sem blocos para obter todos os documentos em um único resultado. - OCR em um processo de extração separado usa ExtractionHost.OcrConnector. Defina o conector no programa do processo de extração e compile esse programa com a mesma versão GroupDocs.Search da aplicação. O conector OCR das opções de indexação não é usado aí.
- O progresso da indexação em rede é relatado por resposta de shard.
NodeEventHub.IndexingProgressChangedocorre uma vez para cada resposta de um shard, que pode relatar vários documentos, de modo queProcessedDocumentspode crescer em mais de um.
Como obter a atualização
NuGet
- NuGet – Instale o pacote mais recente. Funciona em projetos .NET e .NET Framework e seleciona automaticamente o build para o framework de destino: .NET Framework 4.6.2 ou 4.8, .NET Standard 2.1, .NET 6.0, .NET 8.0 ou .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
Download direto
- Download Direto – Baixe os assemblies compilados para .NET e .NET Framework a partir da página oficial de lançamento:
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/
Recursos
- Notas completas de lançamento – https://releases.groupdocs.com/search/net/release-notes/2026/groupdocs-search-for-net-26-11-release-notes/
- Notas de migração – https://docs.groupdocs.com/search/net/migration-notes/#migrating-to-version-2611
- Documentação – https://docs.groupdocs.com/search/net/
- Exemplos de código – https://github.com/groupdocs-search/GroupDocs.Search-for-.NET/
- Free Support Forum – https://forum.groupdocs.com/c/search/
- Use it from AI agents – o servidor GroupDocs.Search MCP executa este motor localmente para Claude, Cursor e Copilot: https://docs.groupdocs.com/search/mcp/ · Você precisa de um banco de dados vetorial para fazer perguntas sobre uma pasta de documentos?