Amazon CloudSearch
開発者ガイド (API バージョン 2013-01-01)

Amazon CloudSearch を使用したドキュメントデータのインデックス作成

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

重要

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

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

注記

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

インデックス作成は、Amazon CloudSearch コンソール コマンドを使用して aws cloudsearch index-documents から開始するか、AWS SDK を通じて開始できます。

Amazon CloudSearch コンソールを使用したドキュメントのインデックス作成

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

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

  1. AWS マネジメントコンソールにサインインし、Amazon CloudSearch console at https://console.aws.amazon.com/cloudsearch/home を開きます。

  2. [Navigation] ペインで、インデックス作成が必要なドメインの名前をクリックします。

  3. ドメインダッシュボードで、[Run Indexing] ボタンをクリックします。

  4. [Starting Indexing] ダイアログボックスで [OK] をクリックし、ドメインダッシュボードに戻ります。

Amazon CloudSearch AWS CLI を使用したドキュメントのインデックス作成

ドメインの検索インデックスを再構築するには、aws cloudsearch index-documents コマンドを使用します。AWS CLI のインストールおよびセットアップの詳細については、『AWS Command Line Interface ユーザーガイド』を参照してください。

ドメインのインデックスを明示的に作成するには

  • aws cloudsearch index-documents コマンドを実行します。以下の例では、movies というドメインのインデックスを再構築します。

    aws cloudsearch index-documents --domain-name movies

AWS SDK を使用したドキュメントのインデックス作成

AWS SDK では(Android および iOS SDK を除く)、IndexDocuments も含めて、Amazon CloudSearch 設定 API で定義されたすべての Amazon CloudSearch アクションがサポートされています。AWS SDK のインストールと使用の詳細については、「AWS Software Development Kits」を参照してください。