box.schema.sequence.create()

box.schema.sequence.create(name[, options])¶

Создание нового генератора последовательностей.

Параметры:	name (string) – имя последовательности options (table) – см. краткий обзор в таблице «Параметры для box.schema.sequence.create()» (в разделе Последовательности главы «Модель данных»), а более подробную информацию ниже.
возвращает:	ссылка на новый объект последовательности.

Параметры:

• start – НАЧАЛЬНОЕ значение. Тип = целое число, по умолчанию = 1.

• min – МИНИМАЛЬНОЕ значение. Тип = целое число, по умолчанию = 1.

• max –МАКСИМАЛЬНОЕ значение. Тип = целое число, по умолчанию = 9223372036854775807.

  Есть следующее правило: min <= start <= max. Например, нельзя указать {start=0}, поскольку указанное начальное значение (0) будет меньше, чем минимальное значение, используемое по умолчанию (1).

  Есть следующее правило: min <= следующее-значение <= max. Например, если сгенерированное значение будет 1000, но максимальное значение – 999, это будет считаться переполнением.

  There is a rule: start and min and max must all be <= 9223372036854775807 which is 2^63 - 1 (not 2^64).

• cycle – значение ЦИКЛА. Тип = bool (логический), по умолчанию = false (ложь).

  Если следующее значение в генераторе последовательности будет переполнением, это вызовет ошибку – не считая случаев, когда задан цикл (cycle == true).

  Если же cycle == true, отсчет начинается заново с МИНИМАЛЬНОГО значения или с МАКСИМАЛЬНОГО значения (не с НАЧАЛЬНОГО значения).

• cache – значение КЭША. Тип = беззнаковое целое число, по умолчанию = 0.

  В данный момент Tarantool игнорирует это значение, оно зарезервировано для последующего использования.

• step – значение УВЕЛИЧЕНИЯ. Тип = целое число, по умолчанию = 1.

  Это значение прибавляется к предыдущему.