Изменение топика

С помощью подкоманды topic alter вы можете изменить созданный ранее топик.

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

ydb [global options...] topic alter [options...] <topic-path>

Посмотрите описание команды изменения топика:

ydb topic alter --help

Параметры подкоманды

При исполнении команды будут изменены значения тех параметров, которые заданы в командной строке. Значения остальных параметров останутся без изменений.

Имя Описание
--partitions-count Количество партиций топика. Возможно только увеличение количества партиций.
--retention-period-hours Время хранения данных в топике, задается в часах.
--partition-write-speed-kbps Максимальная скорость записи в партицию, задается в КБ/с.
Значение по умолчанию — 1024.
--retention-storage-mb Максимальный объем хранения, задается в МБ. При достижении ограничения будут удаляться самые старые данные.
Значение по умолчанию — 0 (ограничение не задано).
--supported-codecs Поддерживаемые методы сжатия данных.
Возможные значения:
  • RAW — без сжатия;
  • ZSTD — сжатие zstd;
  • GZIP — сжатие gzip;
  • LZOP — сжатие lzop.
--metering-mode Режим тарификации топика для serverless базы данных.
Возможные значения:
  • request-units — по фактическому использованию.
  • reserved-capacity — по выделенным ресурсам.

Примеры

Примечание

В примерах используется профиль quickstart, подробнее смотрите в Создание профиля для соединения с тестовой БД.

Добавьте партицию и метод сжатия lzop созданному ранее топику:

ydb -p quickstart topic alter \
  --partitions-count 3 \
  --supported-codecs raw,gzip,lzop \
  my-topic

Убедитесь, что параметры топика изменились:

ydb -p quickstart scheme describe my-topic

Результат:

RetentionPeriod: 2 hours
PartitionsCount: 3
SupportedCodecs: RAW, GZIP, LZOP