| « PreviousNext » | |
   | Did this page help you? Yes | No | Tell us about it... |
Indexing Document Data with Amazon CloudSearch
When you send document updates to your domain, Amazon CloudSearch automatically updates the domain's search index with the new data in near real time. You don't have to do anything for the updates to be indexed. However, if you change the configuration of your domain's index fields or text options, you must explicitly rebuild your search index for those changes to be visible in search results. Because rebuilding the index can take a significant amount of time if you have a lot of data, you should finish making all of your configuration changes before re-indexing your documents.
When you make changes that require re-indexing, the domain status changes to NEEDS INDEXING. While the index is being rebuilt, the domain's status is PROCESSING. You can continue to submit search requests while indexing is in process, but the configuration changes won't be visible in search results until indexing completes and the domain's status changes to ACTIVE.
Note
Depending on the volume of data, building a full index can take a considerable amount of compute power. Amazon CloudSearch automatically manages the resources needed to build the index in a timely fashion. Most data updates and simple domain configuration changes are built and deployed in minutes. Indexing large volumes of data and applying configuration changes that require rebuilding the full index will take longer to complete.
You can initiate indexing using the the cs-index-documents command, from the Amazon CloudSearch console, or using the IndexDocuments configuration action.
Command Line Tools
You use the cs-index-documents command to rebuild your domain's search index.
To explicitly index your domain
Run the
cs-index-documentscommand. For example, to rebuild the index for a domain called movies:cs-index-documents --domain-name movies =========================================== Indexing documents for domain [movies] Now indexing fields: =========================================== actor director genre title year ===========================================
AWS Management Console
When you make changes that require your domain's index to be rebuilt, the status shown on the domain dashboard changes to NEEDS INDEXING. The console also displays a message at the top of the configuration pages prompting you to run indexing when you are done making changes.
To run indexing
Go to the Amazon CloudSearch console at https://console.aws.amazon.com/cloudsearch/home.
In the Navigation panel, click the name of the domain that needs indexing.
On the Domain Dashboard, click the Run Indexing button.
Click OK in the Starting Indexing dialog box to return to the domain dashboard.
API
You use the IndexDocuments configuration action to initiate indexing. For example:
https://cloudsearch.us-east-1.amazonaws.com ?Action=IndexDocuments &DomainName=movies &Version=2011-02-01 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120402/us-east-1/cloudsearch/aws4_request &X-Amz-Date=2012-04-02T22:41:07.764Z &X-Amz-SignedHeaders=host &X-Amz-Signature=cf2f7663cc7c80901474f889ab9b1b8e65deea5be1e2c527319bc8e1 6859d7a4
Note
Amazon CloudSearch configuration requests are authenticated using your AWS credentials. For more information about signing requests, see Request Authentication.
