---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/reference/ydb-cli/topic-consumer-offset-commit.md?version=v25.4
  - https://ydb.tech/docs/ru/reference/ydb-cli/topic-consumer-offset-commit.md?version=v25.4
  - href: ru/reference/ydb-cli/topic-consumer-offset-commit.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: ru/core/reference/ydb-cli/topic-consumer-offset-commit.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/ru/llms.txt

# Сохранение позиции чтения

Каждый писатель топика обладает [позицией чтения](https://ydb.tech/docs/ru/concepts/datamodel/topic.md?version=v25.4#consumer-offset).

С помощью команды `topic consumer offset commit` можно сохранить позицию чтения [добавленного ранее](https://ydb.tech/docs/ru/reference/ydb-cli/topic-consumer-add.md?version=v25.4) читателя.

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

```bash
ydb [global options...] topic consumer offset commit [options...] <topic-path>
```

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

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

```bash
ydb topic consumer offset commit --help
```

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

Имя | Описание
---|---
`--consumer <значение>` | Имя читателя.
`--partition <значение>` | Номер партиции.
`--offset <значение>` | Устанавливаемое значение смещения.

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

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

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

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

Установить для читателя с именем `my-consumer` смещение 123456789 в топике `my-topic` и партиции `1`:

```bash
ydb -p db1 topic consumer offset commit \
  --consumer my-consumer \
  --partition 1 \
  --offset 123456789 \
  my-topic
```