API клонирования индекса

Клонирование работает следующим образом:

Чтобы клонировать my_source_index в новый индекс под названием my_target_index, отправьте следующий запрос:

resp = client.indices.clone(
    index="my_source_index",
    target="my_target_index",
)
print(resp)

response = client.indices.clone(
  index: 'my_source_index',
  target: 'my_target_index'
)
puts response

const response = await client.indices.clone({
  index: "my_source_index",
  target: "my_target_index",
});
console.log(response);

POST /my_source_index/_clone/my_target_index

Вышеупомянутый запрос возвращает результат сразу же, как только целевой индекс был добавлен в состояние кластера — он не ждёт начала операции клонирования.

API _clone аналогичен API create index и принимает параметры settings и aliases для целевого индекса:

resp = client.indices.clone(
    index="my_source_index",
    target="my_target_index",
    settings={
        "index.number_of_shards": 5
    },
    aliases={
        "my_search_indices": {}
    },
)
print(resp)

response = client.indices.clone(
  index: 'my_source_index',
  target: 'my_target_index',
  body: {
    settings: {
      'index.number_of_shards' => 5
    },
    aliases: {
      my_search_indices: {}
    }
  }
)
puts response

const response = await client.indices.clone({
  index: "my_source_index",
  target: "my_target_index",
  settings: {
    "index.number_of_shards": 5,
  },
  aliases: {
    my_search_indices: {},
  },
});
console.log(response);

POST /my_source_index/_clone/my_target_index
{
  "settings": {
    "index.number_of_shards": 5 
  },
  "aliases": {
    "my_search_indices": {}
  }
}

Процесс клонирования можно отслеживать с помощью API _cat recovery, или API cluster health можно использовать для ожидания, пока все первичные фрагменты не будут распределены, установив параметр wait_for_status в значение yellow.

API _clone возвращает результат, как только целевой индекс был добавлен в состояние кластера, прежде чем какие-либо фрагменты были распределены. В этот момент все фрагменты находятся в состоянии unassigned. Если по какой-либо причине целевой индекс не может быть распределён, его первичный фрагмент останется unassigned до тех пор, пока он не сможет быть распределён на этом узле.

После того, как первичный фрагмент распределён, он переходит в состояние initializing, и начинается процесс клонирования. Когда операция клонирования завершена, фрагмент станет active. На этом этапе Elasticsearch попытается распределить любые реплики и может принять решение о перемещении первичного фрагмента на другой узел.

Поскольку операция клонирования создаёт новый индекс для клонирования фрагментов в него, настройка ожидания активных фрагментов при создании индекса также применяется к действию клонирования индекса.