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

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

С помощью подкоманды `topic alter` вы можете изменить [созданный ранее](https://ydb.tech/docs/ru/reference/ydb-cli/topic-create.md) топик.

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

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

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

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

```bash
ydb topic alter --help
```

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

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

Имя | Описание
---|---
`--partitions-count`| Количество [партиций](../../concepts/datamodel/topic.md#partitioning) топика. Возможно только увеличение количества партиций.
`--retention-period` | Время хранения данных в топике. Положительное число с указанием единицы измерения.<br/>Поддерживаются следующие единицы:<ul><li>`s` – секунды;</li><li>`m` – минуты;</li><li>`h` – часы;</li><li>`d` – дни.</li></ul>
`--partition-write-speed-kbps` | Максимальная скорость записи в [партицию](../../concepts/datamodel/topic.md#partitioning), задается в КБ/с.<br/>Значение по умолчанию — `1024`.
`--retention-storage-mb` | Максимальный объем хранения для топика, задается в МБ. При достижении ограничения будут удаляться самые старые данные. При включенном автоматическом партиционировании потребляемое место может превышать установленное значение.<br/>Значение по умолчанию — `0` (ограничение не задано).
`--supported-codecs` | Поддерживаемые методы сжатия данных.<br/>Возможные значения:<ul><li>`RAW` — без сжатия;</li><li>`ZSTD` — сжатие [zstd](https://ru.wikipedia.org/wiki/Zstandard);</li><li>`GZIP` — сжатие [gzip](https://ru.wikipedia.org/wiki/Gzip);</li><li>`LZOP` — сжатие [lzop](https://ru.wikipedia.org/wiki/Lzop).</li></ul>
`--metering-mode` | Режим тарификации топика для serverless базы данных.<br/>Возможные значения:<ul><li>`request-units` — по фактическому использованию.</li><li>`reserved-capacity` — по выделенным ресурсам.</li></ul>

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

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

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

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

Добавьте партицию и метод сжатия `lzop` [созданному ранее](https://ydb.tech/docs/ru/reference/ydb-cli/topic-create.md) топику:

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

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

```bash
ydb -p quickstart scheme describe my-topic
```

Результат:

```text
RetentionPeriod: 2h
PartitionsCount: 3
SupportedCodecs: RAW, GZIP, LZOP
```