---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://ydb.tech/docs/en/reference/ydb-cli/table-ttl-set.md?version=main
  - https://ydb.tech/docs/ru/reference/ydb-cli/table-ttl-set.md?version=main
sourcePath: ru/core/reference/ydb-cli/table-ttl-set.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Установка параметров TTL

С помощью подкоманды `table ttl set` вы можете установить [TTL](https://ydb.tech/docs/ru/concepts/ttl.md?version=main) для указанной таблицы.

Общий вид команды:

```bash
ydb [global options...] table ttl set [options...] <table path>
```

* `global options` — [глобальные параметры](https://ydb.tech/docs/ru/reference/ydb-cli/commands/global-options.md?version=main).
* `options` — [параметры подкоманды](#options).
* `table path` — путь таблицы.

Посмотрите описание команды установки TTL:

```bash
ydb table ttl set --help
```

## Параметры подкоманды {#options}

Имя | Описание
---|---
`--column` | Имя колонки, которая будет использована для вычисления времени жизни строк. Колонка должна иметь тип [числовой](../../yql/reference/types/primitive.md#numeric) или [дата и время](../../yql/reference/types/primitive.md#datetime).<br/>В случае числового типа значение будет интерпретироваться как время, прошедшее с начала [эпохи Unix](https://ru.wikipedia.org/wiki/Unix-время). Единицы измерения должны быть заданы в параметре `--unit`.
`--expire-after` | Дополнительное время до удаления, которое должно пройти после истечения времени жизни строки. Указывается в секундах.<br/>Значение по умолчанию — `0`.
`--unit` | Единицы измерения значений колонки, которая указана в параметре `--column`. Обязателен, если колонка имеет [числовой](../../yql/reference/types/primitive.md#numeric) тип.<br/>Возможные значения:<ul><li>`seconds (s, sec)` — секунды;</li><li>`milliseconds (ms, msec)` — миллисекунды;</li><li>`microseconds (us, usec)` — микросекунды;</li><li>`nanoseconds (ns, nsec)` — наносекунды.</li></ul>
`--run-interval` | Интервал запуска операции удаления строк с истекшим TTL. Указывается в секундах. Наименьший допустимый интервал составляет 15 минут (900 секунд). Значение по умолчанию (`3600`) оптимально для старта работы с таблицей с установленным TTL.<br/><br/>При выборе значения `--run-interval` важно учитывать баланс между задержкой удаления просроченных данных и дополнительной нагрузкой на кластер. Слишком маленький интервал приводит к частому запуску фоновых задач удаления и может заметно увеличить нагрузку на CPU и I/O, особенно при большом объёме данных. Слишком большой интервал, наоборот, задерживает физическое удаление строк: просроченные данные дольше занимают место на диске и могут продолжать участвовать в сканированиях.<br/><br/>При любом значении `--run-interval` следует ожидать, что на запрос к таблице могут вернуться строки с истекшим `TTL`.

## Примеры {examples}

<!-- source: ru/_includes/ydb-cli-profile.md -->
{% note info %}

В примерах используется профиль `quickstart`, подробнее смотрите в [Создание профиля для соединения с тестовой БД](https://ydb.tech/docs/ru/reference/ydb-cli/profile/create.md?version=main#quickstart).

{% endnote %}
<!-- endsource: ru/_includes/ydb-cli-profile.md -->

Установите TTL для таблицы `series`

```bash
ydb -p quickstart table ttl set \
  --column createtime \
  --expire-after 3600 \
  --run-interval 1200 \
  series
```