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

Amazon CloudSearch ドメインの作成

Amazon CloudSearch でデータを検索するために、最初に必要なことは検索ドメインを作成することです。検索可能にするデータのコレクションが複数ある場合は、複数の検索ドメインを作成できます。新しいドメインに検索リクエストを送信する前に、アクセスポリシーの設定インデックスフィールドの設定、および検索対象データのアップロードも行う必要があります。

検索ドメインを作成する場合、検索ドメインに一意の名前を付ける必要があります。ドメイン名は、3 文字以上、28 文字以内で、先頭は英字または数字にする必要があります。使用できる文字は、a​~​z、0​~​9、およびハイフン(-)です。大文字、下線(_)、およびその他の特殊文字は、ドメイン名には使用できません。

デフォルトでは、すべての新しいドメインは 2013-01-01 API バージョンを使用して作成されます。2011-02-01 API バージョンを使用して、以前に検索ドメインを作成していた場合は、新しいドメインに古い API を使用することもできます。ただし、まったく新しいユースケースでは、2013-01-01 API を使用することをお勧めします。2013-01-01 API が使用中止になったときには、すべてのドメインを 2011-02-01 API に移行する必要があります。

検索ドメインを作成する AWS のリージョンを選択できます。一般的に、オペレーションの最寄りのリージョンを選択する必要があります。たとえば、所在地がヨーロッパである場合は、欧州 (アイルランド) リージョン (eu-west-1) に検索ドメインを作成します。現在サポートされているリージョンとエンドポイントのリストについては、「リージョンとエンドポイント」を参照してください。リージョンの選択の詳細については、「Amazon CloudSearch のリージョンとエンドポイント」を参照してください。

注記

異なるリージョンにある Amazon CloudSearch ドメインは完全に独立しています。たとえば、my-domain という検索ドメインを us-east-1 に作成し、my-domain という別のドメインを eu-west-1 に作成した場合、これらは完全に独立しており、データは共有されません。

各検索ドメインには、インデックス作成用のデータのアップロードや、検索リクエストの送信に使用できる一意のエンドポイントがあります。ドメインのドキュメントエンドポイントと検索エンドポイントは、ドメインが存在している間変わりません。たとえば、imdb-movies というドメインのエンドポイントは次のようになります。

doc-imdb-movies-nypdffbzrfkoudsurkxvgwbpi4.us-east-1.cloudsearch.amazonaws.com search-imdb-movies-nypdffbzrfkoudsurkxvgwbpi4.us-east-1.cloudsearch.amazonaws.com

重要

デフォルトでは、新しいドメインのドキュメントエンドポイントと検索エンドポイントへのアクセスは、すべての IP アドレスに対してブロックされます。ドメインの検索エンドポイントに検索リクエストを送信して、コマンドラインまたはドメインのドキュメントエンドポイントからデータをアップロードするには、ドメインのアクセスポリシーを設定する必要があります。Amazon CloudSearch コンソールを使用すると、アクセスポリシーを設定せずに、ドキュメントをアップロードし、ドメインを検索できます。

コンソール から、aws cloudsearch create-domain コマンドを使用して、または AWS SDK のいずれかを使用して、検索ドメインを作成できます。

Amazon CloudSearch コンソールを使用したドメインの作成

Amazon CloudSearch コンソールでは、簡単に新しい検索ドメインを作成することができ、インデックス作成オプションを設定するためのさまざまなオプションが用意されています。

ドメインを作成するには

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

  2. [Navigation] ペインの上部にある [Create a New Domain] をクリックします(ドメインを初めて作成する場合は、[Welcome] ページの [Create Your First Search Domain] をクリックします)。

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

    オプションで、[Desired Instance Type] と [Desired Replication Count] を設定し、事前にドメインをスケーリングすることができます。詳細については、「スケーリングオプションの設定」を参照してください。

  4. [CONFIGURE INDEX] ステップで、[Manual Configuration] を選択し、[Continue] をクリックします。最初にドメインを作成するときにインデックスフィールドとアクセスポリシーを設定することも、ドメインの作成のみにして後から設定することもできます。Amazon CloudSearch コンソールを使用したドメインの設定の詳細については、「インデックスオプションの設定」および「アクセスポリシーの設定」を参照してください。

  5. [REVIEW INDEX CONFIGURATION] ステップで、インデックスフィールドを後で設定するために [Continue] をクリックします。インデックスフィールドの設定の詳細については、「インデックスオプションの設定」を参照してください。

  6. [SET UP ACCESS POLICIES] ステップで、アクセスポリシーを後でセットアップするために [Continue] をクリックします。アクセスポリシーの設定の詳細については、「アクセスポリシーの設定」を参照してください。

    注記

    アクセスポリシーを設定するまで、コンソールを使用した場合にのみ、ドキュメントをアップロードして検索クエリを送信できます。デフォルトでは、ドキュメントエンドポイントと検索エンドポイントは、すべての IP アドレスをブロックするように設定されます。

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

  8. ドメインが作成されたら、[OK] をクリックして Create New Search Domain ウィザードを終了し、ドメインのダッシュボードに移動します。ドメインのドキュメントエンドポイントおよび検索サービスエンドポイントは、ドメインが ACTIVE 状態になったときにドメインダッシュボードに表示されます。この時点で、インデックス作成のためにドキュメントをアップロードし、データの検索を開始できます。

AWS CLI を使用したドメインの作成

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

ドメインを作成するには

  • aws cloudsearch create-domain コマンドを実行し、--domain-name オプションで作成するドメインの名前を指定します。たとえば、movies という名前のドメインを作成するには、次のコマンドを実行します。

    aws cloudsearch create-domain --domain-name movies { "DomainStatus": { "DomainId": "965407640801/movies", "Created": true, "Deleted": false, "SearchInstanceCount": 0, "DomainName": "movies", "SearchService": {}, "RequiresIndexDocuments": false, "Processing": false, "DocService": {}, "ARN": "arn:aws:cloudsearch:us-east-1:965407640801:domain/movies", "SearchPartitionCount": 0 } }

aws cloudsearch create-domain コマンドは直ちに制御を戻します。新しいドメインのエンドポイントを作成するのに約 10 分かかります。ドメインのステータスと設定の概要を表示するには、aws cloudsearch describe-domains コマンドを使用できます。詳細については、「Amazon CloudSearch ドメインに関する情報の取得」を参照してください。

重要

ドメインのエンドポイントがアクティブになると、ドメインが存在している間、エンドポイントは変わりません。エンドポイントをキャッシュに保存してください—ドキュメントや検索サービスリクエストを送信する前にエンドポイントにクエリを実行する必要はありません。このようなクエリを実行すると、リクエストの調整が発生する可能性があります。

AWS SDK を使用した Amazon CloudSearch ドメインの作成

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