---
title: "Cloud Search のトラブルシューティング"
slug: "cloudsearch-troubleshoot"
updated: 2026-09-17T09:25:51Z
published: 2026-09-17T09:25:51Z
canonical: "guide.ncloud-docs.com/cloudsearch-troubleshoot"
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.

# Cloud Search のトラブルシューティング

Classic/VPC環境で利用できます。

Cloud Searchサービスの利用中に次のような問題が発生することがあります。問題ごとの原因と解決方法を確認し、適切に対処してください。

## コンテナエラー

検索コンテナがエラー状態です。

#### 原因

検索コンテナは検索量とドキュメント量に応じてメモリ使用量が増加し、インデックスコンテナはドキュメント量、インデックス数、複雑度に応じてメモリ使用量が増加します。検索コンテナのメモリ使用量が80%を超えた場合、または使用中のコンテナタイプに比べてメモリ使用量が多い場合、エラー状態が表示されます。

#### 解決方法

コンテナを交換するか、コンテナタイプをアップグレードしてください。

## 「Document format is wrong」というエラーメッセージ

ドキュメントを一括登録する際に「Document format is wrong」というエラーが発生します。

#### 原因

- アップロードするドキュメント形式に問題があります。
- docidで指定された値と keyの値が異なります。
- 存在しないセクションをリクエストしています。
- ドキュメントのアップロード時、contentの内容は Stringタイプのみ可能です。

#### 解決方法

- アップロードするドキュメントの形式は*.jsonである必要があります。ドキュメント形式をご確認ください。
- keyで指定されたセクションの値と 「key」 の値が一致する必要があります。指定された値をご確認ください。
- 存在しないセクションをリクエストしてはいないかご確認ください。
- ドキュメントのアップロード時、contentの内容は Stringタイプのみ作成してください。nullの場合は" "、数値は文字列でリクエストしてください。

## 類義語、誤字修正

類義語、誤字修正オプションが見つかりません。

#### 原因

類似語、誤字脱字の修正機能はサポートしていません。

#### 解決方法

原因で説明したように、これは正常な動作であり、別途の措置は必要ありません。

## N-gram解析

Ngram解析が可能となるように設定したいです。 シソーラスまたは手動インデックスに加え、検索結果に N-gram検索が可能となるように設定したいです。

#### 原因

コンソールではインデックスを変更できず、APIを活用すると ngramをインデックス語として抽出できます。

#### 解決方法

[Schema変更](https://api.ncloud-docs.com/docs/ja/analytics-cloudsearch-changeschema) APIガイドを参照し、以下のように適用してください。

```
...
   {
     "type": "hanaterm",
     "method": "ngram",
     "option": "ngram=3 +ngramonly"  # ngram オプション: unigramから ngramまですべてインデックス語で抽出するオプション(最大値とデフォルト値は10、最小値は2)ngramonlyオプション: 指定したサイズに対応する ngramのみをインデックス語として抽出するオプション。
   }

...
```

## インデックス変更不可

インデックスを変更できません。

#### 原因

コンソールではインデックスを変更できません。インデックスの変更は APIでのみ可能です。

#### 解決方法

原因で説明したように、これは正常な動作であり、別途の措置は必要ありません。インデックスを修正する方法については、[Schema変更](https://api.ncloud-docs.com/docs/ja/analytics-cloudsearch-changeschema) APIガイドをご参照ください。

## コンテンツ一覧

NAVERクラウドプラットフォームでは顧客を支援するために様々な方法で情報を提供します。Cloud Searchサービスの利用時に活用できる有用なコンテンツをご案内します。

- よくある質問: [Cloud Searchに関するよくあるご質問](https://www.ncloud.com/support/faq/prod?categoryCode2=ANALY&categoryCode3=SV_0101)
- APIガイド: [Cloud Search APIガイド](https://api.ncloud-docs.com/docs/ja/analytics-cloudsearch)
- NAVERクラウドプラットフォームブログ: [Cloud Searchを活用して検索環境を手軽に実装](https://blog.naver.com/n_cloudplatform/222189638931?trackingCode=blog_bloghome_searchlist)

              参考

              

本ガイドで必要な情報が見つからない場合やさらに必要な情報がある場合は、いつでも以下のフィードバックアイコンをクリックして、ご意見をお寄せください。いただいたご意見を参照して、より有益な情報を提供できるよう努力してまいります。