API получения отображения полей

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

PUT /publications
{
  "mappings": {
    "properties": {
      "id": { "type": "text" },
      "title": { "type": "text" },
      "abstract": { "type": "text" },
      "author": {
        "properties": {
          "id": { "type": "text" },
          "name": { "type": "text" }
        }
      }
    }
  }
}

Следующий запрос возвращает отображение поля title:

GET publications/_mapping/field/title

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

{
   "publications": {
      "mappings": {
          "title": {
             "full_name": "title",
             "mapping": {
                "title": {
                   "type": "text"
                }
             }
          }
       }
   }
}

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

Например, чтобы выбрать id поля author, необходимо использовать его полное имя author.id.

GET publications/_mapping/field/author.id,abstract,name

возвращает:

{
   "publications": {
      "mappings": {
        "author.id": {
           "full_name": "author.id",
           "mapping": {
              "id": {
                 "type": "text"
              }
           }
        },
        "abstract": {
           "full_name": "abstract",
           "mapping": {
              "abstract": {
                 "type": "text"
              }
           }
        }
     }
   }
}

API получения отображения полей также поддерживает подстановку.

GET publications/_mapping/field/a*

возвращает:

{
   "publications": {
      "mappings": {
         "author.name": {
            "full_name": "author.name",
            "mapping": {
               "name": {
                 "type": "text"
               }
            }
         },
         "abstract": {
            "full_name": "abstract",
            "mapping": {
               "abstract": {
                  "type": "text"
               }
            }
         },
         "author.id": {
            "full_name": "author.id",
            "mapping": {
               "id": {
                  "type": "text"
               }
            }
         }
      }
   }
}

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

Параметры пути <target> и <field> оба поддерживают списки, разделенные запятыми, и выражения с подстановкой.

Вы можете опустить параметр <target> или использовать значение * или _all для определения всех потоков данных и индексов в кластере.

Аналогично, вы можете опустить параметр <field> или использовать значение * для извлечения отображений всех полей в целевых потоках данных или индексах. Однако параметр <field> не поддерживает значение _all.

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

GET /my-index-000001,my-index-000002/_mapping/field/message

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

GET /_all/_mapping/field/message

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

GET /_all/_mapping/field/*.id