GroupDocs.Search Java 네트워크로 분산 검색 구성

오늘날 데이터 중심의 세계에서 configure distributed search는 방대한 문서 컬렉션을 처리하면서 응답 시간을 낮게 유지하는 데 필수적입니다. 이 튜토리얼에서는 강력한 GroupDocs.Search for Java 네트워크를 설정하는 과정을 단계별로 안내하며, 여러 노드에 검색을 배포, 인덱스에 문서를 추가, 그리고 신뢰할 수 있는 통신을 위한 TCP 설정 구성 방법을 보여줍니다. 마지막까지 진행하면 생산 환경에 사용할 수 있는 확장 가능한 검색 솔루션을 갖추게 되며, 이 아키텍처가 단일 노드 설정보다 왜 뛰어난지 명확히 이해하게 됩니다.

빠른 답변

  • configure distributed search란 무엇입니까? 여러 독립적인 검색 노드를 연결하여 이들이 함께 인덱싱하고 쿼리에 응답하도록 하는 과정으로, 높은 처리량과 내결함성을 제공합니다.
  • 권장 노드 수는 얼마입니까? 일반적으로 3‑5개의 노드가 대부분의 엔터프라이즈 워크로드에 대해 성능과 내결함성의 균형을 잘 맞춥니다.
  • 라이선스가 필요합니까? 예 – GroupDocs.Search를 프로덕션에서 사용하려면 임시 또는 정식 라이선스가 필요합니다.
  • 어떤 포트를 사용해야 합니까? 서버에서 사용 가능한 포트를 선택하십시오; 예제에서는 49136‑49139를 사용하지만, 열려 있는 범위라면 어느 것이든 사용할 수 있습니다.
  • 배포 후에 새 문서를 추가할 수 있습니까? 물론입니다 – 네트워크를 재시작하지 않고도 언제든지 인덱스에 문서를 추가할 수 있습니다.

configure distributed search란 무엇입니까?

분산 검색 아키텍처를 구성한다는 것은 여러 독립적인 검색 노드를 연결하여 인덱싱 작업을 공유하고 집합적으로 쿼리에 응답하도록 하는 것을 의미합니다. 이는 단일 머신에 대한 부하를 감소시키고 처리량과 신뢰성을 모두 향상시키며, 내결함성을 위한 내장된 중복성을 제공합니다.

왜 Java용 GroupDocs.Search를 사용합니까?

GroupDocs.Search for Java는 고성능 인덱싱(최신 하드웨어에서 초당 최대 1 GB)과 확장 가능한 아키텍처를 제공하며, 10개 이상의 노드 클러스터를 지원합니다. PDF, DOCX, XLSX, PPTX 및 이메일 파일을 포함한 50개 이상의 문서 형식을 기본적으로 이해하므로 추가 변환기 없이도 사실상 모든 비즈니스 콘텐츠를 인덱싱할 수 있습니다. 내장된 TcpSettings 클래스는 지연 시간, 처리량 및 keep‑alive 간격을 미세 조정할 수 있게 하여 데이터센터 경계 너머에서도 노드 간 통신의 신뢰성을 보장합니다. TcpSettings는 노드 간 저수준 TCP 통신 매개변수를 구성합니다.

전제 조건

필수 라이브러리 및 종속성

GroupDocs.Search for Java 버전 25.4 이상이 필요합니다. 개발 환경에 Java가 설치되어 있는지 확인하십시오.

환경 설정 요구 사항

  • Java Development Kit (JDK) 11 이상.
  • IntelliJ IDEA 또는 Eclipse와 같은 IDE를 사용하면 프로젝트 관리가 편리합니다.

지식 전제 조건

기본적인 Java 프로그래밍 기술과 네트워크 구성에 대한 일반적인 이해가 단계들을 원활히 따라가는 데 도움이 됩니다.

GroupDocs.Search for Java 설정

시작하려면 프로젝트에 GroupDocs.Search for Java를 추가하십시오. Maven을 사용하거나 라이브러리를 직접 다운로드하여 추가할 수 있습니다.

Maven 설정
pom.xml 파일에 다음 저장소와 의존성 구성을 추가하십시오:

<repositories>
    <repository>
        <id>repository.groupdocs.com</id>
        <name>GroupDocs Repository</name>
        <url>https://releases.groupdocs.com/search/java/</url>
    </repository>
</repositories>

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-search</artifactId>
        <version>25.4</version>
    </dependency>
</dependencies>

직접 다운로드
또는 최신 버전을 GroupDocs.Search for Java releases에서 다운로드하십시오.

라이선스 획득

