API обновления схемы

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

PUT /publications

Следующий запрос API обновления сопоставления добавляет title, новое поле типа text, в индекс publications.

PUT /publications/_mapping
{
  "properties": {
    "title":  { "type": "text"}
  }
}

API обновления сопоставления может применяться к нескольким потокам данных или индексам с помощью одного запроса. Например, вы можете обновить сопоставления для индексов my-index-000001 и my-index-000002 одновременно:

# Create the two indices
PUT /my-index-000001
PUT /my-index-000002

# Update both mappings
PUT /my-index-000001,my-index-000002/_mapping
{
  "properties": {
    "user": {
      "properties": {
        "name": {
          "type": "keyword"
        }
      }
    }
  }
}

Вы можете использовать API обновления сопоставления для добавления новых свойств к существующему полю типа object. Чтобы увидеть, как это работает, попробуйте следующий пример.

Используйте API создания индекса для создания индекса с объектным полем name и внутренним текстовым полем first.

PUT /my-index-000001
{
  "mappings": {
    "properties": {
      "name": {
        "properties": {
          "first": {
            "type": "text"
          }
        }
      }
    }
  }
}

Используйте API обновления сопоставления для добавления нового внутреннего текстового поля last к полю name.

PUT /my-index-000001/_mapping
{
  "properties": {
    "name": {
      "properties": {
        "last": {
          "type": "text"
        }
      }
    }
  }
}

Многополя позволяют индексировать одно и то же поле различными способами. Вы можете использовать API обновления сопоставления для обновления параметра сопоставления fields и включения многополей для существующего поля.

Чтобы увидеть, как это работает, попробуйте следующий пример.

Используйте API создания индекса для создания индекса с текстовым полем city.

PUT /my-index-000001
{
  "mappings": {
    "properties": {
      "city": {
        "type": "text"
      }
    }
  }
}

Хотя текстовые поля хорошо подходят для полнотекстового поиска, поля типа keyword не анализируются и могут лучше подходить для сортировки или агрегаций.

Используйте API обновления сопоставления для включения многополя для поля city. Этот запрос добавляет многополе city.raw типа keyword, которое можно использовать для сортировки.

PUT /my-index-000001/_mapping
{
  "properties": {
    "city": {
      "type": "text",
      "fields": {
        "raw": {
          "type": "keyword"
        }
      }
    }
  }
}

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

Чтобы увидеть, как это работает, попробуйте следующий пример.

Используйте API создания индекса для создания индекса, содержащего поле user_id типа keyword. У поля user_id параметр ignore_above имеет значение 20.

PUT /my-index-000001
{
  "mappings": {
    "properties": {
      "user_id": {
        "type": "keyword",
        "ignore_above": 20
      }
    }
  }
}

Используйте API обновления сопоставления для изменения значения параметра ignore_above на 100.

PUT /my-index-000001/_mapping
{
  "properties": {
    "user_id": {
      "type": "keyword",
      "ignore_above": 100
    }
  }
}

За исключением поддерживаемых параметров сопоставления параметров сопоставления, вы не можете изменить сопоставление или тип поля существующего поля. Изменение существующего поля может привести к недействительным данным, которые уже проиндексированы.

Если вам нужно изменить сопоставление поля в базовых индексах потока данных, см. Изменение сопоставлений и настроек для потока данных.

Если вам нужно изменить сопоставление поля в других индексах, создайте новый индекс с правильным сопоставлением и переиндексируйте ваши данные в этот индекс.

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

Используйте API создания индекса для создания индекса с полем user_id типа long.

PUT /my-index-000001
{
  "mappings" : {
    "properties": {
      "user_id": {
        "type": "long"
      }
    }
  }
}

Используйте API индексации для индексирования нескольких документов со значениями поля user_id.

POST /my-index-000001/_doc?refresh=wait_for
{
  "user_id" : 12345
}

POST /my-index-000001/_doc?refresh=wait_for
{
  "user_id" : 12346
}

Чтобы изменить поле user_id на поле типа keyword, используйте API создания индекса для создания нового индекса с правильным сопоставлением.

PUT /my-new-index-000001
{
  "mappings" : {
    "properties": {
      "user_id": {
        "type": "keyword"
      }
    }
  }
}

Используйте API переиндексации для копирования документов из старого индекса в новый.

POST /_reindex
{
  "source": {
    "index": "my-index-000001"
  },
  "dest": {
    "index": "my-new-index-000001"
  }
}

Переименование поля сделает недействительными данные, уже проиндексированные под старым именем поля. Вместо этого добавьте поле alias для создания альтернативного имени поля.

Например, используйте API создания индекса для создания индекса с полем user_identifier.

PUT /my-index-000001
{
  "mappings": {
    "properties": {
      "user_identifier": {
        "type": "keyword"
      }
    }
  }
}

Используйте API обновления сопоставления для добавления псевдонима поля user_id для существующего поля user_identifier.

PUT /my-index-000001/_mapping
{
  "properties": {
    "user_id": {
      "type": "alias",
      "path": "user_identifier"
    }
  }
}