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

С помощью подкоманды 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`. Возможные значения: `RAW` — без сжатия; `ZSTD` — сжатие zstd; `GZIP` — сжатие gzip; `LZOP` — сжатие lzop.
`--metering-mode`	Режим тарификации топика для serverless базы данных. Возможные значения: `request-units` — по фактическому использованию. `reserved-capacity` — по выделенным ресурсам.

Примечание

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

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

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

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

ydb -p quickstart scheme describe my-topic

Результат:

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