Модель данных¶

Настройки таблицы¶

Настройки таблицы включают в себя один параметр:

engine: memcs

где:

• engine – вид буферизации, строчная (движок обработки данных memtx) или колоночная (движок обработки данных memcs). По умолчанию для таблиц используется строчная буферизация (engine: memtx).

Описания колонок¶

Описания колонок вложены в элемент columns. Для каждой колонки можно задать следующие параметры:

columns:
  - name: id
    data_type: utf8
    column_values_limit: 100000
    indexed: true
    index_depth: 1000

где:

• name (обязательный) - название колонки;

• data_type (обязательный) – тип данных колонки. Возможные значения приведены в Типы данных.

• column_values_limit – максимальное количество хранимых одновременно значений колонки. При вставке значений выше указанного предела последние по порядку вставки значения выселяются (удаляются из базы данных).

  Если атрибут указан, его значение переопределяет default_column_values_limit для конкретной колонки.

  Колонки могут быть разной длины. Допустим, есть колонки:

  • Attribute0 с column_values_limit = 10000

  • Attribute1 с column_values_limit = 1000

  Если сделать вставку из 20 тысяч строк:

  • В колонке Attribute0 будет 10000 значений из последних 10000 вставленных строк.

  • В колонке Attribute1 будет 1000 значений из последних 1000 вставленных строк.

  То есть полностью прочитать можно только последнюю 1000 строк.

  Важно

  При изменении значения column_values_limit в меньшую сторону может потребоваться удаление большого количества данных. Такое удаление приводит к выделению значительного количества оперативной памяти под временное хранение данных, что негативно сказывается на производительности. Для того чтобы не загружать оперативную память, рекомендуется запускать скрипт evict_overflowing_blocks.lua, который корректно удаляет лишние записи и не требует много памяти для временного хранения данных.

• indexed – наличие индекса key-value по колонке. Значение по умолчанию: false.

• index_depth – глубина индекса, то есть предельное количество проиндексированных записей, по которым может быть выполнен быстрый поиск. Значение null (как и не указанный параметр index_depth) означает, что размер индекса не ограничен.

  Важно

  • Нельзя указывать значение index_depth равное 0: это приведет к ошибке при загрузке конфигурации.

  • Для неиндексируемых колонок параметр index_depth не имеет смысла, его можно не указывать. Но если он указан, то его значение также не должно быть равным 0 (допустимо значение null или больше нуля).

  Примечание

  При необходимости в SELECT-запросе с выборкой по индексу можно использовать функцию not_indexed() и таким образом получить даже те данные, которые вышли за глубину индексации.

Десятичное число с фиксированной точкой¶

Типы данных decimal128 и decimal256 имеют обязательный параметр scale (масштаб), определяющий количество цифр после десятичной точки. При создании таблиц TCS автоматически приводит указанную точность (precision) к одному из двух поддерживаемых вариантов:

• Любая точность в диапазоне [1, 38] будет приведена к 38 (decimal128).

• Любая точность в диапазоне [39, 76] будет приведена к 76 (decimal256).

Установлены следующие ограничения к масштабу и точности:

• Масштаб (scale) должен быть неотрицательным числом и не может превышать точность (precision).

• Точность (precision) должна быть в диапазоне [1, 76].

• Если у значения дробная часть длиннее масштаба колонки, лишние цифры просто отбрасываются (без округления).

При выполнении инструкции CREATE TABLE для указания типа данных decimal можно использовать псевдонимы. Псевдоним decimal128(scale) эквивалентен decimal(38, scale). Псевдоним decimal256(scale) эквивалентен decimal(76, scale). Однако в других контекстах, например, для приведения типов, используйте полное определение decimal(precision, scale).

При использовании подготовленных выражений явное приведение типов не требуется:

CREATE TABLE table3 (a decimal128(4));

PREPARE filter_le(decimal(38, 4)) AS SELECT * FROM table3 WHERE a <= $1;

EXECUTE filter_le('3.1415');