Amazon CloudSearch ドメインへのドキュメントのアップロードリクエストの送信 - Amazon CloudSearch

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

Amazon CloudSearch ドメインへのドキュメントのアップロードリクエストの送信

重要

Amazon CloudSearch ドメインにデータをアップロードする前に、以下のガイドラインに従ってください。

  • ドキュメントをグループ化Batchをアップロードする前に。1 つのドキュメントのみで構成されるバッチを継続的にアップロードすると、Amazon CloudSearch が更新を処理できる速度に大きな悪影響を及ぼします。代わりに、できるだけ制限に近いバッチを作成し、アップロード頻度を低くします。最大バッチサイズとアップロード頻度について詳しくは、」Amazon CloudSearch の制限を理解する

  • ドメインのドキュメントエンドポイントと検索エンドポイントは、ドメインが存在している間変わりません。すべてのアップロードリクエストや検索リクエストの前にエンドポイントを取得するのではなく、エンドポイントをキャッシュに保存してください。を呼び出すことによって Amazon CloudSearch 設定サービスにクエリを実行します。aws cloudsearch describe-domainsまたはDescribeDomains各リクエストの前に、リクエストが調整される可能性があります。

いずれかの AWS SDK または、AWS CLIをクリックして、ドキュメントのアップロードリクエストを送信します。SDKAWS CLIでは、リクエスト署名を処理し、すべての Amazon CloudSearch アクションを簡単に実行できます。Amazon CloudSearch コンソールを使用して、個々のバッチをアップロードし、DynamoDB または S3 からデータをインポートすることもできます。

たとえば、次のリクエストは、AWS CLI。

aws cloudsearchdomain --endpoint-url http://doc-movies-y6gelr4lv3jeu4rvoelunxsl2e.us-east-1.cloudsearch.amazonaws.com upload-documents --content-type application/json --documents movie-data-2013.json

開発およびテストの目的で、ドメインのドキュメントサービスへの匿名アクセスを許可し、署名されていない HTTP POST リクエストをドメインのドキュメントサービスに直接送信できます。実稼働環境では、ドメインへのアクセスを特定の IAM ユーザー、グループ、またはロールに制限し、署名付きリクエストを送信します。Amazon CloudSearch に対するアクセスの制御については、「」を参照してください。configure access policies。リクエスト署名の詳細については、「」を参照してください。AWS API リクエストに署名する

たとえば、次の POST リクエストは、JSON でフォーマットされたドキュメントのバッチをドメインエンドポイントの doc-movies-123456789012.us-east-1.cloudsearch.amazonaws.com にアップロードします。

curl -X POST --upload-file data1.json doc-movies-123456789012.us-east-1.cloudsearch.amazonaws.com/2013-01-01/documents/batch --header "Content-Type: application/json"