GroupDocs.Search를 완전히 활용하려면 임시 라이선스를 받거나 구매할 수 있습니다. 무료 체험 또는 정식 라이선스 획득 방법에 대한 자세한 내용은 GroupDocs’s licensing page를 방문하십시오. 동일한 목적을 위해 GroupDocs licensing page를 사용할 수도 있습니다.

기본 초기화 및 설정

Java 애플리케이션에서 GroupDocs.Search를 초기화해 보겠습니다:

import com.groupdocs.search.*;

public class SearchSetup {
    public static void main(String[] args) {
        // Create an index in the specified folder
        Index index = new Index("YOUR_INDEX_DIRECTORY");

        // Add documents to the index
        index.add("YOUR_DOCUMENT_DIRECTORY");
    }
}

구현 가이드

이 섹션에서는 GroupDocs.Search for Java를 사용하여 검색 네트워크를 구성하고 배포하는 방법을 안내합니다.

GroupDocs.Search로 분산 검색을 구성하는 방법은?

네트워크 구성을 로드하고, 기본 경로를 정의하며, 몇 줄의 코드만으로 TCP 매개변수를 설정합니다. 이 직접 답변 패턴은 자세한 설명에 앞서 필수 단계를 보여줍니다.

먼저 SearchNetworkConfig 객체를 생성하고, 공유 기본 디렉터리를 지정한 뒤 각 노드에 고유한 TCP 포트를 할당합니다. SearchNetworkConfig는 기본 디렉터리와 노드 포트와 같은 분산 검색 클러스터 설정을 정의합니다. 그런 다음 소켓 타임아웃, 버퍼 크기 및 keep‑alive 동작을 제어하는 클래스인 TcpSettings를 인스턴스화합니다. 마지막으로 NetworkManager.deploy(config)를 호출하여 클러스터를 시작합니다. NetworkManager는 클러스터 내 검색 노드의 배포 및 관리를 담당합니다.

네트워크 구성

TcpSettings 클래스는 노드 간 모든 TCP 수준 통신을 위한 구성 허브입니다. 연결 타임아웃, 읽기/쓰기 버퍼 크기 및 Nagle 알고리즘 사용 여부를 설정할 수 있습니다.

Configuration configuration = ConfiguringSearchNetwork.configure("YOUR_DOCUMENT_DIRECTORY", 49136);

노드 배포

고유 식별자와 앞서 정의한 구성을 제공하여 각 노드를 배포합니다. 배포 루틴은 노드를 클러스터에 자동으로 등록하고, 리스닝 소켓을 열며, 백그라운드 인덱싱 스레드를 시작합니다.

public static SearchNetworkNode[] deploy(String basePath, int basePort, Configuration configuration) {
    // Define timeouts for sending and receiving data over the network.
    int sendTimeout = 3000;
    int receiveTimeout = 3000;

    // Create and start three nodes that can run on separate servers or together.
    SearchNetworkNode node1 = new SearchNetworkNode(
        1,
        basePath + "Node1",
        new TcpSettings(basePort + 1, sendTimeout, receiveTimeout)
    );
    node1.start();

    SearchNetworkNode node2 = new SearchNetworkNode(
        2,
        basePath + "Node2",
        new TcpSettings(basePort + 2, sendTimeout, receiveTimeout)
    );
    node2.start();

    SearchNetworkNode node3 = new SearchNetworkNode(
        3,
        basePath + "Node3",
        new TcpSettings(basePort + 3, sendTimeout, receiveTimeout)
    );
    node3.start();

    // Create and configure the main configuration node.
    SearchNetworkNode node0 = new SearchNetworkNode(
        0,
        basePath + "Node0",
        new TcpSettings(basePort, sendTimeout, receiveTimeout),
        new ConsoleLogger(),
        configuration
    );

    // Add an event handler to notify when the configuration is complete.
    node0.getEvents().ConfigurationCompleted.add(new EventHandler() {
        @Override
        public void invoke(Object s, EventArgs e) {
            // Event handling logic here (e.g., logging)
        }
    });

    // Configure all nodes in the network using the main configuration node.
    node0.configureAllNodes();

    // Start the search network by launching all configured nodes.
    node0.start();

    // Return an array of all deployed nodes.
    return new SearchNetworkNode[] {node0, node1, node2, node3};
}

