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

ステップ 1: Amazon CloudSearch ドメインを作成する

Amazon CloudSearch ドメインは、検索するデータコレクション、検索リクエストを処理する検索インスタンスに加えて、データにどのようにインデックスを作成し、データを検索するかを制御する設定をカプセル化します。検索可能にするデータの各コレクションについて、個別の検索ドメインを作成します。各ドメインについて、インデックス作成オプション(インデックスに含めるフィールドとその使用方法を記述)、分析スキーム(個々のフィールドの言語固有のテキスト処理オプションを指定)、式(検索結果のランク付け方法をカスタマイズするときに使用)、アクセスポリシー(ドメインのドキュメントおよび検索エンドポイントへのアクセスを制御)を設定します。

検索ドメインと対話して以下を実行します。

  • インデックスおよび検索オプションを設定する

  • インデックス作成のためにデータを送信する

  • 検索を実行する

各ドメインに対しては、独自のエンドポイントを介して検索リクエストを送信します。たとえば、米国東部(バージニア北部) リージョンに作成した movies というドメインのエンドポイントは次のようになります。

search-movies-mtshfsu2rje7ywr66uit3dei4m.us-east-1.cloudsearch.amazonaws.com

検索ドメインを作成するときは、ドメインに一意の名前を指定します。ドメイン名は、3 文字以上、28 文字以内で、先頭は英字または数字にする必要があります。使用できる文字は、a​~​z、0​~​9、およびハイフン(-)です。デフォルトでは、新規ドメインは 米国東部(バージニア北部) リージョンに作成されます。別のリージョンにドメインを作成するには、ドメインの作成時に明示的にリージョンを指定する必要があります。

新しいドメインを設定するには、以下を指定する必要があります。

  • 検索するデータのインデックス作成オプション。

  • ドメインのドキュメントサービスおよび検索サービスのエンドポイントに対するアクセスポリシー。

このチュートリアルでは、Amazon CloudSearch コンソールを使用してドメインを作成し、対話的する方法を示します。詳細については、「検索ドメインの作成」を参照してください。

重要

作成しようとしているドメインは、ライブ環境で、ドメインを削除するまで、標準の Amazon CloudSearch 使用料が発生します。Amazon CloudSearch の使用料については、Amazon CloudSearch の詳細ページを参照してください。

movies ドメインを作成するには

  1. Amazon CloudSearch console at https://console.aws.amazon.com/cloudsearch/homeに移動します。

  2. [Welcome to Amazon CloudSearch] ページで、[Create Your First Search Domain] をクリックします。

  3. [NAME YOUR DOMAIN] ステップで、新しいドメインの名前を入力し、[Continue] をクリックします。ドメイン名は、3 文字以上、28 文字以内で、先頭は英字または数字にする必要があります。ドメイン名に含めることができる文字は、a​~​z(小文字)、0​~​9、および -(ハイフン)です。大文字およびアンダースコア(_)は使用できません。

  4. [CONFIGURE INDEX (インデックスの設定)] ステップで、[Use a predefined configuration (事前定義された設定を使用)] をクリックし、[IMDb movies (demo) (IMDb movies (デモ))] を選択して、[続行] をクリックします。また、データのサンプルを分析して、自動的に検索ドメインを設定することもできます。

  5. [REVIEW INDEX CONFIGURATION] ステップで、設定するインデックスフィールドを確認します。imdb-movie データについては、11 個のフィールド(actors、directors、genres、image_url、plot、rank、rating、release_date、running_time_secs、title、year )が自動的に設定されます。

    注記

    デフォルトで、各フィールドですべてのオプションが有効になっています。これは開発時とテスト時には便利ですが、フィールドの使用方法に応じて各フィールドに設定したオプションを微調整すると、インデックスのサイズを小さくすることができます。ドメインで 1 つのスモール検索インスタンスを使用する場合以外は、オプションをチューニングすると、ドメインの実行コストを最小限に抑えるのに役立ちます。

    インデックス作成オプションの確認が終わったら、[Continue] をクリックします。

  6. [SET UP ACCESS POLICIES] ステップで、[検索およびサジェスタサービス: すべてを許可します。ドキュメントサービス: アカウント所有者のみ。、[続行] をクリックします。推奨ルールでは、検索エンドポイントへのアクセスをすべての IP アドレスに対して許可し、ドキュメントサービスへのアクセスを指定した IP アドレスだけに制限します。

    重要

    検索ドメインのアクセスルールを設定しない場合は、Amazon CloudSearch コンソールを介してドメインと対話することしかできません。デフォルトでは、ドキュメントサービスと検索サービスのエンドポイントは、すべての IP アドレスをブロックするように設定されます。

    静的 IP アドレスを持たない場合は、IP アドレスが変更されるたびにコンピュータを再承認する必要があることを忘れないでください。IP アドレスを動的に割り当てる場合は、おそらくネットワーク上の他のコンピュータとそのアドレスを共有することになります。つまり、IP アドレスを許可する場合、その IP アドレスを共有するすべてのコンピュータが検索ドメインのドキュメントサービスエンドポイントにアクセスできます。

  7. [CONFIRM] ステップで、ドメインの設定を確認し、[Confirm] をクリックしてドメインを作成します。

  8. ドメインが作成されたら、[OK] をクリックして Create New Search Domain ウィザードを終了し、ドメインのダッシュボードに移動します。

新しいドメインを作成すると、Amazon CloudSearch はドメイン用のリソースを初期化します。この処理に約 10 分かかることがあります。この初期化処理中、ドメインのステータスは LOADING になります。ステータスが ACTIVE に変わると、データをアップロードして検索を開始できます。