Числовые типы полей

Что касается целочисленных типов (byte, short, integer и long), вы должны выбрать наименьший тип, который достаточно для вашего случая использования. Это поможет сделать индексирование и поиск более эффективными. Обратите внимание, что хранение оптимизировано на основе фактических хранимых значений, поэтому выбор одного типа вместо другого не повлияет на требования к хранению.

Для типов с плавающей запятой часто более эффективно хранить данные с плавающей запятой в виде целых чисел с помощью коэффициента масштабирования, что и делает тип scaled_float под капотом. Например, поле price можно хранить в поле типа scaled_float с коэффициентом масштабирования scaling_factor равным 100. Все API будут работать так, как если бы поле хранилось как double, но под капотом Elasticsearch будет работать с количеством центов, price*100, которое является целым числом. Это в основном помогает экономить дисковое пространство, так как целые числа гораздо легче сжимаются, чем числа с плавающей запятой. scaled_float также хорошо использовать, чтобы пожертвовать точностью ради места на диске. Например, представьте, что вы отслеживаете использование ЦП как число между 0 и 1. Обычно не имеет большого значения, является ли использование ЦП 12.7% или 13%, поэтому можно использовать scaled_float с коэффициентом масштабирования scaling_factor равным 100, чтобы округлить использование ЦП до ближайшего процента, чтобы сэкономить место.

Если scaled_float не подходит, то следует выбрать наименьший тип, который достаточно для данного случая использования, среди типов с плавающей запятой: double, float и half_float. Вот таблица, которая сравнивает эти типы, чтобы помочь принять решение.

scaled_float принимает дополнительный параметр:

scaled_float хранится как одно long значение, которое является произведением исходного значения и множителя масштабирования. Если результат умножения выходит за пределы диапазона long, значение насыщается до минимального или максимального значения long. Например, если множитель масштабирования равен 100, а значение равно 92233720368547758.08, ожидаемое значение равно 9223372036854775808. Однако хранимое значение равно 9223372036854775807, максимальному значению для long.

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

Все числовые поля поддерживают синтетические _source в их конфигурации по умолчанию. Синтетические _source нельзя использовать вместе с copy_to или с отключенным doc_values.

Синтетический источник может сортировать числовые значения поля. Например:

resp = client.indices.create(
    index="idx",
    settings={
        "index": {
            "mapping": {
                "source": {
                    "mode": "synthetic"
                }
            }
        }
    },
    mappings={
        "properties": {
            "long": {
                "type": "long"
            }
        }
    },
)
print(resp)

resp1 = client.index(
    index="idx",
    id="1",
    document={
        "long": [
            0,
            0,
            -123466,
            87612
        ]
    },
)
print(resp1)

const response = await client.indices.create({
  index: "idx",
  settings: {
    index: {
      mapping: {
        source: {
          mode: "synthetic",
        },
      },
    },
  },
  mappings: {
    properties: {
      long: {
        type: "long",
      },
    },
  },
});
console.log(response);

const response1 = await client.index({
  index: "idx",
  id: 1,
  document: {
    long: [0, 0, -123466, 87612],
  },
});
console.log(response1);

PUT idx
{
  "settings": {
    "index": {
      "mapping": {
        "source": {
          "mode": "synthetic"
        }
      }
    }
  },
  "mappings": {
    "properties": {
      "long": { "type": "long" }
    }
  }
}
PUT idx/_doc/1
{
  "long": [0, 0, -123466, 87612]
}

Превратится в:

{
  "long": [-123466, 0, 0, 87612]
}

Масштабированные числа с плавающей точкой всегда применяют свой множитель масштабирования, поэтому:

resp = client.indices.create(
    index="idx",
    settings={
        "index": {
            "mapping": {
                "source": {
                    "mode": "synthetic"
                }
            }
        }
    },
    mappings={
        "properties": {
            "f": {
                "type": "scaled_float",
                "scaling_factor": 0.01
            }
        }
    },
)
print(resp)

resp1 = client.index(
    index="idx",
    id="1",
    document={
        "f": 123
    },
)
print(resp1)

const response = await client.indices.create({
  index: "idx",
  settings: {
    index: {
      mapping: {
        source: {
          mode: "synthetic",
        },
      },
    },
  },
  mappings: {
    properties: {
      f: {
        type: "scaled_float",
        scaling_factor: 0.01,
      },
    },
  },
});
console.log(response);

const response1 = await client.index({
  index: "idx",
  id: 1,
  document: {
    f: 123,
  },
});
console.log(response1);

PUT idx
{
  "settings": {
    "index": {
      "mapping": {
        "source": {
          "mode": "synthetic"
        }
      }
    }
  },
  "mappings": {
    "properties": {
      "f": { "type": "scaled_float", "scaling_factor": 0.01 }
    }
  }
}
PUT idx/_doc/1
{
  "f": 123
}

Превратится в:

{
  "f": 100.0
}