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 ms에서 0.18 ms로; 초당 검색량이 4~18% 증가 |
| 오류 하나가 있는 퍼지 검색 | 1.8배 빠름, 8개의 검색 스레드 사용 시 4.5배 빠름 |
| 날짜 범위 검색 | 최대 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 | Cancellation 클래스에 IDisposable 인터페이스 구현 | 개선 |
| SEARCHNET-3738 | 기본 알파벳에 추가 스크립트 확장 | 개선 |
| SEARCHNET-3739 | 날짜 범위 검색 가속화 및 긴 날짜 범위에 대한 전체 결과 보장 | 개선 |
| SEARCHNET-3740 | 인덱싱 및 저장된 문서 텍스트 작업의 메모리 사용량 감소 | 개선 |
| SEARCHNET-3741 | 다수 문서가 있는 검색 네트워크에서 인덱싱 가속화 | 개선 |
| SEARCHNET-3742 | 검색 네트워크에서 배치 인덱싱 및 샤드 요청 병렬 처리 구현 | 개선 |
| SEARCHNET-3743 | Index, IndexRepository, Cancellation, ExtractionHost 및 SearchNetworkNode 클래스에 dispose 패턴 구현 | 개선 |
| SEARCHNET-3693 | GroupDocs.Search NuGet 패키지를 위한 TFM-Split 패키징 전략 구현 | 개선 |
| SEARCHNET-3747 | .NET Framework 4.8, .NET 6.0, .NET 8.0, .NET 10.0용 NuGet 패키지 구현 | 개선 |
| 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 dispose 패턴을 구현하므로 파생 클래스가 자체 리소스를 해제할 수 있습니다.Cancellation을 해제하면CancelAfter에 의해 예약된 취소 타이머가 해제됩니다.- GroupDocs.Search NuGet 패키지는 이제 .NET Framework 4.6.2 및 .NET Standard 2.1에 추가로 .NET Framework 4.8, .NET 6.0, .NET 8.0 및 .NET 10.0용 빌드를 포함하며, 프로젝트의 대상 프레임워크에 맞는 빌드를 자동으로 선택합니다.
공개 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.Cancellationnow implementsIDisposable:void Dispose()– 예약된 취소의 타이머를 해제합니다; 예약된 취소는 요청되지 않습니다.
Index,IndexRepository,Cancellation,ExtractionHostandSearchNetworkNode:protected virtual void Dispose(Boolean disposing)– 파생 클래스용 dispose 패턴 메서드.
코드에 변경이 필요할 수 있는 동작 변경 사항은 아래 업그레이드 노트에 나열되어 있습니다.
코드 예제
청크 단위로 인덱스 저장소 검색
다음 예제는 저장소의 두 인덱스를 청크 단위로, 하나씩 순차적으로 검색합니다.
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 빌드를 포함하고 자동으로 올바른 빌드를 선택합니다.GroupDocs.Search.NETFramework의 26.11 버전은 존재하지 않습니다. - 검색 네트워크의 모든 노드는 함께 업그레이드됩니다. 버전 26.10과 26.11 노드는 연결되지 않습니다. 네트워크를 보호하려면 모든 노드에 동일한
TcpSettings.NetworkKey를 설정하십시오: 키가 다른 노드 또는 키가 있는 노드와 없는 노드는 연결되지 않으며, 각각 로그에 이유를 기록합니다. 키가 없는 노드는 이전과 같이 작동하며 경고를 로그에 기록합니다. - 검색 네트워크의 메시지는 서명되지만 암호화되지 않습니다. 노드를 신뢰할 수 있는 네트워크에 두거나 암호화된 터널을 통해 연결하십시오.
- 손실된 노드가 감지됩니다. 예를 들어 디버거에서 일시 중지된 프로세스처럼 15초 동안 아무것도 전송하지 않는 노드는 손실된 것으로 간주됩니다: 해당 노드를 기다리는 호출은
SearchException을 발생시키며, 해당 문서는 다른 노드로 전송되거나ErrorOccurred이벤트로 보고됩니다. 기본적으로 마스터 노드는 제한 없이 응답을 기다리며,TcpSettings.ResponseTimeout을 설정해 대기 시간을 제한할 수 있습니다. IndexSettings.SearchThreads는 인덱스의 모든 검색에서 공유됩니다. 하나의 검색은 이전과 동일한 스레드 수를 사용하지만, K개의 동시 검색은 이제 K ×SearchThreads가 아니라 max(K,SearchThreads) 스레드에서 실행됩니다.- 확장 알파벳은 새로운 인덱스에만 적용됩니다.
IndexUpdater로 업데이트된 것을 포함한 이전 버전의 인덱스는 이러한 스크립트의 단어를 이전과 같이 분리하며,Index.Merge는 새 인덱스와 오래된 인덱스의 병합을 거부합니다. 병합하려면 오래된 인덱스의Alphabet및TokenizationDictionary를ExportDictionary로 내보낸 뒤, 문서를 추가하기 전에Clear와ImportDictionary를 사용해 새 인덱스로 가져오십시오. - 발생 제한은 날짜의 각 부분을 한 번만 계산합니다.
SearchOptions.MaxTotalOccurrenceCount와MaxOccurrenceCountPerTerm은 범위 내 모든 날짜마다가 아니라 검색당(또는 청크당) 하루, 월, 연도 각각의 발생을 한 번씩만 계산합니다. 이전에 제한에 도달했던 날짜 범위도 이제 모든 날짜를 찾을 수 있습니다. - 인덱스 저장소에서 청크 단위 검색은 인덱스별로 진행됩니다.
IsChunkSearch가 설정된IndexRepository.Search는 첫 번째 인덱스의 첫 번째 청크를 반환합니다.SearchResult.NextChunkSearchToken이 null이 아닐 때IndexRepository.SearchNext를 계속 호출하거나, 청크 없이 검색해 모든 문서를 하나의 결과로 얻을 수 있습니다. - 별도 추출 프로세스의 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
직접 다운로드
- Direct Download – 공식 릴리스 페이지에서 .NET 및 .NET Framework용 컴파일된 어셈블리를 다운로드합니다:
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/
리소스
- 전체 릴리스 노트 – https://releases.groupdocs.com/search/net/release-notes/2026/groupdocs-search-for-net-26-11-release-notes/
- 마이그레이션 노트 – https://docs.groupdocs.com/search/net/migration-notes/#migrating-to-version-2611
- 문서 – https://docs.groupdocs.com/search/net/
- 코드 예제 – https://github.com/groupdocs-search/GroupDocs.Search-for-.NET/
- Free Support Forum – https://forum.groupdocs.com/c/search/
- AI 에이전트에서 사용 – the GroupDocs.Search MCP server runs this engine locally for Claude, Cursor and Copilot: https://docs.groupdocs.com/search/mcp/ · 문서 폴더에 대한 질문을 위해 벡터 데이터베이스가 필요하신가요?