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

# Список изменений YDB CLI

## Версия 2.31.0 {#2-31-0}

Дата выхода 20 апреля 2026. Для обновления до версии **2.31.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена опция `--stats` в [команды](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload * run`, позволяющая включить сбор расширенной статистики выполнения (например, `--stats profile`).

## Версия 2.30.0 {#2-30-0}

Дата выхода 7 апреля 2026. Для обновления до версии **2.30.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена команда `ydb config completion` для генерации скриптов автодополнения команд для bash и zsh.
* Добавлены команды `ydb export nfs` и `ydb import nfs`, позволяющие создавать и восстанавливать резервные копии непосредственно в/из общей NFS-директории, примонтированной на каждом хосте кластера.
* Добавлена опция `--compact` в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/workload-tpcc.md?version=v25.4) `ydb workload tpcc import`.
* Добавлена опция `--tx-mode` в [команды](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload * run`, позволяющая задать режим транзакции (например, `no-tx`, `serializable-rw`, `snapshot-rw`).
* Добавлена поддержка новой операции [компакшна](https://ydb.tech/docs/ru/concepts/glossary.md?version=v25.4#compaction) в [подкомандах](https://ydb.tech/docs/ru/reference/ydb-cli/operation-list.md?version=v25.4) `ydb operation`.

### Улучшения

* При явном указании [профиля](https://ydb.tech/docs/ru/reference/ydb-cli/profile/index.md?version=v25.4) с помощью опции `-p`/`--profile` активный профиль больше не используется: все параметры берутся только из указанного профиля, переменных окружения и командной строки. Это устраняет путаницу, когда выбранный профиль неожиданно дополнялся настройками из активного профиля.

## Версия 2.29.0 {#2-29-0}

Дата выхода 11 февраля 2026. Для обновления до версии **2.29.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Улучшения [интерактивного режима](https://ydb.tech/docs/ru/reference/ydb-cli/interactive-cli.md?version=v25.4) `ydb`:
  * Добавлена команда `/help` для получения справки по командам интерактивного режима.
  * Добавлена команда `/config`, предоставляющая интерактивный диалог для просмотра и изменения параметров YDB CLI:
    * Включение/выключение подсказок автодополнения.
    * Включение/выключение цветного вывода.
    * Интерактивный выбор цветовой темы из набора предустановленных вариантов с возможностью клонирования и настройки собственной темы.
* Добавлен прогресс-бар загрузки в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/commands/service.md?version=v25.4) `ydb update`.
* Добавлена опция `--include-index-data` в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/export-s3.md?version=v25.4) `ydb export s3`, позволяющая экспортировать данные индексов.
* Добавлена опция `--index-population-mode` в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-s3.md?version=v25.4) `ydb import s3`, позволяющая выбрать режим наполнения индекса (например, `build` или `import`).
* Добавлены поля `Created by`, `Create time` и `End time` для операций "build index" и "execute script" в [подкомандах](https://ydb.tech/docs/ru/reference/ydb-cli/operation-list.md?version=v25.4) `ydb operation`.
* Добавлена поддержка единого формата временных интервалов во всех командах YDB CLI. Опции, принимающие временные интервалы, теперь поддерживают явное указание единиц времени (например, `5s`, `2m`, `1h`) с сохранением обратной совместимости с числовыми значениями без суффикса, которые интерпретируются в исходных единицах по умолчанию.
* В описании семейств столбцов [команды](https://ydb.tech/docs/ru/reference/ydb-cli/commands/scheme-describe.md?version=v25.4) `ydb scheme describe` устаревшее поле "Keep in memory" заменено на "Cache mode".

### Улучшения

* Улучшены [команды](https://ydb.tech/docs/ru/reference/ydb-cli/profile/index.md?version=v25.4) `ydb init` и `ydb config profile` с добавлением интерактивных меню.
* Улучшены прогресс-бары: единообразные единицы MiB/GiB, стабильное отображение скорости, двойной прогресс-бар для [команды](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4) `ydb import file`, показывающий как отправленные, так и подтверждённые байты.

### Исправления ошибок

* Исправлена ошибка Out Of Memory в [команде](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload query run` при выполнении запросов с большими наборами результатов.
* Исправлен разбор параметров аутентификации по логину и паролю: пароль из [профиля](https://ydb.tech/docs/ru/reference/ydb-cli/profile/index.md?version=v25.4) больше не используется, если имя пользователя получено из другого источника.

## Версия 2.28.0 {#2-28-0}

Дата выхода 19 декабря 2025. Для обновления до версии **2.28.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлены режимы транзакций `snapshot-ro` и `snapshot-rw` в опцию `--tx-mode` [команды](https://ydb.tech/docs/ru/reference/ydb-cli/table-query-execute.md?version=v25.4) `ydb table query execute`.
* Добавлена поддержка переменной окружения `NO_COLOR` для отключения ANSI-цветов в YDB CLI (см. [no-color.org](https://no-color.org/)).
* Добавлен простой прогресс-бар для неинтерактивного stderr.
* Добавлено свойство `omit-indexes` в опцию `--item` [команды](https://ydb.tech/docs/ru/reference/ydb-cli/tools-copy.md?version=v25.4) `ydb tools copy`, позволяющее копировать таблицы без индексов.
* Добавлена подкоманда `import files` в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload vector` для заполнения таблицы из CSV или Parquet файлов.
* Добавлена подкоманда `import generate` в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload vector` для заполнения таблицы случайными данными.
* **_(Требуется сервер v26.1+)_** Изменения в ранее добавленной команде `ydb admin cluster state fetch`:
  * Переименована в `ydb admin cluster diagnostics collect`.
  * Добавлена опция `--no-sanitize`, отключающая санитизацию и сохраняющая чувствительные данные в выводе.
  * Добавлена опция `--output` для указания пути к выходному файлу `.tar.bz2`.

### Исправления ошибок

* Исправлена ошибка, при которой [команда](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4) `ydb tools restore` могла аварийно завершаться с ошибкой `mutex lock failure (Invalid argument)` из-за внутреннего состояния гонки.
* Исправлено восстановление представлений (views), содержащих именованные выражения, и представлений, обращающихся к вторичным индексам, в [команде](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4) `ydb tools restore`.

## Версия 2.27.0 {#2-27-0}

Дата выхода 30 октября 2025. Для обновления до версии **2.27.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена опция `--exclude` в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-s3.md?version=v25.4) `ydb import s3`, позволяющая исключать схемные объекты из импорта по шаблону имени.
* Добавлена поддержка объектов типа [трансфер](https://ydb.tech/docs/ru/concepts/transfer.md?version=v25.4) при выполнении [команды](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-dump.md?version=v25.4) `ydb tools dump` и [команды](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4) `ydb tools restore`.
* Добавлена новая опция `--retention-period` в подкоманды `ydb topic`. Использование устаревшей опции `--retention-period-hours` не рекомендуется.
* В [команде](https://ydb.tech/docs/ru/reference/ydb-cli/topic-consumer-add.md?version=v25.4) `ydb topic consumer add` появилась новая опция `--availability-period`, которая переопределяет гарантию удержания для читателя.
* В [командах](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload vector` добавлены подкоманды `build-index` и `drop-index`.
* **_(Требуется сервер v26.1+)_** Добавлена команда `ydb admin cluster state fetch` для сбора информации о состоянии узлов кластера и метриках.

### Исправления ошибок

* Исправлена ошибка, из-за которой команда `ydb debug ping` аварийно завершалась.

## Версия 2.26.0 {#2-26-0}

Дата выхода 25 сентября 2025. Для обновления до версии **2.26.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлены опции `--no-merge` и `--no-cache` в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/commands/monitoring-healthcheck.md?version=v25.4) `ydb monitoring healthcheck`.
* Добавлена статистика времени компиляции запроса в [команды](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload * run`.
* Добавлена опция `--retries` в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4) `ydb tools restore`, позваляющая задать количество повторных попыток для каждого запроса загрузки данных.
* **_(Требуется сервер v25.4+)_** Добавлена опция `--replace-sys-acl` в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4) `ydb tools restore`, которая задаёт, нужно ли заменять ACL для системных объектов.

## Версия 2.25.0 {#2-25-0}

Дата выхода 1 сентября 2025. Для обновления до версии **2.25.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена финальная статистика выполнения в [команды](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload * run`.
* Добавлена опция `--start-offset` в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/topic-read.md?version=v25.4) `ydb topic read`, которая задаёт начальную позицию для чтения из выбранной партиции.
* **_(Требуется сервер v25.3+)_** Добавлен новый способ указания путей в [командах](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/export-s3.md?version=v25.4) `ydb export s3` и `ydb import s3` с новой опцией `--include` вместо опции `--item`.
* **_(Требуется сервер v25.3+)_** Добавлена поддержка функций шифрования в [командах](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/export-s3.md?version=v25.4) `ydb export s3` и `ydb import s3`.
* **_(Требуется сервер v25.3+)_** **_(Экспериментально)_** Добавлены [команды](https://ydb.tech/docs/ru/reference/ydb-cli/commands/bridge/index.md?version=v25.4) `ydb admin cluster bridge` для управления кластером в [режиме bridge](https://ydb.tech/docs/ru/concepts/bridge.md?version=v25.4): `list`, `switchover`, `failover`, `takedown`, `rejoin`.

### Улучшения

* Опции аутентификации по имени пользователя и паролю теперь обрабатываются независимо, что позволяет получать их из разных источников приоритета. Например, имя пользователя можно указать с помощью опции `--user`, а пароль получить из переменной окружения `YDB_PASSWORD`.
* Изменён уровень логирования по умолчанию с `EMERGENCY` на `WARN` для команд, поддерживающих несколько уровней логирования.

### Изменения с потерей обратной совместимости

* Удалена опция `--float-mode` из [команд](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload tpch run` и `ydb workload tpcds run`. Режим работы с вещественными числами теперь определяется автоматически из схемы таблицы, созданной во время фазы `init`.

### Исправления ошибок

* Исправлена ошибка, при которой [команда](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4) `ydb import file csv` с опцией `--newline-delimited` могла зависать при некорректных входных данных.
* Исправлена ошибка с отображением прогресс-бара в [команде](https://ydb.tech/docs/ru/reference/ydb-cli/workload-click-bench.md?version=v25.4) `ydb workload clickbench import files` — неправильное процентное значение и избыточные переносы строк, приводящие к дублированию строк прогресса.
* Исправлена ошибка, при которой [команда](https://ydb.tech/docs/ru/reference/ydb-cli/topic-write.md?version=v25.4) `ydb workload topic write` могла завершаться аварийно с ошибкой `Unknown AckedMessageId` из-за внутреннего состояния гонки.
* Исправлено сравнение десятичных типов в [командах](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload * run`.

## Версия 2.24.1 {#2-24-1}

Дата выхода 28 июля 2025. Для обновления до версии **2.24.1** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Исправления ошибок

* Исправлена ошибка, при которой [команда](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-dump.md?version=v25.4#schema-objects) `ydb tools dump` без уведомления пропускала объекты схемы неподдерживаемых типов и создавала для них пустые директории в целевой папке на файловой системе.

## Версия 2.24.0 {#2-24-0}

Дата выхода 23 июля 2025. Для обновления до версии **2.24.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена возможность для [команд](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload tpch` и `ydb workload tpcds` использовать опцию `--scale` c дробным значением, что позволяет задавать долю от полного объёма данных и нагрузки бенчмарка.
* Добавлена команда `ydb workload tpcc check` для проверки целостности данных TPC-C.

### Улучшения

* Тип хранения по умолчанию [в командах](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload * init` изменён на `column` (было `row`), а режим работы с датой и временем по умолчанию — на `datetime32` (было `datetime64`).

### Исправления ошибок

* Исправлена проблема, из-за которой [команда](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4) `ydb import file csv` могла зависать.

## Версия 2.23.0 {#2-23-0}

Дата выхода 16 июля 2025. Для обновления до версии **2.23.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена команда `ydb workload tpcc` для проведения нагрузочного тестирования TPC-C.
* Добавлена команда `ydb workload vector select` для тестирования производительности и полноты векторного индекса.
* Добавлена команда `ydb tools infer csv` для генерации SQL-запроса `CREATE TABLE` на основе CSV-файла с данными.

### Улучшения

* Расширена обработка специальных значений (`null`, `/dev/null`, `stdout`, `cout`, `console`, `stderr`, `cerr`) для опции `--output` в [командах](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload * run`.
* [Команды](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload` теперь работают с абсолютными путями до объектов схемы в базе данных.
* Улучшения в [интерактивном режиме выполнения запросов](https://ydb.tech/docs/ru/reference/ydb-cli/interactive-cli.md?version=v25.4) `ydb`:
  * Добавлена проверка соединения с сервером и описание горячих клавиш.
  * Улучшены inline-подсказки.
  * Добавлено автодополнение имён столбцов таблицы.
  * Добавлено кеширование схемы таблиц.

### Исправления ошибок

* Исправлена ошибка, из-за которой [команда](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4) `ydb tools restore` не работала на Windows.

## Версия 2.22.1 {#2-22-1}

Дата выхода 17 июня 2025. Для обновления до версии **2.22.1** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Исправления ошибок

* Исправлена ошибка, из-за которой сертификат не читался из файла, если путь к файлу указан в [профиле](https://ydb.tech/docs/ru/reference/ydb-cli/profile/index.md?version=v25.4) в поле `ca-file`.
* Исправлена ошибка, из-за которой [команды](https://ydb.tech/docs/ru/reference/ydb-cli/workload-click-bench.md?version=v25.4) `ydb workload query import` и `ydb workload clickbench import files` в состоянии отображали количество строк вместо количества байт.

## Версия 2.22.0 {#2-22-0}

Дата выхода 4 июня 2025. Для обновления до версии **2.22.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлено автодополнение имён схемных объектов в интерактивном режиме.
* Расширены возможности команды `ydb workload query`: добавлены команды `ydb workload query init`, `ydb workload query import` и `ydb workload query clean` и изменена команда `ydb workload query run`. Пользуясь ими можно инициализировать таблицы, заполнить их данными, провести нагрузочное тестирование и очистить данные за собой.
* В [команды](https://ydb.tech/docs/ru/reference/ydb-cli/workload-click-bench.md?version=v25.4) `ydb workload clickbench run`, `ydb workload tpch run`, `ydb workload tpcds run` добавлена опция `--threads`, позволяющая указывать количество потоков для отправки запросов.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Добавлена [команда](https://ydb.tech/docs/ru/reference/ydb-cli/commands/configuration/cluster/index.md?version=v25.4#list) `ydb admin cluster config version` для отображения версии конфигурации (V1/V2) на узлах.

### Изменения с потерей обратной совместимости

* Из команд [`ydb workload * run`](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) удалена опция `--executor`. Теперь всегда используется исполнитель `generic`.

### Исправления ошибок

* Исправлена ошибка, из-за которой команды [`ydb workload * clean`](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) удаляли все содержимое целевой директории, а не только таблицы, созданные командой init.

## Версия 2.21.0 {#2-21-0}

Дата выхода 22 мая 2024. Для обновления до версии **2.21.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлен [глобальный параметр](https://ydb.tech/docs/ru/reference/ydb-cli/commands/global-options.md?version=v25.4) `--no-discovery`, позволяющий пропустить процесс discovery и подключиться напрямую к указанному пользователем эндпоинту.
* Добавлены новые опции для команд нагрузочного тестирования:
  * Добавлена опция `--scale` в [команды](https://ydb.tech/docs/ru/reference/ydb-cli/workload-tpch.md?version=v25.4) `ydb workload tpch init` и `ydb workload tpcds init` для установки процента размера данных и нагрузки относительно максимальной нагрузки.
  * Добавлена опция `--retries` в [команды](https://ydb.tech/docs/ru/reference/ydb-cli/workload-click-bench.md?version=v25.4) `ydb workload <clickbench|tpch|tpcds> run` для указания максимального количества повторов каждого запроса.
  * Добавлена опция `--partition-size` в [команды](https://ydb.tech/docs/ru/reference/ydb-cli/workload-click-bench.md?version=v25.4) `ydb workload <clickbench|tpcds|tpch> init` для установки максимального размера партиции в мегабайтах для строчных таблиц.
  * Добавлены параметры диапазона дат (`--date-to`, `--date-from`) в операции `ydb workload log run` для поддержки равномерного распределения первичных ключей.
* Улучшена функциональность резервного копирования и восстановления:
  * Добавлены опции `--replace` и `--verify-existence` в [команду](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4#schema-objects) `ydb tools restore` для управления удалением существующих объектов, совпадающих с объектами в резервной копии, перед восстановлением.
  * Улучшена [команда](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-dump.md?version=v25.4#schema-objects) `ydb tools dump`: [таблицы-реплики](https://ydb.tech/docs/ru/concepts/async-replication.md?version=v25.4) у ASYNC REPLICATION и их [потоки изменений](https://ydb.tech/docs/ru/concepts/glossary.md?version=v25.4#changefeed) не сохраняются в локальные резервные копии. Это предотвращает дублирование потоков изменений и уменьшает размер резервной копии на диске.
* Изменения, повышающие удобство использования CLI:
  * Вывод подробной справки (`-hh`) теперь показывает всё дерево подкоманд.
  * Добавлена автоматическая вставка парных скобок в интерактивном режиме `ydb`.
  * Добавлена поддержка файлов с BOM (Byte Order Mark) в [командах](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4) `ydb import file`.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Улучшена команда `ydb debug latency`:
  * Добавлен параметр `--min-inflight` для установки минимального количества одновременных запросов (по умолчанию: 1).
  * Добавлена опция `--percentile` для указания пользовательских процентилей задержки.
  * Вывод команды расширен дополнительными измерениями GRPC ping.

### Исправления ошибок

* [Команда](https://ydb.tech/docs/ru/reference/ydb-cli/operation-get.md?version=v25.4) `ydb operation get` теперь корректно отображает операции, которые ещё находятся в процессе выполнения.
* Исправлены ошибки в [команде](https://ydb.tech/docs/ru/reference/ydb-cli/commands/dir.md?version=v25.4#rmdir) `ydb scheme rmdir`:
  * Исправлена ошибка, из-за которой команда пыталась удалить поддомены.
  * Исправлен порядок удаления: внешние таблицы теперь удаляются перед источниками данных из-за возможных зависимостей между ними.
  * Добавлена поддержка coordination nodes при рекурсивном удалении.
* Исправлен код возврата команды `ydb workload * run --check-canonical` при несовпадении результатов с каноническими.
* Исправлена проблема, когда CLI пытался читать параметры из stdin даже при отсутствии данных.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Исправлена ошибка авторизации при выполнении [команды](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4#db) `ydb admin database restore` при наличии нескольких учетных записей администраторов базы данных в восстанавливаемой резервной копии.

## Версия 2.20.0 {#2-20-0}

Дата выхода 5 марта 2024. Для обновления до версии **2.20.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена поддержка [топиков](https://ydb.tech/docs/ru/concepts/datamodel/topic.md?version=v25.4) при выполнении [команд](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-dump.md?version=v25.4) `ydb tools dump` и `ydb tools restore`.
* Добавлена поддержка [узлов координации](https://ydb.tech/docs/ru/concepts/datamodel/coordination-node.md?version=v25.4) при выполнении [команд](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-dump.md?version=v25.4) `ydb tools dump` и `ydb tools restore`.
* Добавлена новая команда `ydb workload log import generator`.
* Добавлены новые глобальные опции для пользовательских сертификатов при соединении через SSL/TLS:
  * `--client-cert-file`: файл, содержащий пользовательский сертификат для SSL/TLS соединения, закодированный в PEM или PKCS#12.
  * `--client-cert-key-file`: файл, содержащий приватный ключ к пользовательскому сертификату, закодированный в PEM.
  * `--client-cert-key-password-file`: файл, содержащий пароль для приватного ключа пользовательского сертификата.
* Запросы при выполнении команды `ydb workload run` теперь отправляются на сервер в произвольном порядке.
* **_(Требуется сервер v25.1+)_** Добавлена поддержка [внешних источников данных](https://ydb.tech/docs/ru/concepts/datamodel/external_data_source.md?version=v25.4) и [внешних таблиц](https://ydb.tech/docs/ru/concepts/datamodel/external_table.md?version=v25.4) при выполнении [команд](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-dump.md?version=v25.4) `ydb tools dump` и `ydb tools restore`.
* **_(Экспериментально)_** Добавлена команда `ydb admin node config init` для инициализации директории с конфигурационными файлами узла.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Добавлена [команда](https://ydb.tech/docs/ru/reference/ydb-cli/commands/configuration/cluster/generate.md?version=v25.4) `ydb admin cluster config generate` для генерации файла [конфигурации V2](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/index.md?version=v25.4) из [файла конфигурации V1](https://ydb.tech/docs/ru/devops/configuration-management/configuration-v2/index.md?version=v25.4).
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Добавлены [команда](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-dump.md?version=v25.4#cluster) `ydb admin cluster dump` и [команда](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4#cluster) `ydb admin cluster restore` для создания дампа кластера. Дамп кластера содержит список баз данных с метаданными, пользователей и группы, но не содержит схемные объекты.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Добавлены команды `ydb admin database dump` и `ydb admin database restore` для создания дампа базы данных. Такой дамп содержит метаданные базы данных, схемные объекты, данные в них, пользователей и группы.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Для команды `ydb admin cluster config fetch` добавлены новые опции `--dedicated-storage-section` и `--dedicated-cluster-section`, позволяющие получать части конфигурации для кластера и хранилища отдельно.

### Исправления ошибок

* Исправлена ошибка, из-за которой дважды отправлялся запрос аутентификации в команде `ydb auth get-token` при получении списка эндпойнтов (Discovery запрос) и при фактическом выполнении запроса на получение токена.
* Исправлена ошибка в команде `ydb import file csv`, при которой прогресс импорта сохранялся даже если отправка пакета данных завершилась ошибкой.
* Исправлена ошибка, из-за которой при выполнении команды `ydb tools restore` некоторые ошибки игнорировались.
* Исправлена утечка памяти при генерации данных для `ydb workload tpcds`.

## Версия 2.19.0 {#2-19-0}

Дата выхода 5 февраля 2025. Для обновления до версии **2.19.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена поддержка [потоков изменений (changefeeds)](https://ydb.tech/docs/ru/concepts/glossary.md?version=v25.4#changefeed) при выполнении [команд](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-dump.md?version=v25.4) `ydb tools dump` и `ydb tools restore`.
* Добавлена рекомендация с текстом `CREATE TABLE` при схемной ошибке во время выполнения [команды](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4) `ydb import file csv`.
* Добавлен вывод статистики для текущего процесса при выполнении [команды](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload`.
* Добавлен текст запроса к сообщению, если запрос завершился ошибкой при выполнении [команды](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload run`.
* Добавлено сообщение в случае ошибки истечения глобального таймаута при выполнении [команды](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload run`.


* **_(Требуется сервер v25.1+)_** Добавлена поддержка [представлений (VIEW)](https://ydb.tech/docs/ru/concepts/datamodel/view.md?version=v25.4) при выполнении операций `ydb export s3` и `ydb import s3`. Представления экспортируются как YQL-выражение `CREATE VIEW`, которое выполняется при импорте.


* **_(Требуется сервер v25.1+)_** Добавлена опция `--skip-checksum-validation` для [команды](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-s3.md?version=v25.4) `ydb import s3`, позволяющая отключить валидацию контрольной суммы на стороне сервера.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Для команды `ydb debug ping` добавлены новые опции: `--chain-length`, `--chain-work-duration`, `--no-tail-chain`.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Для команды `ydb admin storage fetch` добавлены новые опции: `--dedicated-storage-section` и `--dedicated-cluster-section`.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Для команды `ydb admin storage replace` добавлены новые опции: `--filename`, `--dedicated-cluster-yaml`, `--dedicated-storage-yaml`, `--enable-dedicated-storage-section` и `--disable-dedicated-storage-section`.

### Исправления ошибок

* Исправлена ошибка, из-за которой [команда](https://ydb.tech/docs/ru/reference/ydb-cli/commands/service.md?version=v25.4) `ydb update` в arm64-версии исполняемого файла YDB CLI скачивала и заменяла себя исполняемым файлом amd64-версии. Чтобы обновить ранее установленный YDB CLI до последней arm64-версии (а не amd64), его нужно переустановить.
* [Команда](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) `ydb workload run` теперь возвращает корректный код возврата.
* Исправлена ошибка, из-за которой [команды](https://ydb.tech/docs/ru/reference/ydb-cli/workload-tpch.md?version=v25.4) `ydb workload tpch import generator` и `ydb workload tpcds import generator` завершались с ошибкой из-за отсутствия необходимых таблиц в схеме.
* Исправлена ошибка с обратными слешами при указании путей в [команде]](./reference/ydb-cli/commands/workload/index.md) `ydb workload` на Windows.

## Версия 2.18.0 {#2-18-0}

Дата выхода 24 декабря 2024. Для обновления до версии **2.18.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена поддержка [представлений (VIEW)](https://ydb.tech/docs/ru/concepts/datamodel/view.md?version=v25.4) при выполнении операций резервного копирования `ydb tools dump` и восстановления `ydb tools restore`. Представления сохраняются в файл "create_view.sql" в виде запросов `CREATE VIEW`, которые будут выполнены для восстановления.
* В [команду](https://ydb.tech/docs/ru/reference/ydb-cli/workload-topic.md?version=v25.4#run-write) `ydb workload topic run` добавлены опции `--tx-commit-interval` и `--tx-commit-messages`, которые задают интервал между коммитами транзакций в миллисекундах и в количестве записанных сообщений соответственно.
* В [команде](https://ydb.tech/docs/ru/reference/ydb-cli/topic-read.md?version=v25.4) `ydb topic read` параметр `--consumer` перестал быть обязательным. В режиме чтения без подписчика обязательно должны быть указаны идентификаторы партиций с помощью параметра `--partition-ids`. Чтение в этом случае выполняется без сохранения коммита оффсетов.
* [Команда](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4) `ydb import file csv` теперь сохраняет прогресс выполнения. Повторный запуск команды импорта продолжится с той строки, на которой она была прервана.
* В командах `ydb workload kv` и `ydb workload stock` значение параметра `--executer` по умолчанию изменено на "generic", благодаря чему они больше не используют устаревшую инфраструктуру выполнения запросов.
* Изменен формат загрузки данных в таблицы для нагрузочных тестов `ydb workload` с CSV на Parquet.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Добавлена команда `ydb admin storage` с подкомандами `fetch` и `replace` для управления конфигурацией хранилища сервера.

### Изменения с потерей обратной совместимости

* В команде `ydb workload * run` параметр `--query-settings` заменен на `--query-prefix`.

### Исправления ошибок

* Исправлена ошибка, из-за которой команда `ydb workload * run` в режиме `--dry-run` могла приводить к сбою.
* Исправлена ошибка в `ydb import file csv`, из-за которой несколько столбцов с экранированными кавычками в одной строке обрабатывались неправильно.

## Версия 2.17.0 {#2-17-0}

Дата выхода 4 декабря 2024. Для обновления до версии **2.17.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Добавлена команда `ydb debug ping` для проверки производительности и связанности.

### Производительность

* Улучшена производительность [параллельного восстановления из файловой системы](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4) с помощью команды `ydb tools restore`.

### Исправления ошибок

* Исправлена ошибка в схеме таблиц, созданных командой `ydb workload tpch`, из-за которой таблица `partsupp` содержала неверный список ключевых столбцов.
* Исправлена ошибка, из-за которой команда `ydb tools restore` завершалась с ошибкой `Too much data`, если было установлено максимальное значение параметра `--upload-batchbytes` (16MB).

## Версия 2.16.0 {#2-16-0}

Дата выхода 26 ноября 2024. Для обновления до версии **2.16.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Увеличена пропускная способность команды `ydb import file csv` примерно в 3 раза.
* Добавлена поддержка [stock-нагрузки](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/stock.md?version=v25.4) для [колоночных таблиц](https://ydb.tech/docs/ru/concepts/datamodel/table.md?version=v25.4#column-oriented-tables).
* Реализована поддержка временных меток в формате [ISO 8601](https://ru.wikipedia.org/wiki/ISO_8601) для команд `ydb topic`.
* В команду `ydb sql` добавлена опция `--explain-ast`, которая выводит AST запроса.
* Добавлена подсветка синтаксиса ANSI SQL в интерактивном режиме.
* В команды `ydb workload tpch` и `ydb workload tpcds` добавлена поддержка синтаксиса PostgreSQL.
* В команду `ydb workload tpcds run` добавлена опция `-c` для сравнения результата с ожидаемым значением и отображения различий.
* В команды `ydb tools dump` и `ydb tools restore` добавлено логирование событий.
* В команду `ydb tools restore` добавлено указание места возникновения ошибки.

### Изменения с потерей обратной совместимости

* В команде `ydb topic write` для опции `--codec` значение по умолчанию изменено на `RAW`.

### Исправления ошибок

* Исправлен progress bar для команды `ydb workload import`.
* Устранена ошибка восстановления из резервной копии с использованием опции `--import-data`, возникавшая при изменении партиционирования таблицы.

## Версия 2.10.0 {#2-10-0}

Дата выхода 24 июня 2024. Для обновления до версии **2.10.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена команда `ydb sql`, работающая поверх QueryService, позволяющая выполнять любые DML/DDL команды.
* Добавлен режим `notx` для опции `--tx-mode` в команде `ydb table query execute`.
* Добавлены времена начала и конца в описании длительных операций (export, import).
* Добавлена поддержка описания объектов типа replication в командах `ydb scheme describe` и `ydb scheme ls`.
* Добавлена поддержка типов big datetime: `Date32`, `Datetime64`, `Timestamp64`, `Interval64`.
* Переработана команда `ydb workload`:

  * Добавлена опция `--clear` в подкоманде `init`, позволяющая удалить все существующие таблицы перед созданием новых.
  * Добавлена команда `ydb workload * import` для заполнения таблиц начальным контентом перед началом нагрузки.

### Изменения с потерей обратной совместимости

* Переработана команда `ydb workload`:

  * Опция `--path` перемещена на уровень конкретного типа нагрузки. Например: `ydb workload tpch --path some/tables/path init ...`.
  * Значение опции `--store=s3` переименовано в `--store=external-s3` в подкоманде `init`.

### Исправления ошибок

* Исправлена работа с цветовыми схемами в формате `PrettyTable`

## Версия 2.9.0 {#2-9-0}

Дата выхода 25 апреля 2024. Для обновления до версии **2.9.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Улучшены таблицы с логическими планами запросов: стали информативнее, добавлены цвета, исправлены некоторые ошибки.
* Для команды `ydb workload` поддержана опция `-v`, включающая вывод отладочной информации.
* Добавлена возможность запустить `ydb workload tpch --store s3` с источником s3 для измерения производительности федеративных запросов.
* Добавлена опция `--rate` для команды `ydb workload` для ограничения количества транзакций (запросов) в секунду.
* Добавлена опция `--use-virtual-addressing` для импорта/экспорта s3, позволяющая переключить режим [virtual hosting of buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html) для схемы путей s3.
* Улучшена производительность команды `ydb scheme ls` параллельным запуском листингов директорий.

### Исправления ошибок

* Исправлено обрезание лишних символов при переносе строк в таблицах CLI
* Исправлена ошибка обращения к памяти в команде `tools restore`.
* Исправлено игнорирование опции `--timeout` в generic и scan запросах.
* Добавлен таймаут 60s на проверку версии и скачивание бинарного файла CLI для избежания бесконечного ожидания.
* Исправлен ряд незначительных ошибок: опечатки, обработка пустых файлов и т.д.

## Версия 2.8.0 {#2-8-0}

Дата выхода 12 января 2024. Для обновления до версии **2.8.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлены команды управления конфигурациями кластера [ydb admin config](https://ydb.tech/docs/ru/reference/ydb-cli/configs.md?version=v25.4) и [ydb admin volatile-config](https://ydb.tech/docs/ru/reference/ydb-cli/configs.md?version=v25.4).
* Добавлена поддержка загрузки PostgreSQL-совместимых типов командой [ydb import file csv|tsv|json](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4). Только для строковых таблиц.
* Добавлена поддержка загрузки директории из S3-совместимого хранилища в команде [ydb import s3](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-s3.md?version=v25.4). Пока доступна только под Linux и Mac OS.
* Добавлена поддержка вывода результата выполнения команд [ydb table query execute](https://ydb.tech/docs/ru/reference/ydb-cli/table-query-execute.md?version=v25.4), [ydb yql](https://ydb.tech/docs/ru/reference/ydb-cli/yql.md?version=v25.4) и [ydb scripting yql](https://ydb.tech/docs/ru/reference/ydb-cli/scripting-yql.md?version=v25.4) в формате [Apache Parquet](https://parquet.apache.org/docs/).
* В командах [ydb workload](https://ydb.tech/docs/ru/reference/ydb-cli/commands/workload/index.md?version=v25.4) добавлена опция `--executer`, задающая используемый тип запросов.
* Добавлена колонка медианного времени выполнения бенчмарка в таблице статистики в команде [ydb workload clickbench](https://ydb.tech/docs/ru/reference/ydb-cli/workload-click-bench.md?version=v25.4).
* **_(Experimental)_** Добавлен тип запросов `generic` в команде [ydb table query execute](https://ydb.tech/docs/ru/reference/ydb-cli/table-query-execute.md?version=v25.4), позволяющий выполнять [DDL](https://ru.wikipedia.org/wiki/Data_Definition_Language) и [DML](https://ru.wikipedia.org/wiki/Data_Manipulation_Language) операции, с результатами произвольного размера и c поддержкой [MVCC](https://ydb.tech/docs/ru/concepts/query_execution/mvcc.md?version=v25.4). Команда использует экспериментальное API, совместимость не гарантируется.
* **_(Experimental)_** В команде `ydb table query explain` добавлена опция `--collect-diagnostics` для сбора диагностики запроса и сохранения её в файл. Команда использует экспериментальное API, совместимость не гарантируется.

### Исправления ошибок

* Исправлена ошибка вывода таблиц в `pretty` формате с [Unicode](https://ru.wikipedia.org/wiki/Юникод) символами.
* Исправлена ошибка подстановки неправильного первичного ключа в команде [ydb tools pg-convert](https://ydb.tech/docs/ru/postgresql/import.md?version=v25.4#pg-convert).

## Версия 2.7.0 {#2-7-0}

Дата выхода 23 октября 2023. Для обновления до версии **2.7.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена команда [ydb tools pg-convert](https://ydb.tech/docs/ru/postgresql/import.md?version=v25.4#pg-convert), выполняющая подготовку дампа, полученного утилитой [pg_dump](https://www.postgresql.org/docs/current/app-pgdump.html), к загрузке в postgres-совместимую прослойку YDB.
* Добавлена команда нагрузочного тестирования `ydb workload query`, которая нагружает базу [запросами выполнения скрипта](https://ydb.tech/docs/ru/reference/ydb-cli/yql.md?version=v25.4) в несколько потоков.
* Добавлена команда для просмотра списка разрешений `ydb scheme permissions list`.
* В командах [ydb table query execute](https://ydb.tech/docs/ru/reference/ydb-cli/table-query-execute.md?version=v25.4), [ydb table query explain](https://ydb.tech/docs/ru/reference/ydb-cli/commands/explain-plan.md?version=v25.4), [ydb yql](https://ydb.tech/docs/ru/reference/ydb-cli/yql.md?version=v25.4) и [ydb scripting yql](https://ydb.tech/docs/ru/reference/ydb-cli/scripting-yql.md?version=v25.4) добавлена опция `--flame-graph`, задающая путь до файла, в котором необходимо сохранить визуализацию статистики выполнения запросов.
* [Специальные команды](https://ydb.tech/docs/ru/reference/ydb-cli/interactive-cli.md?version=v25.4#spec-commands) интерактивного режима выполнения запросов теперь не чувствительны к регистру.
* Добавлена валидация [специальных команд](https://ydb.tech/docs/ru/reference/ydb-cli/interactive-cli.md?version=v25.4#spec-commands) и их [параметров](https://ydb.tech/docs/ru/reference/ydb-cli/interactive-cli.md?version=v25.4#internal-vars).
* Добавлено чтение из таблицы в сценарии с транзакциями в команде [ydb workload transfer topic-to-table run](https://ydb.tech/docs/ru/reference/ydb-cli/workload-transfer.md?version=v25.4#run).
* Добавлена опция `--commit-messages` в команде [ydb workload transfer topic-to-table run](https://ydb.tech/docs/ru/reference/ydb-cli/workload-transfer.md?version=v25.4#run), задающая число сообщений в одной транзакции.
* Добавлены опции `--only-table-in-tx` и `--only-topic-in-tx` в команде [ydb workload transfer topic-to-table run](https://ydb.tech/docs/ru/reference/ydb-cli/workload-transfer.md?version=v25.4#run), задающие ограничения на виды запросов в одной транзакции.
* Добавлены новые колонки `Select time` и `Upsert time` в таблице статистики в команде [ydb workload transfer topic-to-table run](https://ydb.tech/docs/ru/reference/ydb-cli/workload-transfer.md?version=v25.4#run).

### Исправления ошибок

* Исправлена ошибка при загрузке пустого JSON списка командами [ydb table query execute](https://ydb.tech/docs/ru/reference/ydb-cli/table-query-execute.md?version=v25.4), [ydb scripting yql](https://ydb.tech/docs/ru/reference/ydb-cli/scripting-yql.md?version=v25.4) и [ydb yql](https://ydb.tech/docs/ru/reference/ydb-cli/yql.md?version=v25.4).

## Версия 2.6.0 {#2-6-0}

Дата выхода 7 сентября 2023. Для обновления до версии **2.6.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* В [ydb workload tpch run](https://ydb.tech/docs/ru/reference/ydb-cli/workload-tpch.md?version=v25.4#run) добавлена опция `--path`, содержащая путь до директории с таблицами, созданными командой [ydb workload tpch init](https://ydb.tech/docs/ru/reference/ydb-cli/workload-tpch.md?version=v25.4#init).
* Добавлена команда [ydb workload transfer topic-to-table](https://ydb.tech/docs/ru/reference/ydb-cli/workload-transfer.md?version=v25.4), которая нагружает базу запросами на чтение из топиков и запись в таблицу.
* Добавлена опция `--consumer-prefix` в командax [ydb workload topic init](https://ydb.tech/docs/ru/reference/ydb-cli/workload-topic.md?version=v25.4#init), [ydb workload topic run read|full](https://ydb.tech/docs/ru/reference/ydb-cli/workload-topic.md?version=v25.4#run-read), задающая префиксы имен читателей.
* Добавлена опция `--partition-ids` в команде [ydb topic read](https://ydb.tech/docs/ru/reference/ydb-cli/topic-read.md?version=v25.4), задающая список id партиций топика для чтения, разделенных запятой.
* Добавлена поддержка форматов параметров CSV и TSV в командах исполнения [YQL запросов](https://ydb.tech/docs/ru/reference/ydb-cli/parameterized-queries-cli.md?version=v25.4).
* Переработан [интерактивный режим выполнения запросов](https://ydb.tech/docs/ru/reference/ydb-cli/interactive-cli.md?version=v25.4). Добавлены [новые специфичные команды интерактивного режима](https://ydb.tech/docs/ru/reference/ydb-cli/interactive-cli.md?version=v25.4#spec-commands): `SET stats`, `EXPLAIN`, `EXPLAIN AST`. Добавлены сохранение истории между запусками CLI и автодополнение YQL запросов.
* Добавлена команда [ydb config info](https://ydb.tech/docs/ru/reference/ydb-cli/commands/config-info.md?version=v25.4), которая выводит текущие параметры соединения без подключения к базе данных.
* Добавлена команда [ydb workload kv run mixed](https://ydb.tech/docs/ru/reference/ydb-cli/workload-kv.md?version=v25.4#mixed-kv), которая нагружает базу запросами на запись и чтение.
* Опция `--percentile` в командах [ydb workload topic run write|read|full](https://ydb.tech/docs/ru/reference/ydb-cli/workload-topic.md?version=v25.4#run-write) теперь может принимать вещественные значения.
* Увеличены значения по умолчанию для опций `--seconds` и `--warmup` в командах [ydb workload topic run write|read|full](https://ydb.tech/docs/ru/reference/ydb-cli/workload-topic.md?version=v25.4#run-write) до 60 секунд и 5 секунд соответственно.
* Изменено значение по умолчанию для опции `--supported-codecs` на `RAW` в командах [ydb topic create](https://ydb.tech/docs/ru/reference/ydb-cli/topic-create.md?version=v25.4) и [ydb topic consumer add](https://ydb.tech/docs/ru/reference/ydb-cli/topic-consumer-add.md?version=v25.4).

### Исправления ошибок

* Исправлена потеря строк при загрузке командой [ydb import file json](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4).
* Исправлен неучет статистики во время прогрева команд [ydb workload topic run write|read|full](https://ydb.tech/docs/ru/reference/ydb-cli/workload-topic.md?version=v25.4#run-write).
* Исправлен неполный вывод статистики в командах [ydb scripting yql](https://ydb.tech/docs/ru/reference/ydb-cli/scripting-yql.md?version=v25.4) и [ydb yql](https://ydb.tech/docs/ru/reference/ydb-cli/yql.md?version=v25.4).
* Исправлен неправильный вывод progress bar'a в командах [ydb tools dump](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-dump.md?version=v25.4) и [ydb tools restore](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4).
* Исправлена ошибка загрузки больших файлов с заголовком в команде [ydb import file csv|tsv](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4).
* Исправлено зависание команды [ydb tools restore --import-data](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-restore.md?version=v25.4#optional).
* Исправлена ошибка `Unknown value Rejected` при выполнении команды [ydb operation list buildindex](https://ydb.tech/docs/ru/reference/ydb-cli/operation-list.md?version=v25.4).

## Версия 2.5.0 {#2-5-0}

Дата выхода 20 июня 2023. Для обновления до версии **2.5.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Для команды `ydb import file` добавлен параметр [--timeout](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4#optional), задающий время, в течение которого должна быть выполнена операция на сервере.
* Добавлен индикатор прогресса в командах [ydb scheme rmdir --recursive](https://ydb.tech/docs/ru/reference/ydb-cli/commands/dir.md?version=v25.4#rmdir) и [ydb import file](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4).
* Добавлена команда [ydb workload kv run read-rows](https://ydb.tech/docs/ru/reference/ydb-cli/workload-kv.md?version=v25.4#read-rows-kv), которая нагружает базу запросами на чтение строк, используя новый экспериментальный API вызов ReadRows (реализован только в ветке [main](https://github.com/ydb-platform/ydb)), выполняющий более быстрое чтение по ключу, чем [select](https://ydb.tech/docs/ru/reference/ydb-cli/workload-kv.md?version=v25.4#select-kv).
* В [ydb workload topic](https://ydb.tech/docs/ru/reference/ydb-cli/workload-topic.md?version=v25.4) добавлены новые параметры `--warmup-time`, `--percentile`, `--topic`, задающие время прогрева теста, процентиль в выводе статистики и имя топика соответственно.
* Добавлена команда [ydb workload tpch](https://ydb.tech/docs/ru/reference/ydb-cli/workload-tpch.md?version=v25.4) для запуска нагрузочного теста TPC-H.
* Добавлен флаг `--ordered` в команде [ydb tools dump](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/tools-dump.md?version=v25.4), сохраняющий порядок по первичному ключу в таблицах.

### Производительность

* Увеличена скорость загрузки данных в команде `ydb import file` за счет добавления параллельной загрузки. Число потоков задается новым параметром [--threads](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4#optional).
* Увеличена производительность команды [ydb import file json](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4), за счет уменьшения числа копирований данных.

## Версия 2.4.0 {#2-4-0}

Дата выхода 24 мая 2023. Для обновления до версии **2.4.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена возможность загрузки нескольких файлов командой [ydb import file](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4).
* Добавлена поддержка удаления колоночных таблиц для команды [ydb scheme rmdir --recursive](https://ydb.tech/docs/ru/reference/ydb-cli/commands/dir.md?version=v25.4#rmdir).
* Повышена стабильность работы команды [ydb workload topic](https://ydb.tech/docs/ru/reference/ydb-cli/workload-topic.md?version=v25.4).

## Версия 2.3.0 {#2-3-0}

Дата выхода 1 мая 2023. Для обновления до версии **2.3.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлен интерактивный режим выполнения запросов. Для перехода в интерактивный режим выполните команду [ydb yql](https://ydb.tech/docs/ru/reference/ydb-cli/yql.md?version=v25.4) без аргументов. Режим экспериментальный, обратная совместимость пока не гарантируется.
* Добавлена команда [ydb index rename](https://ydb.tech/docs/ru/reference/ydb-cli/commands/secondary_index.md?version=v25.4#rename) для [атомарной замены](https://ydb.tech/docs/ru/dev/secondary-indexes.md?version=v25.4#atomic-index-replacement) или переименования вторичного индекса.
* Добавлена команда `ydb workload topic` для запуска нагрузки, которая читает и записывает сообщения в топики.
* Для команды `ydb scheme rmdir` добавлен параметр [--recursive](https://ydb.tech/docs/ru/reference/ydb-cli/commands/dir.md?version=v25.4#rmdir-options), который позволяет рекурсивно удалить директорию вместе со всем содержимым.
* Для команды [ydb scheme describe](https://ydb.tech/docs/ru/reference/ydb-cli/commands/scheme-describe.md?version=v25.4) добавлена поддержка типов `topic` и `coordination node`.
* Для команды `ydb topic consumer` добавлен параметр [--commit](https://ydb.tech/docs/ru/reference/ydb-cli/topic-read.md?version=v25.4#osnovnye-opcionalnye-parametry) для подтверждения прочитанных сообщений.
* Для команды `ydb import file csv|tsv` добавлен параметр [--columns](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4#optional), с помощью которого можно указать список колонок вместо заголовка в файле.
* Для команды `ydb import file csv|tsv` добавлен параметр [--newline-delimited](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4#optional), который подтверждает отсутствие символа переноса строки в данных. Использование этого параметра ускоряет импорт за счет параллельного чтения из нескольких секций файла.

### Исправления ошибок

* Исправлена ошибка, которая приводила к повышенному потреблению памяти и процессора при выполнении команды `ydb import file`.

## Версия 2.2.0 {#2-2-0}

Дата выхода 3 марта 2023. Для обновления до версии **2.2.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Исправлена ошибка, когда невозможно было указать поддерживаемые алгоритмы сжатия при добавлении читателя топика.
* Добавлена поддержка потокового выполнения YQL-скриптов и запросов на основе параметров, [передаваемых через `stdin`](https://ydb.tech/docs/ru/reference/ydb-cli/parameterized-queries-cli.md?version=v25.4).
* Значения параметров YQL-запросов теперь могут быть [переданы из файла](https://ydb.tech/docs/ru/reference/ydb-cli/parameterized-queries-cli.md?version=v25.4).
* Запрос на ввод пароля теперь выводится в `stderr` вместо `stdout`.
* Путь к корневому CA сертификату теперь может быть сохранен в [профиле](https://ydb.tech/docs/ru/reference/ydb-cli/profile/index.md?version=v25.4).
* Добавлен глобальный параметр [--profile-file](https://ydb.tech/docs/ru/reference/ydb-cli/commands/global-options.md?version=v25.4#service-options) для использования указанного файла в качестве хранилища для настроек профилей.
* Добавлен новый тип нагрузочного тестирования [ydb workload clickbench](https://ydb.tech/docs/ru/reference/ydb-cli/workload-click-bench.md?version=v25.4).

## Версия 2.1.1 {#2-1-1}

Дата выхода 30 декабря 2022. Для обновления до версии **2.1.1** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Улучшения

* Добавлена поддержка параметра `--stats` команды [ydb scheme describe](https://ydb.tech/docs/ru/reference/ydb-cli/commands/scheme-describe.md?version=v25.4) для колоночных таблиц.
* Добавлена поддержка файлов в формате Parquet для импорта командой [ydb import](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4).
* Поддержаны дополнительное логирование и ретраи для команды [ydb import](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/import-file.md?version=v25.4).

## Версия 2.1.0 {#2-1-0}

Дата выхода 18 ноября 2022. Для обновления до версии **2.1.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена возможность [неинтерактивного создания профиля](https://ydb.tech/docs/ru/reference/ydb-cli/profile/create.md?version=v25.4#cmdline).
* Добавлены команды [ydb config profile update](https://ydb.tech/docs/ru/reference/ydb-cli/profile/create.md?version=v25.4#update) и [ydb config profile replace](https://ydb.tech/docs/ru/reference/ydb-cli/profile/create.md?version=v25.4#replace) для изменения и замены профилей.
* Для команды [ydb scheme ls](https://ydb.tech/docs/ru/reference/ydb-cli/commands/scheme-ls.md?version=v25.4) добавлен параметр `-1`, включающая режим вывода по одному объекту на строку.
* URL сервиса IAM теперь можно сохранять в профиле.
* Добавлена возможность использовать аутентификацию по логину и паролю без указания пароля.
* Добавлена поддержка профилей AWS в команде [ydb export s3](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/auth-s3.md?version=v25.4#auth).
* Добавлена возможность создания профиля используя `stdin`. Например, можно передать вывод команды [YC CLI](https://cloud.yandex.ru/docs/cli/) `yc ydb database get information` на вход команде `ydb config profile create`.

### Исправления ошибок

* Исправлена ошибка, когда некорректно выводился результат запроса в формате JSON-array, если он состоял из нескольких ответов сервера.
* Исправлена ошибка, приводящая к невозможности изменить профиль, используя при этом некорректный профиль.

## Версия 2.0.0 {#2-0-0}

Дата выхода 20 сентября 2022. Для обновления до версии **2.0.0** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена возможность работы с топиками:

  * `ydb topic create` — создание топика;
  * `ydb topic alter` — изменение топика;
  * `ydb topic write` — запись данных в топик;
  * `ydb topic read` — чтение данных из топика;
  * `ydb topic drop` — удаление топика.

* Добавлен новый тип нагрузочного тестирования:

  * `ydb workload kv init` — создание таблицы для тестирования kv нагрузки;
  * `ydb workload kv run` — запуск одной из 3 видов нагрузки: запуск нескольких сессий вставки `UPSERT`, запуск нескольких сессий вставки `INSERT` или запуск нескольких сессий с GET-запросами по первичному ключу;
  * `ydb workload kv clean` — удаление тестовой таблицы.

* Добавлена возможность деактивировать текущий активный профиль (см. команду `ydb config profile deactivate`).
* Добавлена возможность неинтерактивного удаления профиля без подтверждения (см. параметр `--force` команды `ydb config profile remove`).
* Добавлена поддержка CDC для команды `ydb scheme describe`.
* Добавлена возможность просмотра текущего статуса БД (см. команду `ydb monitoring healthcheck`).
* Добавлена возможность просмотра аутентификационной информации (токена), с которой будут отправляться запросы к БД при текущих настройках аутентификации (см. команду `ydb auth get-token`).
* Добавлена возможность чтения данных из стандартного потока ввода для команды `ydb import`.
* Добавлена возможность импорта данных в формате JSON из файла или стандартного потока ввода (см. команду `ydb import file json`).

### Улучшения

* Улучшен процессинг команд. Парсинг и валидация пользовательского ввода теперь более точные.

## Версия 1.9.1 {#1-9-1}

Дата выхода 25 июня 2022. Для обновления до версии **1.9.1** перейдите в раздел [Загрузки](https://ydb.tech/docs/ru/downloads/ydb-cli.md?version=v25.4).

### Функциональность

* Добавлена возможность сжатия данных при экспорте в S3-совместимое хранилище (см. параметр `--compression` команды [ydb export s3](https://ydb.tech/docs/ru/reference/ydb-cli/export-import/export-s3.md?version=v25.4)).
* Добавлена возможность управления автоматической проверкой доступности новой версии YDB CLI (см. параметры `--disable-checks` и `--enable-checks` команды [ydb version](https://ydb.tech/docs/ru/reference/ydb-cli/version.md?version=v25.4)).