---
title: "Cloud Search 문제 해결"
slug: "cloudsearch-troubleshoot"
updated: 2026-05-21T09:01:26Z
published: 2026-05-21T09:03:05Z
canonical: "guide-gov.ncloud-docs.com/cloudsearch-troubleshoot"
---

> ## 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.

# Cloud Search 문제 해결

<p class="platform-info type-classic-vpc">Classic/VPC 환경에서 이용 가능합니다.</p>

Cloud Search 서비스를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오. 

## 컨테이너 오류 <a name="컨테이너오류"></a>
검색 컨테이너가 오류 상태입니다. 

#### 원인 
검색 컨테이너는 검색량과 문서량에 따라 메모리 사용량이 늘어나고 색인 컨테이너는 문서량, 색인 개수, 복잡도에 따라 메모리 사용량이 늘어납니다. 검색 컨테이너 메모리 사용량이 80%가 넘었거나 이용 중인 컨테이너 타입에 비해 메모리 사용량이 많을 경우, 오류 상태가 표시됩니다.

#### 해결 방법
컨테이너를 교체하거나 컨테이너 타입을 업그레이드해 주십시오. 



## "Document format is wrong" 오류 메시지 <a name="Documentformatiswrong오류메시지"></a>
문서 일괄 등록 시 "Document format is wrong" 오류가 발생합니다. 
 
#### 원인  
* 업로드하는 문서 형식에 문제가 있습니다. 
* docid로 지정된 값과 key 값이 다릅니다.
* 존재하지 않는 섹션을 요청하고 있습니다. 
* 문서 업로드 시 content의 내용은 String 타입만 가능합니다. 


#### 해결 방법 
* 업로드하는 문서의 형식은 *.json이어야 합니다. 문서 형식을 확인해 주십시오. 
* key 로 지정된 섹션의 값과 "key" 값이 일치해야 합니다. 지정된 값을 확인해 주십시오. 
* 존재하지 않는 섹션을 요청하고 있는지 확인해 주십시오. 
* 문서 업로드 시 content의 내용은 String 타입만 작성해 주십시오. null인 경우에는 " ", 숫자는 문자열로 요청해 주십시오. 




## 유사어, 오타 수정 <a name="유사어오타수정기능"></a>
유사어, 오타 수정 옵션을 찾을 수 없습니다. 

#### 원인
유사어, 오탈자 수정 기능을 지원하고 있지 않습니다.

#### 해결 방법
원인에서 설명한 바와 같이, 이는 정상적인 동작이며 별도 조치가 필요하지 않습니다. 


## N-gram 분석 <a name="Ngram분석"></a>
Ngram 분석이 가능하도록 설정하고 싶습니다. 
동의어 사전 또는 수동 색인 외에 검색 결과에 N-gram 검색이 가능하도록 설정하고 싶습니다. 

#### 원인  
콘솔에서는 색인 수정이 불가하며, API를 활용하면 ngram을 색인어로 추출할 수 있습니다. 

#### 해결 방법
[Schema 수정](https://api-gov.ncloud-docs.com/docs/analytics-cloudsearch-changeschema){target="_blank"} API 가이드를 참조하여 다음과 같이 적용해 주십시오. 
```
...
   {
     "type": "hanaterm",
     "method": "ngram",
     "option": "ngram=3 +ngramonly"  # ngram 옵션: unigram부터 ngram까지 모두 색인어로 추출하는 옵션. (최대값과 기본값은 10, 최소값은 2) ngramonly 옵션: 지정한 크기에 해당하는 ngram만 색인어로 추출하는 옵션.
   }

...
```



## 색인 수정 불가 <a name="색인수정불가"></a>
색인을 수정할 수 없습니다. 

#### 원인  
콘솔에서는 색인을 수정할 수 없습니다. 색인 수정은 API로만 가능합니다. 

#### 해결 방법
원인에서 설명한 바와 같이, 이는 정상적인 동작이며 별도 조치가 필요하지 않습니다. 색인을 수정하는 방법은 [Schema 수정](https://api-gov.ncloud-docs.com/docs/analytics-cloudsearch-changeschema){target="_blank"} API 가이드를 참조해 주십시오. 



 ## 둘러볼 콘텐츠<a name="둘러볼콘텐츠"></a>
네이버 클라우드 플랫폼에서는 고객에게 도움을 주기 위해 다양한 방식으로 정보를 제공하고 있습니다. Cloud Search 서비스 이용 시 활용할 수 있는 유용한 콘텐츠를 안내합니다.
* 자주 하는 질문: [Cloud Search 자주 하는 질문](https://www.gov-ncloud.com/v2/support/faq/prod?categoryCode2=ANALY&categoryCode3=SV_0108){target="_blank"}
* API 가이드: [Cloud Search API 가이드](https://api-gov.ncloud-docs.com/docs/analytics-cloudsearch){target="_blank"}
* 네이버 클라우드 플랫폼 블로그: [Cloud Search 활용하여 검색 환경 손쉽게 구현하기](https://blog.naver.com/n_cloudplatform/222189638931?trackingCode=blog_bloghome_searchlist){target="_blank"}

 
:::(Info) (참고)
이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.
:::