本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 Amazon CloudSearch 索引文件資料
<a name="indexing"></a>

當您傳送文件更新至網域時，Amazon CloudSearch 會自動使用新資料更新網域的搜尋索引。您不需要採取任何動作對更新內容編製索引。然而，若您變更了網域組態的索引欄位或文字選項，即必須明確重建您的搜尋索引，才能在搜尋結果中顯現各項變更。由於重建索引可能會耗費大量時間，如果您的資料量很大，便應先完成所有的組態變更後再對您的文件重新編製索引。

**重要**  
如果您變更欄位的類型，且索引中的文件包含與新欄位類型不相容的資料，則執行索引時，正在處理的所有欄位都會處於 `FailedToValidate` 狀態，且索引操作會失敗。還原不相容的組態變更，即可成功重新建立索引。若是必要的變更，請務必將不相容的文件從索引中移除，方可使用新的組態。

當您進行需要重新索引的變更時，網域狀態會變更為 `Needs Indexing`。重建索引時，網域的狀態為 `Processing`。您可以在編製索引時繼續提交搜尋請求，但在編製索引完成且網域的狀態變更為 之前，組態變更不會出現在搜尋結果中`Active`。您也可以繼續上傳文件批次到您的網域。不過，如果您在網域處於 `Processing` 狀態時提交大量更新，可能會增加將更新套用至搜尋索引所需的時間。如果此問題變成問題，請減慢您的更新速率，直到網域返回 `Active` 狀態。

**注意**  
視資料量而定，建立完整索引可能需要相當多的運算能力。Amazon CloudSearch 會自動管理及時建置索引所需的資源。大多數的資料更新和單純的網域組態變更均可在幾分鐘內建置妥並完成部署。對大量資料編製索引及套用需要重建完整索引的組態變更將耗費更久才能完成。

 您可以使用 [Amazon CloudSearch console](#indexing-console)、`aws cloudsearch index-documents` 命令或透過 AWS 開發套件起始索引編製作業。

**Topics**
+ [Amazon CloudSearch console](#indexing-console)
+ [使用 Amazon CloudSearch AWS CLI索引文件](#indexing-clt)
+ [使用 AWS 開發套件對文件編製索引](#indexing-sdk)

## 使用 Amazon CloudSearch 主控台索引文件
<a name="indexing-console"></a>

 當您所做的變更致使網域需要重建索引時，網域儀表板上顯示的狀態將變成 NEEDS INDEXING。主控台還會在組態頁面頂端顯示一則訊息，提示您應於完成變更後編製索引。

**編製索引**

1. 在 [https://console.aws.amazon.com/cloudsearch/home](https://console.aws.amazon.com/cloudsearch/home)：// 開啟 Amazon CloudSearch 主控台。

1. 從左側導覽窗格中，選擇**網域**。

1. 選擇需要索引的網域名稱。

1. 在網域儀表板上，選擇**動作**、**執行索引**。

## 使用 Amazon CloudSearch AWS CLI索引文件
<a name="indexing-clt"></a>

您可以使用 `aws cloudsearch index-documents`命令來重建網域的搜尋索引。如需安裝和設定 的詳細資訊 AWS CLI，請參閱 [AWS Command Line Interface 使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/)。

**對您的網域明確編製索引**
+ 執行 `aws cloudsearch index-documents` 命令。以下範例會對名為 *movies* 的網域重建索引。  
**Example**  

  ```
  aws cloudsearch index-documents --domain-name movies
  ```

## 使用 AWS 開發套件對文件編製索引
<a name="indexing-sdk"></a>

AWS SDKs (Android 和 iOS SDKs除外） 支援 Amazon CloudSearch 組態 API 中定義的所有 Amazon CloudSearch 動作，包括 `IndexDocuments`。如需安裝與使用 AWS 開發套件的詳細資訊，請參閱 [AWS 軟體開發套件](https://aws.amazon.com/code)。