Создание топика

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

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

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

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

ydb topic create --help

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

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

Примеры

Примечание

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

Создание топика с 2 партициями, методами сжатия RAW и GZIP, временем хранения сообщений 2 часа и путем my-topic:

ydb -p db1 topic create \
  --partitions-count 2 \
  --supported-codecs raw,gzip \
  --retention-period-hours 2 \
  my-topic

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

ydb -p db1 scheme describe my-topic

Результат:

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