Обработчик расширения точек

Расширяет поле с точками в поле объекта. Этот обработчик позволяет обращаться к полям с точками в имени другими обработчиками в конвейере. В противном случае к этим полям не может обратиться ни один обработчик.

{
  "dot_expander": {
    "field": "foo.bar"
  }
}

Например, обработчик расширения точек преобразует этот документ:

{
  "foo.bar" : "value"
}

в:

{
  "foo" : {
    "bar" : "value"
  }
}

Если уже существует поле bar, вложенное под foo, то этот обработчик объединяет поле foo.bar в него. Если поле является скалярным значением, то оно преобразуется в поле массива.

Например, следующий документ:

{
  "foo.bar" : "value2",
  "foo" : {
    "bar" : "value1"
  }
}

преобразуется обработчиком dot_expander в:

{
  "foo" : {
    "bar" : ["value1", "value2"]
  }
}

В отличие от ситуации, когда опция override установлена в true.

{
  "dot_expander": {
    "field": "foo.bar",
    "override": true
  }
}

В этом случае значение расширенного поля перезаписывает значение вложенного объекта.

{
  "foo" : {
    "bar" : "value2"
  }
}

Значение field также может быть установлено в *, чтобы расширить все имена полей с точками верхнего уровня:

{
  "dot_expander": {
    "field": "*"
  }
}

Обработчик расширения точек преобразует этот документ:

{
  "foo.bar" : "value",
  "baz.qux" : "value"
}

в:

{
  "foo" : {
    "bar" : "value"
  },
  "baz" : {
    "qux" : "value"
  }
}

Если поле с точками вложено в структуру без точек, используйте опцию path для навигации по структуре без точек:

{
  "dot_expander": {
    "path": "foo"
    "field": "*"
  }
}

Обработчик расширения точек преобразует этот документ:

{
  "foo" : {
    "bar.one" : "value",
    "bar.two" : "value"
  }
}

в:

{
  "foo" : {
    "bar" : {
      "one" : "value",
      "two" : "value"
    }
  }
}

Если любое поле вне поля-листа конфликтует с существующим полем с тем же именем, это поле необходимо переименовать предварительно.

Рассмотрим следующий документ:

{
  "foo": "value1",
  "foo.bar": "value2"
}

Затем поле foo необходимо переименовать перед применением обработчика dot_expander. Для того, чтобы поле foo.bar правильно расширилось в поле bar под полем foo, необходимо использовать следующий конвейер:

{
  "processors" : [
    {
      "rename" : {
        "field" : "foo",
        "target_field" : "foo.bar"
      }
    },
    {
      "dot_expander": {
        "field": "foo.bar"
      }
    }
  ]
}

Причина в том, что Ingest не знает, как автоматически преобразовать скалярное поле в поле объекта.