翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon CloudSearch によるドキュメントデータのインデックス作成
<a name="indexing"></a>

ドキュメント更新をドメインに送信すると、Amazon CloudSearch はドメインの検索インデックスを新しいデータで自動的に更新します。インデックスを作成する更新に対しては何も行う必要がありません。ただし、ドメインのインデックスフィールドまたはテキストオプションの設定を変更した場合、それらの変更が検索結果に表示されるようにするには検索インデックスを明示的に再構築する必要があります。データが多い場合、インデックスの再構築にかなり時間がかかることがあるため、ドキュメントのインデックスを再作成する前に構成の変更をすべて終了する必要があります。

**重要**  
フィールドタイプを変更して、新しいフィールドタイプと互換性のないデータを含むインデックスにドキュメントがある場合、インデックス作成を実行してインデックスオペレーションが失敗すると、処理されるすべてのフィールドは `FailedToValidate` 状態になります。互換性のない設定の変更をロールバックすると、インデックスを再構築できるようになります。変更が必要な場合、互換性のないドキュメントを更新するか、インデックスから削除し、新しい設定を使用する必要があります。

インデックスの再作成が必要となる変更を加えると、ドメインステータスが `Needs Indexing` に変わります。インデックスの再構築中、ドメインのステータスは `Processing` です。インデックス作成の進行中に検索リクエストを送信し続けることができますが、インデックス作成が完了してドメインのステータスが `Active` に変わるまで設定の変更は検索結果に表示されません。また、ドメインにドキュメントバッチを引き続きアップロードすることも可能です。ただし、ドメインが `Processing` の状態の間に大量の更新を送信した場合、更新が検索インデックスに適用されるまでの時間が長くなることがあります。これが問題になる場合は、ドメインが `Active` の状態に戻るまで、更新のペースを下げてください。

**注記**  
データのボリュームによっては、インデックス全体を構築するのにかなりのボリュームの処理能力が消費される可能性があります。Amazon CloudSearch では、インデックスの構築に必要なリソースがタイムリーに自動管理されます。ほとんどのデータ更新と簡単なドメイン設定変更は、数分で構築されてデプロイされます。大量のデータのインデックス作成をする場合、およびインデックス全体の再構築を必要とする設定の変更を適用する場合、より長い時間がかかります。

 インデックス作成は、[Amazon CloudSearch console](#indexing-console) コマンドを使用して `aws cloudsearch index-documents` から開始するか、AWS SDK を通じて開始できます。

**Topics**
+ [Amazon CloudSearch console](#indexing-console)
+ [Amazon CloudSearch AWS CLIを使用したドキュメントのインデックス作成](#indexing-clt)
+ [AWS SDK を使用したドキュメントのインデックス作成](#indexing-sdk)

## Amazon CloudSearch コンソールを使用したドキュメントのインデックス作成
<a name="indexing-console"></a>

 ドメインのインデックスの再構築が必要になる変更を加えると、ドメインダッシュボードに表示されるステータスは NEEDS INDEXING に変わります。変更が終わると、インデックス作成の実行を求めるメッセージもコンソールの設定ページの上部に表示されます。

**インデックス作成を実行するには**

1. Amazon CloudSearch コンソール ([https://console.aws.amazon.com/cloudsearch/home](https://console.aws.amazon.com/cloudsearch/home)) を開きます。

1. 左側のナビゲーションペインから **[ドメイン]** を選択します。

1. インデックス作成が必要なドメイン名を選択します。

1. ドメインダッシュボードで、**[アクション]**、**[インデックス作成の実行]** を選択します。

## Amazon CloudSearch AWS CLIを使用したドキュメントのインデックス作成
<a name="indexing-clt"></a>

ドメインの検索インデックスを再構築するには、`aws cloudsearch index-documents` コマンドを使用します。のインストールとセットアップの詳細については AWS CLI、「 [AWS Command Line Interface ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)」を参照してください。

**ドメインのインデックスを明示的に作成するには**
+ `aws cloudsearch index-documents` コマンドを実行します。以下の例では、*movies* というドメインのインデックスを再構築します。  
**Example**  

  ```
  aws cloudsearch index-documents --domain-name movies
  ```

## AWS SDK を使用したドキュメントのインデックス作成
<a name="indexing-sdk"></a>

AWS SDK では (Android および iOS SDK を除く)、`IndexDocuments` も含めて、Amazon CloudSearch 設定 API で定義されたすべての Amazon CloudSearch アクションがサポートされています。AWS SDK のインストールと使用の詳細については、[「AWS Software Development Kits」](https://aws.amazon.com/code)(AWS ソフトウェアデベロップメントキット) を参照してください。