注意事項

• 上傳同義詞前需確保集群處于正常狀態，該操作會觸發集群滾動重啟，在重啟過程中后臺會進行同義詞詞典的下發，生效時長與集群規模、數據量及負載情況等有關系，建議在業務低峰期操作。

• 如果集群索引存在副本分片且集群負載處于正常水平（CPU使用率在60%左右，堆內存使用率在50%左右，load_1m低于CPU核數），一般情況下，在集群變更過程中可持續對外提供服務。

• 如果集群負載過高且索引沒有副本，同時業務中存在大量的寫入或查詢等場景，在集群變更過程中，業務可能會出現偶發的訪問超時現象。建議在客戶端訪問機制中配置重試機制，以減小對業務的影響。

• 假設現存索引index-aliyun使用了aliyun.txt同義詞文件，當aliyun.txt文件內容變更并重新上傳后，現存索引不會動態加載更新后的同義詞詞典。請在同義詞詞典內容發生變化后進行索引重建操作，否則可能會造成只有新增數據使用新詞典的情況。您也可以使用elasticsearch-analysis-dynamic-synonym插件實現詞典動態加載，詳細信息請參見阿里云Elasticsearch實現同義詞動態更新最佳實踐。

• 同義詞文件要求每行只有一個同義詞表達式（表達式支持Solr規則和WordNet規則），保存為UTF-8編碼的TXT文件，示例如下。

  西紅柿,番茄 =>西紅柿,番茄
  社保,公積金 =>社保,公積金

• 如果停用詞中包含同義詞文件中指定的詞，上傳同義詞文件或進行其他操作時，主日志中會出現錯誤信息。

操作步驟

1. 登錄阿里云Elasticsearch控制臺。
2. 在左側導航欄，單擊Elasticsearch實例。
3. 進入目標實例。
   1. 在頂部菜單欄處，選擇資源組和地域。
   2. 在Elasticsearch實例中單擊目標實例ID。

4. 在左側導航欄，選擇配置與管理>ES集群配置。

5. 在基礎配置區域，單擊同義詞配置右側的上傳。

6. 在同義詞配置面板，單擊面板左下方的配置。

7. 選擇上傳同義詞文件的方式。

   說明

   同義詞文件是按照同義詞配置規則生成的TXT文件。

   • 上傳文件：單擊上傳文件，在本地選擇您要上傳的同義詞文件。

   • 添加OSS文件：輸入Bucket名稱和同義詞文件名稱，單擊添加。

     請確保Bucket與當前Elasticsearch實例在同一地域下，且文件為TXT格式。

8. 單擊保存。

后續步驟

等待實例的狀態變為正常后，登錄Kibana控制臺創建索引、校驗同義詞，并上傳測試數據進行搜索測試。創建索引時需要配置settings和mapping，并且需要在settings中配置"synonyms_path": "analysis/your_dict_name.txt"。詳細信息，請參見使用同義詞和官方文檔Using Synonyms。

相關文檔

更新同義詞詞典的API文檔：UpdateSynonymsDicts。