일반적인 문제 및 해결책

  • 디렉터리 접근 오류 – 모든 노드의 기본 디렉터리가 존재하고 Java 프로세스에 읽기/쓰기 권한이 있는지 확인하십시오.
  • 포트 충돌 – 선택한 포트(예: 49136‑49139)가 다른 서비스에서 사용 중인지 확인하십시오; netstat -an을 실행하여 확인할 수 있습니다.
  • 느린 네트워크에서의 타임아웃 – 고지연 환경에서 빈번한 연결 끊김이 발생하면 TcpSettings.setConnectionTimeout()을 늘리십시오.
  • 인덱스 손상 – 인덱스 폴더를 정기적으로 백업하고 NetworkManager.enableAutoRecovery()를 활성화하여 손상된 샤드를 자동으로 복구하도록 하십시오.

실용적인 적용 사례

분산 검색 네트워크를 배포하면 다양한 시나리오에서 유용합니다:

  1. 대규모 엔터프라이즈 시스템 – 수백만 개의 계약서, 정책 및 보고서를 인덱싱하면서 서브 초 단위의 쿼리 응답을 유지합니다.
  2. 콘텐츠 관리 플랫폼 – 멀티미디어 자산을 검색하는 수천 명의 동시 사용자를 병목 현상 없이 지원합니다.
  3. 전자상거래 웹사이트 – 수백만 개의 SKU가 포함된 카탈로그에서 제품 검색 및 파싯 탐색을 가속화합니다.

성능 고려 사항

귀하의 configure distributed search 환경을 효율적으로 운영하려면:

  • 인덱스 크기 관리 – GroupDocs.Search는 100 GB를 초과하는 인덱스를 처리할 수 있지만, 디스크 I/O를 모니터링하고 대규모 컬렉션을 여러 노드에 샤딩하는 것을 고려하십시오.
  • 리소스 튜닝 – 워크로드에 따라 Java 메모리 튜닝 플래그(-Xmx8g -Xms4g)를 적용하고, 고처리량 네트워크를 위해 TcpSettings.setReadBufferSize()를 조정하십시오.
  • 건강 모니터링 – 내장된 NetworkHealthMonitor를 사용하여 노드별 CPU, 메모리 및 네트워크 지연 시간을 추적하고, 정의한 임계값에 대한 알림을 설정하십시오.

결론

이 튜토리얼을 따라 하면 configure distributed search를 수행하고 확장 가능한 GroupDocs.Search Java 네트워크를 배포하는 방법을 배웠습니다. 이 솔루션은 특히 대규모이면서 이질적인 문서 컬렉션을 다룰 때 애플리케이션 검색 기능의 속도와 신뢰성을 크게 향상시킬 수 있습니다.

다음 단계

맞춤형 분석기, 동의어 처리 및 실시간 인덱싱과 같은 고급 기능을 탐색하여 검색 경험을 더욱 개선하십시오. 또한 네트워크를 RESTful API 계층과 통합하여 외부 클라이언트에 검색 기능을 제공할 수 있습니다.

행동 촉구

오늘 프로젝트에 이 견고한 솔루션을 구현하기 시작하고 성능 향상을 직접 체험하십시오!

자주 묻는 질문

Q: GroupDocs.Search for Java란 무엇입니까?
A: GroupDocs.Search for Java는 50개 이상의 문서 형식에 걸쳐 텍스트를 인덱싱하고 검색하는 고성능 라이브러리로, Java 애플리케이션에 빠르고 확장 가능한 전체 텍스트 검색을 제공합니다.

Q: GroupDocs.Search의 임시 라이선스를 어떻게 얻을 수 있습니까?
A: 프로덕션 사용을 위한 무료 체험 또는 정식 라이선스 구매를 위해 GroupDocs’s licensing page를 방문하십시오.

Q: 네트워크 배포 후에 새 문서를 추가할 수 있습니까?
A: 예, 언제든지 IndexManager.addDocument() 메서드를 사용하여 인덱스에 문서를 추가할 수 있으며, 변경 사항이 클러스터 전체에 자동으로 전파됩니다. **IndexManager.addDocument()**는 새 문서를 인덱스에 추가하고 네트워크 전반에 전파합니다.

Q: 노드 구성 시 흔히 발생하는 함정은 무엇입니까?
A: 일반적인 문제로는 일치하지 않는 기본 경로, 포트 충돌, 파일 시스템 권한 부족 등이 있습니다. 각 노드의 구성을 다시 확인하고 모든 디렉터리에 접근할 수 있는지 확인하십시오.

Q: 네트워크가 실시간 인덱싱을 지원합니까?
A: 물론입니다. GroupDocs.Search는 실시간 인덱싱 API를 제공하여 새로 추가된 문서를 즉시 모든 노드에서 검색 가능하게 하며 다운타임이 없습니다.

마지막 업데이트: 2026-06-27
테스트 환경: GroupDocs.Search 25.4 for Java
작성자: GroupDocs

관련 튜토리얼