# 卷影副本索引 原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-shadow-replicas.html](https://www.elastic.co/guide/en/elasticsearch/reference/current/indices-shadow-replicas.html) 譯文鏈接 : [卷影副本索引](/pages/viewpage.action?pageId=4260489) 貢獻者 : [飛師傅](/display/~zhangyifei) ?此功能是實驗性功能，可能在未來的版本中完全更改或刪除。 如果你想要使用共享文件系統，可以使用卷影副設置來選擇索引數據在磁盤上保存的位置，以及 **Elasticsearch** 如何在一個索引的所有分片上重復操作。 為了充分利用 `index.data_path` 和 `index.shadow_replicas` 設置，你需要允許 **Elasticsearch** 對多個實例使用同一個數據目錄，方法是在 elasticsearch.yml 文件中設置 `node.add_lock_id_to_custom_path` 為 false。 ``` node.add_lock_id_to_custom_path: false ``` 你還需要向安全管理器指定自定義索引的位置，以便可以應用正確的權限。你可以通過 elasticsearch.yml 文件中的 `path.shared_data` 進行設置。 ``` path.shared_data: /opt/data ``` 這表示著 **Elasticsearch** 可以讀寫 `path.shared_data` 設置的目錄中的任意文件。 然后，你可以使用自定義數據路徑創建索引，也就是每個節點都使用這個路徑獲取數據。 因為卷影副本不會在副本分片上索引文檔，所以如果沒有在包含副本的節點上處理最新的集群狀態，副本已知的映射可能會在索引已知的映射之后。因此，強烈建議使用卷影副本時使用預定義映射。 ``` curl -XPUT 'localhost:9200/my_index' -d ' { "index" : { "number_of_shards" : 1, "number_of_replicas" : 4, "data_path": "/opt/data/my_index", "shadow_replicas": true } }' ``` 在上面的例子中，"/opt/data/my_index"路徑是一個共享文件系統，它必須讓 **Elasticsearch** 集群每個節點都可以訪問。你還必須確保 **Elasticsearch** 進程擁有讀寫 `index.data_path` 目錄的權限。 `data_path` 不必包含索引名，在上述例子中，使用了"my_index"，但也可以就用"/opt/data/"。 使用 `index.shadow_replicas` 為"true"的設置創建的索引，不會將文檔操作復制到任何副本分片上，它只會持續刷新。一旦分段在卷影副本所在的文件系統上可以用（在一次 **Elasticsearch** "Flush" 之后），可以使用常規刷新（由 `index.refresh_interval` 管理）讓新數據可搜索。 > 注意 由于文檔只在主分片上有索引，如果只在副本分片上執行上述命令，實時的GET請求可能無法返回文檔，因此如果沒有設置偏好標識，GET API請求會自動設置 `?preference=_primary` 標識。 為了確保以足夠快的方式同步數據，你可能需要將索引刷新的閥值調整為所需的值。因為一次 **flush** 操作需要 **fsync** 分段文件到磁盤上，所以它會對其他所有的副本節點可見。 因為增加 **flush **次數會影響索引性能，所以用戶應該測試適合他們的 **flush** 閥值水平。 **Elasticsearch** 集群仍然會檢測主分片的丟失，并且在丟失的情況下將副本分片轉換為主分片。因為每個卷影副本都沒有維護`IndexWriter`，所以這種轉換需要稍長的時間。 以下是可以使用設置更新API變更的設置列表: `1.index.data_path`（string） ?用于設置存放索引數據的路徑。請注意，默認情況下Elasticsearch會將節點信息附加到路徑，以確保在同一臺機器上的多個Elasticsearch實例不共享數據目錄。 2.`index.shadow_replicas` ?表示此索引是否使用卷影副本。默認為 `false`。 3.?`index.shared_filesystem` ?表示此索引是否使用共享文件系統。如果`index.shadow_replicas`設置為`true`，則默認為`true`，否則為`false`。 4.`index.shared_filesystem.recover_on_any_node` ?表示是否應允許索引的主分片在群集中的任何節點上恢復。如果找到保存分片副本的節點，則恢復首選該節點。默認為false。