--- title: "도메인 관리" slug: "cloudsearch-managedomain" updated: 2026-08-20T09:03:16Z published: 2026-08-20T09:03:16Z canonical: "guide-gov.ncloud-docs.com/cloudsearch-managedomain" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # 도메인 관리 Classic/VPC 환경에서 이용 가능합니다. 도메인 관리에서는 검색 대상 문서를 관리하고 도메인의 설정을 변경할 수 있습니다. ## 문서 관리 JSON 파일을 업로드하여 문서를 추가, 삭제, 갱신하거나 데이터베이스에 저장된 데이터를 업로드할 수 있습니다. 또한, 색인이 완료된 문서 수를 확인하고 자동 완성 색인을 갱신할 수 있습니다. ### 문서 업로드 JSON 파일을 업로드하여 문서를 추가, 삭제, 갱신하거나 데이터베이스에 저장된 데이터를 업로드할 수 있습니다. 문서는 다음과 같은 방법으로 업로드할 수 있습니다. - [파일 업로드](/docs/cloudsearch-managedomain#%ED%8C%8C%EC%9D%BC%EC%97%85%EB%A1%9C%EB%93%9C): 로컬 PC에서 JSON 파일 업로드 - [Object Storage에서 업로드](/docs/cloudsearch-managedomain#ObjectStorage%EC%97%90%EC%84%9C%EC%97%85%EB%A1%9C%EB%93%9C): Object Storage 버킷에서 JSON 파일을 선택하여 업로드하며, 대용량(최대 100 MB) 업로드 가능 - 데이터베이스에서 업로드([VPC](/docs/cloudsearch-managedomain#%EB%8D%B0%EC%9D%B4%ED%84%B0%EB%B2%A0%EC%9D%B4%EC%8A%A4%EC%97%90%EC%84%9C%EC%97%85%EB%A1%9C%EB%93%9CVPC)): 데이터베이스의 테이블에 저장된 데이터 업로드 문서를 업로드하기 전에 다음 사항을 확인해 주십시오. - 업로드할 문서의 형식에 맞게 섹션 및 색인 설정을 완료해 주십시오.([섹션 및 색인 설정](/docs/cloudsearch-indexsettings) 참고) - JSON 파일을 업로드하려는 경우, 형식에 맞게 JSON 파일을 작성해 주십시오. - 요청 종류에 따른 JSON 파일 작성 방법은 [Document 관리](https://api-gov.ncloud-docs.com/docs/analytics-cloudsearch-managedocument)를 참고해 주십시오. - [예제 문서 다운로드](/docs/cloudsearch-download)에서 데모용 문서를 다운받을 수 있습니다. - 데이터베이스의 데이터를 업로드하려는 경우, DB 서버의 네트워크 환경 및 사용자 설정이 다음의 Cloud Search 접속 IP를 통한 접속을 허용하는지 확인해 주십시오. - VPC 환경에서 같은 계정이 보유한 VPC 환경의 DB 서버에 연결하는 경우: 169.254.170.240, 169.254.170.241 참고 - 문서를 업로드하면 자동으로 색인이 갱신됩니다. 갱신에 소요되는 시간은 문서의 특성과 양, 색인의 정의에 따라 차이가 있습니다. - 색인 진행 상황은 도메인의 **검색가능 문서 수**와 **대기중 문서 수**를 통해 확인할 수 있습니다. - 자동 완성 기능을 사용하는 경우, 문서 업로드 후 자동 완성 색인을 수동으로 갱신해야 합니다.([자동 완성 색인 갱신](/docs/cloudsearch-managedomain#%EC%9E%90%EB%8F%99%EC%99%84%EC%84%B1%EC%83%89%EC%9D%B8%EA%B0%B1%EC%8B%A0) 참고) #### 파일 업로드 로컬 PC에서 JSON 파일을 이용하여 문서를 업로드하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오. 2. **Domain** 메뉴를 클릭해 주십시오. 3. 문서를 업로드할 도메인을 선택한 후 **[도메인 관리] > 문서 업로드**를 차례대로 클릭해 주십시오. 4. 문서 업로드 팝업 창이 나타나면 **파일 업로드**를 선택한 후 **[다음]** 버튼을 클릭해 주십시오. 5. JSON 파일을 등록하고 **[업로드]** 버튼을 클릭해 주십시오. - **마우스로 파일을 끌고 오거나 여기를 클릭하세요** 영역에 JSON 파일을 끌어넣거나 **마우스로 파일을 끌고 오거나 여기를 클릭하세요**를 클릭한 후 JSON 파일을 선택할 수 있습니다. 6. 파일 업로드가 완료되면 **[닫기]** 버튼을 클릭해 주십시오. #### Object Storage에서 업로드 Object Storage 버킷에서 JSON 파일을 이용하여 문서를 업로드하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오. 2. **Domain** 메뉴를 클릭해 주십시오. 3. 문서를 업로드할 도메인을 선택한 후 **[도메인 관리] > 문서 업로드**를 차례대로 클릭해 주십시오. 4. 문서 업로드 팝업 창이 나타나면 **오브젝트 스토리지에서 업로드**를 선택해 주십시오. 5. 업로드할 문서가 있는 Object Storage의 리전과 버킷을 선택한 후 **[다음]** 버튼을 클릭해 주십시오. 6. 업로드할 문서를 선택한 후 **[업로드]** 버튼을 클릭해 주십시오. #### 데이터베이스에서 업로드(VPC) VPC 환경에서 데이터베이스에 저장된 데이터를 업로드하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오. 2. **Domain** 메뉴를 클릭해 주십시오. 3. 문서를 업로드할 도메인을 선택한 후 **[도메인 관리] > 문서 업로드**를 차례대로 클릭해 주십시오. 4. 문서 업로드 팝업 창이 나타나면 **데이터베이스에서 업로드**를 선택해 주십시오. 5. 데이터베이스 접속 정보를 입력한 후 **[데이터베이스 연결 확인]** 버튼을 클릭해 주십시오. - 데이터베이스 접속 정보 - **호스트 환경**: 연결할 DB 서버의 환경 선택 - **VPC**: 계정이 보유한 VPC 환경의 DB 서버에 연결할 경우 선택 - **Cloud DB(VPC)**: 계정이 보유한 Cloud DB 서버에 연결할 경우 선택 - **서버 이름**(**VPC**를 선택한 경우): 드롭다운 메뉴에서 DB 서버 선택 - **호스트 혹은 IP**(**Public IP(host)**를 선택한 경우): DB 서버의 공인 IP 또는 Public 도메인 주소 입력 - **데이터베이스 종류**: 연결할 DB 서버의 종류 선택 - **포트**: DB 서버의 연결 포트 입력 - **데이터베이스명**: 데이터가 저장된 데이터베이스 이름 입력 - **유저명**/**비밀번호**: Cloud Search가 DB 서버에 접속할 때 사용할 사용자 정보 입력 - 연결이 확인되면 **대상 테이블명** 드롭다운 메뉴가 활성화됩니다. 6. **대상 테이블명** 드롭다운 메뉴에서 데이터가 저장된 테이블을 선택한 후 **[다음]** 버튼을 클릭해 주십시오. 7. 섹션 정보를 확인한 후 **Key field** 체크 박스를 클릭하여 메인 섹션을 선택해 주십시오. - **Field name**: DB 테이블의 필드명 - **Alias**: DB 테이블의 필드에 해당하는 Cloud Search 도메인의 섹션명 - 필요한 경우 섹션 정보를 수정할 수 있습니다. - **[추가]** 버튼: **Field name**, **Alias**를 입력한 후 클릭하여 직접 섹션 추가 - ![i-cloudsearch-delete](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/i-cloudsearch-delete.png): 데이터를 업로드하지 않을 DB 테이블의 필드 삭제 8. **[업로드]** 버튼을 클릭해 주십시오. ### 검색 가능한 문서 수 확인 도메인에 업로드한 문서 중 색인이 완료되어 검색 가능한 문서 수를 확인하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오. 2. **Domain** 메뉴를 클릭해 주십시오. 3. 해당 도메인을 선택한 후 **[도메인 관리] > 검색 가능한 문서 수 확인**을 차례대로 클릭해 주십시오. 4. 검색 가능한 문서 수 확인 팝업 창이 나타나면 검색 가능 문서 수를 확인한 후 **[확인]** 버튼을 클릭해 주십시오. 참고 도메인 기본 정보의 **검색가능 문서 수** 항목의 **[확인]** 버튼을 클릭하여 확인할 수도 있습니다. ### 자동 완성 색인 갱신 색인 변경, 문서 업로드 등으로 섹션 및 색인 정보가 변경된 경우 자동 완성 색인을 직접 갱신해야 합니다. 자동 완성 색인을 갱신하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오. 2. **Domain** 메뉴를 클릭해 주십시오. 3. 해당 도메인을 선택한 후 **[도메인 관리] > 자동완성 색인갱신**을 차례대로 클릭해 주십시오. 4. 자동완성 색인 팝업 창이 나타나면 **[확인]** 버튼을 클릭해 주십시오. - 저장된 검색 대상 문서 수에 따라 자동 완성 색인 갱신에 2~3시간 정도 소요될 수 있습니다. ## 도메인 설정 변경 서비스 이용량을 고려하여 도메인의 컨테이너 타입 및 수를 변경할 수 있습니다. 또한, 서비스 사용량 제한을 설정할 수 있습니다. ### 컨테이너 타입 변경 도메인 컨테이너 타입의 변경 조건을 확인해 주십시오. - 현재 컨테이너 타입보다 상위 타입으로만 변경할 수 있습니다. - 컨테이너 타입 변경은 계정당 사용 중인 컨테이너 메모리의 합이 512 GB 이하인 범위에서 가능합니다. - 컨테이너 타입에 따라 요금이 추가 과금됩니다. 도메인의 컨테이너 타입을 변경하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오. 2. **Domain** 메뉴를 클릭해 주십시오. 3. 해당 도메인을 선택한 후 **[도메인 관리] > 컨테이너 타입 수정**을 차례대로 클릭해 주십시오. 4. 컨테이너 타입 수정 팝업 창이 나타나면 컨테이너 타입을 선택한 후 **[설정]** 버튼을 클릭해 주십시오. 참고 도메인 기본 정보의 **컨테이너 타입** 항목의 **[수정]** 버튼을 클릭하여 변경할 수도 있습니다. ### 검색용 컨테이너 수 변경 검색용 컨테이너 수의 변경 조건을 확인해 주십시오. - 검색용 컨테이너는 계정당 8개까지 생성할 수 있습니다. - 컨테이너 수 변경은 계정당 사용 중인 컨테이너 메모리의 합이 512 GB 이하인 범위에서 가능합니다. - 컨테이너 추가 시 요금이 추가 과금됩니다. 검색용 컨테이너 수를 변경하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오. 2. **Domain** 메뉴를 클릭해 주십시오. 3. 해당 도메인을 선택한 후 **[도메인 관리] > 검색용 컨테이너 수 수정**을 차례대로 클릭해 주십시오. 4. 검색용 컨테이너 수 수정 팝업 창이 나타나면 ![i-cloudsearch-minus](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/i-cloudsearch-minus.png) / ![i-cloudsearch-plus](https://cdn.document360.io/f2d93c92-8957-408f-94df-b9b370f76a32/Images/Documentation/i-cloudsearch-plus.png)을 클릭하여 검색용 컨테이너 수를 입력한 후 **[설정]** 버튼을 클릭해 주십시오. 참고 도메인 기본 정보의 **검색용 컨테이너 수** 항목의 **[확인]** 버튼을 클릭하여 변경할 수도 있습니다. ### 서비스 사용량 제한 설정 도메인의 일별 또는 월별 서비스 사용량을 제한하고 제한 설정을 변경할 수 있습니다. 도메인의 서비스 사용량을 제한하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오. 2. **Domain** 메뉴를 클릭해 주십시오. 3. 사용량을 제한할 도메인을 선택한 후 **[도메인 관리] > 서비스 사용량 제한 수정**을 차례대로 클릭해 주십시오. 4. 서비스 사용량 제한 팝업 창이 나타나면 제한할 항목의 토글 버튼을 클릭하여 활성화해 주십시오. - **Indexer 요청 건수**: 색인 요청 건수 - **Reindexer 문서 크기**: 섹션 및 색인을 변경한 문서 크기 - **검색응답 사이즈**: 검색에 응답한 네트워크 크기 - **자동완성 갱신**: 자동 완성 색인 갱신 건수 5. 항목별 제한 사용량을 입력한 후 **[설정]** 버튼을 클릭해 주십시오. - 0을 입력하면 제한이 비활성화됩니다. 참고 도메인의 상세 정보의 **서비스 사용량 제한** 영역의 **[수정]** 버튼을 클릭하여 설정할 수도 있습니다.