API Rollover

При переключении алиаса индекса можно указать имя для нового индекса. Если вы не укажете имя, и текущий индекс заканчивается на - и число, например, my-index-000001 или my-index-3, имя нового индекса увеличивает это число. Например, если вы переключаете алиас с текущим индексом my-index-000001, переключение создаёт новый индекс с именем my-index-000002. Это число всегда имеет 6 символов и заполняется нулями, независимо от имени предыдущего индекса.

Переключение создаёт новый индекс и подчиняется настройке wait_for_active_shards.

Следующий запрос выполняет перенос потока данных безусловно.

POST my-data-stream/_rollover

Следующий запрос выполняет перенос потока данных только в том случае, если текущий индекс записи удовлетворяет одному или нескольким из следующих условий:

POST my-data-stream/_rollover
{
  "conditions": {
    "max_age": "7d",
    "max_docs": 1000,
    "max_primary_shard_size": "50gb"
  }
}

API возвращает:

{
  "acknowledged": true,
  "shards_acknowledged": true,
  "old_index": ".ds-my-data-stream-2099.05.06-000001",
  "new_index": ".ds-my-data-stream-2099.05.07-000002",
  "rolled_over": true,
  "dry_run": false,
  "conditions": {
    "[max_age: 7d]": false,
    "[max_docs: 1000]": true,
    "[max_primary_shard_size: 50gb]": false
  }
}

Следующий запрос создает <my-index-{now/d}-000001> и устанавливает его в качестве индекса записи для my-alias.

# PUT <my-index-{now/d}-000001>
PUT %3Cmy-index-%7Bnow%2Fd%7D-000001%3E
{
  "aliases": {
    "my-alias": {
      "is_write_index": true
    }
  }
}

Следующий запрос выполняет перенос алиаса только в том случае, если текущий индекс записи удовлетворяет одному или нескольким из следующих условий:

POST my-alias/_rollover
{
  "conditions": {
    "max_age": "7d",
    "max_docs": 1000,
    "max_primary_shard_size": "50gb"
  }
}

API возвращает:

{
  "acknowledged": true,
  "shards_acknowledged": true,
  "old_index": "my-index-2099.05.06-000001",
  "new_index": "my-index-2099.05.07-000002",
  "rolled_over": true,
  "dry_run": false,
  "conditions": {
    "[max_age: 7d]": false,
    "[max_docs: 1000]": true,
    "[max_primary_shard_size: 50gb]": false
  }
}

Если имена индексов алиаса используют математику дат и вы переносите индексы с регулярным интервалом, вы можете использовать математику дат для сужения поиска. Например, следующий поиск нацелен на индексы, созданные в последние три дня.

# GET /<my-index-{now/d}-*>,<my-index-{now/d-1d}-*>,<my-index-{now/d-2d}-*>/_search
GET /%3Cmy-index-%7Bnow%2Fd%7D-*%3E%2C%3Cmy-index-%7Bnow%2Fd-1d%7D-*%3E%2C%3Cmy-index-%7Bnow%2Fd-2d%7D-*%3E/_search

Следующий запрос создает <my-index-{now/d}-000001> и его алиас my-write-alias.

# PUT <my-index-{now/d}-000001>
PUT %3Cmy-index-%7Bnow%2Fd%7D-000001%3E
{
  "aliases": {
    "my-write-alias": { }
  }
}

Следующий запрос выполняет перенос алиаса только в том случае, если текущий индекс удовлетворяет одному или нескольким из следующих условий:

POST my-write-alias/_rollover
{
  "conditions": {
    "max_age": "7d",
    "max_docs": 1000,
    "max_primary_shard_size": "50gb"
  }
}

API возвращает:

{
  "acknowledged": true,
  "shards_acknowledged": true,
  "old_index": "my-index-2099.05.06-000001",
  "new_index": "my-index-2099.05.07-000002",
  "rolled_over": true,
  "dry_run": false,
  "conditions": {
    "[max_age: 7d]": false,
    "[max_docs: 1000]": true,
    "[max_primary_shard_size: 50gb]": false
  }
}

Обычно вы используете шаблон индекса, чтобы автоматически настроить индексы, созданные во время переноса. Если вы переносите алиас индекса, вы используете API переноса для добавления дополнительных настроек индекса или перезаписи настроек в шаблоне. Потоки данных не поддерживают параметр settings.

POST my-alias/_rollover
{
  "settings": {
    "index.number_of_shards": 2
  }
}