Явное (явное) описание структуры данных

Вы знаете больше о своих данных, чем Elasticsearch может предположить, поэтому, хотя динамическое описание структуры данных может быть полезно для начала, в какой-то момент вам захочется указать свои явные описания.

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

Вы можете использовать API создания индекса для создания нового индекса с явным описанием структуры данных.

PUT /my-index-000001
{
  "mappings": {
    "properties": {
      "age":    { "type": "integer" },  
      "email":  { "type": "keyword"  }, 
      "name":   { "type": "text"  }     
    }
  }
}

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

Следующий пример добавляет employee-id, поле типа keyword с параметром index со значением false. Это означает, что значения для поля employee-id хранятся, но не индексируются и недоступны для поиска.

PUT /my-index-000001/_mapping
{
  "properties": {
    "employee-id": {
      "type": "keyword",
      "index": false
    }
  }
}

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

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

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

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

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

GET /my-index-000001/_mapping

API возвращает следующий ответ:

{
  "my-index-000001" : {
    "mappings" : {
      "properties" : {
        "age" : {
          "type" : "integer"
        },
        "email" : {
          "type" : "keyword"
        },
        "employee-id" : {
          "type" : "keyword",
          "index" : false
        },
        "name" : {
          "type" : "text"
        }
      }
    }
  }
}

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

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

Следующий запрос получает описание структуры данных поля employee-id.

GET /my-index-000001/_mapping/field/employee-id

API возвращает следующий ответ:

{
  "my-index-000001" : {
    "mappings" : {
      "employee-id" : {
        "full_name" : "employee-id",
        "mapping" : {
          "employee-id" : {
            "type" : "keyword",
            "index" : false
          }
        }
      }
    }
  }
}