---
title: "검색 테스트 및 검색 설정"
slug: "cloudsearch-searchsettings"
tags: ["Cloud Search"]
updated: 2026-09-17T09:07:20Z
published: 2026-09-17T09:07:20Z
canonical: "guide.ncloud-docs.com/cloudsearch-searchsettings"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 검색 테스트 및 검색 설정

Classic/VPC 환경에서 이용 가능합니다.

검색 테스트 및 검색 설정에서는 생성한 도메인의 검색 엔진을 설정하고 테스트하는 방법을 설명합니다. 검색 엔진의 랭킹 모듈, 자동 완성, 불용어, 동의어 사전을 설정하고 테스트할 수 있습니다.

## 검색 테스트

콘솔에서 검색 조건과 정렬 방식을 변경하면서 검색을 테스트할 수 있습니다. 검색 테스트를 하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오.
2. **Domain** 메뉴를 클릭해 주십시오.
3. 테스트할 도메인을 선택한 후 **[검색 설정]** 버튼을 클릭해 주십시오.
4. **[검색 테스트]** 탭을 클릭해 주십시오.
5. 테스트 방법을 선택한 후 선택한 테스트 방법에 따라 테스트해 주십시오.  

![cloudsearch-searchsetting_test_ko](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/cloudsearch-searchsetting_test_ko.png?sv=2026-02-06&spr=https&st=2026-10-26T19%3A16%3A50Z&se=2026-10-26T20%3A16%3A50Z&sr=c&sp=r&sig=8U06lH%2F1oada0emcIeRFkJEIl%2FDKjq5UA9WqTFMkx7M%3D)
  - [**검색어로 테스트**](/docs/cloudsearch-searchsettings#%EA%B2%80%EC%83%89%EC%96%B4%EB%A1%9C%ED%85%8C%EC%8A%A4%ED%8A%B8): 검색어를 입력하여 검색
  - [**직접 입력으로 테스트**](/docs/cloudsearch-searchsettings#%EC%A7%81%EC%A0%91%EC%9E%85%EB%A0%A5%EC%9C%BC%EB%A1%9C%ED%85%8C%EC%8A%A4%ED%8A%B8): 검색 쿼리를 입력하여 검색
  - [**랭킹수식**](/docs/cloudsearch-searchsettings#%EB%9E%AD%ED%82%B9%EC%88%98%EC%8B%9D): 랭킹 모듈 또는 모듈의 랭킹 수식을 변경하며 검색

              참고

              

- 테스트 중에 테스트 방법을 변경해도 검색 요청 내용이 유지됩니다.
- **[지난이력 불러오기]** 버튼을 클릭하여 과거 검색 이력을 확인하고 검색 요청 내용을 불러올 수 있습니다.
  - 검색 이력은 검색 시 사용한 브라우저에서만 확인할 수 있습니다.

### 검색어로 테스트

검색 테스트 탭 화면에서 검색어를 입력하여 검색 테스트하는 방법은 다음과 같습니다.

1. **검색어로 테스트**를 클릭해 주십시오.
2. **검색조건**을 클릭한 후, 검색 조건을 설정하고 **[확인]** 버튼을 클릭해 주십시오.
  - **색인 이름**: 검색에 사용할 색인 선택
  - **강조 태그**: 검색 결과에서 검색어를 강조 표시할지 여부 선택
  - **불용어**: 적용할 불용어 규칙 선택
    - **none**: 불용어 규칙 적용 안함
    - 불용어 규칙을 적용하려면 먼저 불용어 규칙을 생성해 주십시오. ([불용어 규칙 생성](/docs/cloudsearch-searchsettings#%EB%B6%88%EC%9A%A9%EC%96%B4%EA%B7%9C%EC%B9%99%EC%83%9D%EC%84%B1) 참고)
  - **정렬 기준**: 검색 결과의 정렬 기준으로 사용할 섹션 변수 선택
    - 여러 번 클릭하여 오름차순(**asc**), 내림차순(**desc**), 선택 해제로 설정할 수 있습니다.
    - 선택하지 않은 경우 검색 결과는 문서 가중치(qds)가 높은 순서대로 정렬됩니다.
3. 검색어를 입력한 후 **[검색]** 버튼을 클릭해 주십시오.
4. 검색 결과를 확인해 주십시오.
  - **[초기화]** 버튼: 검색 조건 및 검색 결과 초기화
  - ![i-cloudsearch-more](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-cloudsearch-more.png?sv=2026-02-06&spr=https&st=2026-10-26T19%3A16%3A50Z&se=2026-10-26T20%3A16%3A50Z&sr=c&sp=r&sig=8U06lH%2F1oada0emcIeRFkJEIl%2FDKjq5UA9WqTFMkx7M%3D): 검색 결과를 JSON 형식으로 확인
  - **랭킹 가중치 보기**: 검색된 문서의 랭킹 및 qds 확인

### 직접 입력으로 테스트

검색 테스트 탭 화면에서 검색 쿼리를 입력하여 검색 테스트하는 방법은 다음과 같습니다.

1. **직접 입력으로 테스트**를 클릭해 주십시오.
2. 검색 쿼리를 입력한 후 **[검색]** 버튼을 클릭해 주십시오.
  - **[참고]**: 검색 쿼리 사용 가이드 확인
  - **[초기화]** 버튼: 검색 쿼리 및 검색 결과 초기화
  - ![i-cloudsearch-more](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-cloudsearch-more.png?sv=2026-02-06&spr=https&st=2026-10-26T19%3A16%3A50Z&se=2026-10-26T20%3A16%3A50Z&sr=c&sp=r&sig=8U06lH%2F1oada0emcIeRFkJEIl%2FDKjq5UA9WqTFMkx7M%3D): 검색 결과를 JSON 형식으로 확인
  - **랭킹 가중치 보기**: 검색된 문서의 랭킹 및 qds 확인

              참고

              

검색 쿼리를 작성하는 방법은 [검색 쿼리](/docs/cloudsearch-searchquery)를 참고해 주십시오.

### 랭킹 수식

검색 테스트 탭 화면에서 랭킹 모듈 및 랭킹 수식을 수정하며 검색 테스트하는 방법은 다음과 같습니다.

              참고

              

여기에서는 검색 테스트 및 랭킹 모듈 관리 방법을 위주로 설명합니다. 랭킹 수식에 대한 자세한 내용은 [랭킹 수식](/docs/cloudsearch-ranking)을 참고해 주십시오.

1. **랭킹수식**을 클릭해 주십시오.
2. **랭킹 이름** 드롭다운 메뉴에서 검색에 적용할 랭킹 모듈을 선택해 주십시오.
3. 선택한 랭킹 모듈의 랭킹 수식을 확인하고, 필요한 경우 수정해 주십시오.
  - **[추가]** 버튼: **랭킹변수**와 **표현식**을 입력한 후 클릭하여 랭킹 수식 추가
  - ![i-cloudsearch-edit](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-cloudsearch-edit.png?sv=2026-02-06&spr=https&st=2026-10-26T19%3A16%3A50Z&se=2026-10-26T20%3A16%3A50Z&sr=c&sp=r&sig=8U06lH%2F1oada0emcIeRFkJEIl%2FDKjq5UA9WqTFMkx7M%3D) / ![i-cloudsearch-delete](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-cloudsearch-delete.png?sv=2026-02-06&spr=https&st=2026-10-26T19%3A16%3A50Z&se=2026-10-26T20%3A16%3A50Z&sr=c&sp=r&sig=8U06lH%2F1oada0emcIeRFkJEIl%2FDKjq5UA9WqTFMkx7M%3D): 랭킹 수식 수정/삭제
  - **[저장]** 버튼: 수정한 내용을 랭킹 모듈에 저장
  - **[새이름으로 저장]** 버튼: 수정한 내용으로 새 랭킹 모듈 생성
  - **[기본 랭킹 설정]** 버튼: 선택한 모듈을 기본 랭킹으로 설정
    - 기본 랭킹으로 지정하면, 검색 시 해당 랭킹 모듈에서 정의한 랭킹 변수를 ranking 옵션 없이도 sort 옵션의 파라미터로 지정할 수 있습니다. (자세한 내용은 [검색 쿼리](/docs/cloudsearch-searchquery) 참고)
  - **[랭킹 삭제]** 버튼: 선택한 랭킹 모듈을 삭제
    - 기본 랭킹은 삭제할 수 없습니다.
4. 검색 쿼리를 입력한 후 **[검색]** 버튼을 클릭해 주십시오.
  - 랭킹 수식을 적용한 검색 결과가 나타납니다.
  - **[초기화]** 버튼: 검색 쿼리, 랭킹 수식 및 검색 결과 초기화
  - ![i-cloudsearch-more](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-cloudsearch-more.png?sv=2026-02-06&spr=https&st=2026-10-26T19%3A16%3A50Z&se=2026-10-26T20%3A16%3A50Z&sr=c&sp=r&sig=8U06lH%2F1oada0emcIeRFkJEIl%2FDKjq5UA9WqTFMkx7M%3D): 검색 결과를 JSON 형식으로 확인
  - **랭킹 가중치 보기**: 검색된 문서의 랭킹 및 qds 확인

## 자동 완성

검색어 자동 완성 기능을 최초 설정 및 설정 변경하고 검색 테스트하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오.
2. **Domain** 메뉴를 클릭해 주십시오.
3. 테스트할 도메인을 선택한 후 **[검색 설정]** 버튼을 클릭해 주십시오.
4. **[자동완성]** 탭을 클릭해 주십시오.
5. **[자동완성 대상설정]** 버튼을 클릭해 주십시오.
6. 자동완성 대상 팝업 창에서 자동 완성 기능을 설정할 섹션 또는 색인을 선택한 후 **[설정]** 버튼을 클릭해 주십시오.
  - 저장된 문서 수에 따라 자동 완성 색인 반영에 2~3시간이 소요될 수 있습니다.
7. 자동 완성 대상을 선택한 후 검색창에 검색어를 입력하여 자동 완성 기능을 테스트해 주십시오.

              참고

              

문서 업로드, 색인 수정 등으로 인한 섹션 및 색인 변경 시 자동 완성 색인을 수동으로 갱신해야 합니다. ([자동 완성 색인 갱신](/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) 참고)

## 불용어

불용어 규칙을 생성하여 검색에서 제외할 단어와 제외 규칙을 설정할 수 있습니다.

              참고

              

검색 시 불용어 규칙을 적용하려면 검색 쿼리의 `search` 필드에서 "stopword": "불용어 규칙 이름"을 설정해야 합니다. 자세한 내용은 [search](/docs/cloudsearch-searchquery#search1)를 참고해 주십시오.

### 불용어 규칙 생성

불용어 규칙을 생성하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오.
2. **Domain** 메뉴를 클릭해 주십시오.
3. 테스트할 도메인을 선택한 후 **[검색 설정]** 버튼을 클릭해 주십시오.
4. **[불용어]** 탭을 클릭해 주십시오.
5. **[추가]** 버튼을 클릭해 주십시오.
6. 규칙 정보 팝업 창이 나타나면 규칙 정보를 입력한 후 **[확인]** 버튼을 클릭해 주십시오.
  - **규칙 이름**: 알파벳, 언더바(_)로만 시작해야 하며, 알파벳, 숫자, 언더바(_), 하이픈(-)만 입력 가능
  - **규칙 타입**: 규칙 적용 방법 설정
    - **부분 매칭**: 검색어가 불용어를 포함하는 경우 검색에서 제외
    - **완전 매칭**: 검색어와 불용어가 완전히 일치하는 경우 검색에서 제외
  - **대소문자 구별**: 대소문자 구별 여부를 설정
  - **단어 목록**: 불용어를 쉼표(,)로 구분하여 입력

### 불용어 규칙 수정

불용어 규칙을 수정하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오.
2. **Domain** 메뉴를 클릭해 주십시오.
3. 테스트할 도메인을 선택한 후 **[검색 설정]** 버튼을 클릭해 주십시오.
4. **[불용어]** 탭을 클릭해 주십시오.
5. 수정할 불용어 규칙을 선택한 후 **[수정]** 버튼을 클릭해 주십시오.
6. 규칙 정보를 수정한 후 **[확인]** 버튼을 클릭해 주십시오.
  - 각 정보 항목에 대한 자세한 내용은 [불용어 규칙 생성](/docs/cloudsearch-searchsettings#%EB%B6%88%EC%9A%A9%EC%96%B4%EA%B7%9C%EC%B9%99%EC%83%9D%EC%84%B1)을 참고해 주십시오.

### 불용어 규칙 삭제

불용어 규칙을 삭제하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오.
2. **Domain** 메뉴를 클릭해 주십시오.
3. 테스트할 도메인을 선택한 후 **[검색 설정]** 버튼을 클릭해 주십시오.
4. **[불용어]** 탭을 클릭해 주십시오.
5. 삭제할 불용어 규칙을 선택한 후 **[삭제]** 버튼을 클릭해 주십시오.
6. 규칙 삭제 팝업 창이 나타나면 **[확인]** 버튼을 클릭해 주십시오.
  - 불용어 규칙 목록에서 해당 규칙이 사라집니다.

## 동의어 사전

동의어 사전을 생성하고 적용하여, 검색 시 검색어의 동의어 검색 결과도 함께 응답하도록 설정할 수 있습니다. 동의어 사전을 사용하려면 다음 절차를 차례대로 실행해 주십시오.

1. 동의어 사전 생성([동의어 사전 생성](/docs/cloudsearch-searchsettings#%EB%8F%99%EC%9D%98%EC%96%B4%EC%82%AC%EC%A0%84%EC%83%9D%EC%84%B1) 참고)
2. 색인 생성 시 분석 옵션으로 동의어 사전 적용([색인 변경](/docs/cloudsearch-indexsettings#%EC%83%89%EC%9D%B8%EB%B3%80%EA%B2%BD) 참고)
3. 검색 시 검색 쿼리의 `search` 필드에서 `"syno": "true"` 설정([search](/docs/cloudsearch-searchquery#search1) 참고)

### 동의어 사전 생성

동의어 사전을 생성하는 방법은 다음과 같습니다.

              참고

              

- 동의어 사전은 도메인 당 하나만 생성할 수 있습니다.
- 동의어 사전은 직접 수정하거나 삭제할 수 없으며, 새 버전을 추가하는 방식으로 수정합니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오.
2. **Domain** 메뉴를 클릭해 주십시오.
3. 테스트할 도메인을 선택한 후 **[검색 설정]** 버튼을 클릭해 주십시오.
4. **[동의어 사전]** 탭을 클릭해 주십시오.
5. **[설정]** 버튼을 클릭해 주십시오.
6. 사전 정보 팝업 창이 나타나면 동의어 사전 정보를 입력하고 **[확인]** 버튼을 클릭해 주십시오.
  - **사전 이름**: 알파벳, 숫자, 언더바(_)만 입력 가능
  - **설명**: 동의어 사전 및 사전의 해당 버전 설명 입력
  - **단어 목록**: 동의어 입력
    - 쉼표(,) 혹은 공백으로 구분하여 동의어 입력
    - 단어는 줄 바꿈으로 구분하여 입력
  - **사전 버전**: 동의어 사전의 버전 입력

### 동의어 사전 버전 추가

생성된 동의어 사전의 버전을 추가하는 방법은 다음과 같습니다.

              참고

              

- 동의어 사전은 직접 수정하거나 삭제할 수 없으며, 새 버전을 추가하는 방식으로 수정합니다.
- 버전 추가 시 이전 버전의 단어 목록은 확인할 수 없습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오.
2. **Domain** 메뉴를 클릭해 주십시오.
3. 테스트할 도메인을 선택한 후 **[검색 설정]** 버튼을 클릭해 주십시오.
4. **[동의어 사전]** 탭을 클릭해 주십시오.
5. **[버전 추가]** 버튼을 클릭해 주십시오.
6. 사전 정보 팝업 창이 나타나면 설명 및 단어 목록을 수정해 주십시오.
7. **사전 버전**을 입력해 주십시오.
  - 기존 버전보다 높은 숫자로 입력해 주십시오.
8. **[확인]** 버튼을 클릭해 주십시오.
  - 동의어 사전이 새로운 버전으로 업데이트됩니다.
  - **버전 정보**가 갱신되며 버전별로 입력한 설명을 확인할 수 있습니다.

### 동의어 사전 버전 삭제

동의어 사전은 삭제할 수 없으며, 이전 버전의 정보만 삭제할 수 있습니다. 이전 버전의 정보를 삭제하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **Big Data & Analytics** > **Cloud Search** 메뉴를 차례대로 클릭해 주십시오.
2. **Domain** 메뉴를 클릭해 주십시오.
3. 테스트할 도메인을 선택한 후 **[검색 설정]** 버튼을 클릭해 주십시오.
4. **[동의어 사전]** 탭을 클릭해 주십시오.
5. **버전 정보**에서 이전 버전의 ![i-cloudsearch-delete](https://cdn.document360.io/6998976f-9d95-4df8-b847-d375892b92c2/Images/Documentation/i-cloudsearch-delete.png?sv=2026-02-06&spr=https&st=2026-10-26T19%3A16%3A50Z&se=2026-10-26T20%3A16%3A50Z&sr=c&sp=r&sig=8U06lH%2F1oada0emcIeRFkJEIl%2FDKjq5UA9WqTFMkx7M%3D)을 클릭해 주십시오.
  - 해당 버전이 버전 정보에서 사라집니다.