Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add release notes for YDB CLI 2.19.0 #14164

Merged
merged 11 commits into from
Feb 10, 2025
29 changes: 28 additions & 1 deletion ydb/docs/en/core/changelog-cli.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,28 @@
# {{ ydb-short-name }} CLI changelog

## Version 2.19.0 {#2-19-0}

Released on February 5, 2025. To update to version **2.19.0**, select the [Downloads](downloads/index.md#ydb-cli) section.

### Features

* Added [changefeeds](./concepts/cdc.md) support in `ydb tools dump` and `ydb tools restore` [commands](./reference/ydb-cli/export-import/tools-dump.md). As a result, there are changes in the backup file structure: for tables with changefeeds, a subdirectory is created for each changefeed, named after the changefeed. This subdirectory contains two files: `changefeed_description.pb`, which contains the changefeed description, and `topic_description.pb`, which contains information about the underlying topic.
* Added `CREATE TABLE` text suggestion on schema error during `ydb import file csv` [command](./reference/ydb-cli/export-import/import-file.md).
* Added statistics output on the current progress of the query in the `ydb workload` [command](./reference/ydb-cli/commands/workload/).
* Added query text to the error message if a query fails in the `ydb workload run` [command](./reference/ydb-cli/commands/workload/).
* Added a message if the global timeout expired in the `ydb workload run` [command](./reference/ydb-cli/commands/workload/).
* Added some temporary changes to the experimental `ydb admin storage` command.
* **_(Requires server v25.1+)_** Added [views](./concepts/datamodel/view.md) support in `ydb export s3` and `ydb import s3`. Views are exported as `CREATE VIEW` YQL statements, which are executed on import.
* **_(Requires server v25.1+)_** Added the `--skip-checksum-validation` option to the `ydb import s3` [command](./reference/ydb-cli/export-import/import-s3.md) to skip server-side checksum validation.
* **_(Requires server v25.1+)_** Added new experimental options for the `ydb debug ping` command: `--chain-length`, `--chain-work-duration`, `--no-tail-chain`.

### Bug fixes

* Fixed a bug where the arm64 {{ ydb-short-name }} CLI binary was downloading the amd64 binary to replace itself during `ydb update` [command](./reference/ydb-cli/commands/service.md). To update already installed binaries to the latest arm64 version, {{ ydb-short-name }} CLI should be reinstalled.
* Fixed the return code of the `ydb workload run` [command](./reference/ydb-cli/commands/workload/).
* Fixed a bug where the `ydb workload tpch import generator` and `ydb workload tpcds import generator` [commands](./reference/ydb-cli/workload-tpch.md) were failing because not all tables had been created.
* Fixed a bug with backslashes in `ydb workload` [commands](./reference/ydb-cli/commands/workload/) paths on Windows.

## Version 2.18.0 {#2-18-0}

Released on December 24, 2024. To update to version **2.18.0**, select the [Downloads](downloads/index.md#ydb-cli) section.
Expand All @@ -9,7 +32,7 @@ Released on December 24, 2024. To update to version **2.18.0**, select the [Down
* Added support for [views](./concepts/datamodel/view) in local backups: `ydb tools dump` and `ydb tools restore`. Views are backed up as `CREATE VIEW` queries saved in the `create_view.sql` files, which can be executed to recreate the original views.
* Added new options to the `ydb workload topic run` [command](./reference/ydb-cli/workload-topic#run-write): `--tx-commit-interval` and `--tx-commit-messages`, allowing you to specify the interval between transaction commits in milliseconds or in the number of messages written, respectively.
* Made the `--consumer` flag in the `ydb topic read` [command](./reference/ydb-cli/topic-read) optional. In the non-subscriber reading mode, the partition IDs must be specified with the `--partition-ids` option. In this case, the read is performed without saving the offset commit.
* The `ydb import file csv` [command]((./reference/ydb-cli/export-import/import-file)) now saves the import progress. Relaunching the import command will resume the process from the row where it was interrupted.
* The `ydb import file csv` [command](./reference/ydb-cli/export-import/import-file.md) now saves the import progress. Relaunching the import command will resume the process from the row where it was interrupted.
* In the `ydb workload kv` and `ydb workload stock` commands, the default value of the `--executer` option has been changed to `generic`, which makes them no longer rely on the legacy query execution infrastructure.
* Replaced the CSV format with Parquet for filling tables in `ydb workload` benchmarks.

Expand All @@ -27,6 +50,10 @@ Released on December 24, 2024. To update to version **2.18.0**, select the [Down

Released on December 4, 2024. To update to version **2.17.0**, select the [Downloads](downloads/index.md#ydb-cli) section.

### Features

* **_(Requires server v25.1+)_** Added `ydb debug ping` command for performance and connectivity debugging

### Performance

* Improved performance of parallel [importing data from the file system](./reference/ydb-cli/export-import/tools-restore.md) using the `{{ ydb-cli }} tools restore` command.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
Use the amd64 binary if you have an Intel-based Mac.
| Version | Release date | Download | Changelog |
:--- | :--- | :--- | :---
| v.2.19.0 | 05/02/2025 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.19.0/darwin/amd64/ydb) | [See the changelog](../../../changelog-cli.md#2-19-0) |
| v.2.18.0 | 24/12/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.18.0/darwin/amd64/ydb) | [See the changelog](../../../changelog-cli.md#2-18-0) |
| v.2.17.0 | 04/12/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.17.0/darwin/amd64/ydb) | [See the changelog](../../../changelog-cli.md#2-17-0) |
| v.2.16.0 | 26/11/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.16.0/darwin/amd64/ydb) | [See the changelog](../../../changelog-cli.md#2-16-0) |
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
Use the arm64 binary if you have an M-series Mac.
| Version | Release date | Download | Changelog |
:--- | :--- | :--- | :---
| v.2.19.0 | 05/02/2025 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.19.0/darwin/arm64/ydb) | [See the changelog](../../../changelog-cli.md#2-19-0) |
| v.2.18.0 | 24/12/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.18.0/darwin/arm64/ydb) | [See the changelog](../../../changelog-cli.md#2-18-0) |
| v.2.17.0 | 04/12/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.17.0/darwin/arm64/ydb) | [See the changelog](../../../changelog-cli.md#2-17-0) |
| v.2.16.0 | 26/11/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.16.0/darwin/arm64/ydb) | [See the changelog](../../../changelog-cli.md#2-16-0) |
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
| Version | Release date | Download | Changelog |
:--- | :--- | :--- | :---
| v.2.19.0 | 05/02/2025 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.19.0/linux/amd64/ydb) | [See the changelog](../../../changelog-cli.md#2-19-0) |
| v.2.18.0 | 24/12/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.18.0/linux/amd64/ydb) | [See the changelog](../../../changelog-cli.md#2-18-0) |
| v.2.17.0 | 04/12/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.17.0/linux/amd64/ydb) | [See the changelog](../../../changelog-cli.md#2-17-0) |
| v.2.16.0 | 26/11/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.16.0/linux/amd64/ydb) | [See the changelog](../../../changelog-cli.md#2-16-0) |
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
| Version | Release date | Download | Changelog |
:--- | :--- | :--- | :---
| v.2.19.0 | 05/02/2025 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.19.0/linux/arm64/ydb) | [See the changelog](../../../changelog-cli.md#2-19-0) |
| v.2.18.0 | 24/12/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.18.0/linux/arm64/ydb) | [See the changelog](../../../changelog-cli.md#2-18-0) |
| v.2.17.0 | 04/12/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.17.0/linux/arm64/ydb) | [See the changelog](../../../changelog-cli.md#2-17-0) |
| v.2.16.0 | 26/11/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.16.0/linux/arm64/ydb) | [See the changelog](../../../changelog-cli.md#2-16-0) |
Expand Down
1 change: 1 addition & 0 deletions ydb/docs/en/core/downloads/_includes/ydb-cli/windows.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
| Version | Release date | Download | Changelog |
:--- | :--- | :--- | :---
| v.2.19.0 | 05/02/2025 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.19.0/windows/amd64/ydb.exe) | [See the changelog](../../../changelog-cli.md#2-19-0) |
| v.2.18.0 | 24/12/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.18.0/windows/amd64/ydb.exe) | [See the changelog](../../../changelog-cli.md#2-18-0) |
| v.2.17.0 | 04/12/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.17.0/windows/amd64/ydb.exe) | [See the changelog](../../../changelog-cli.md#2-17-0) |
| v.2.16.0 | 26/11/2024 | [Binary file](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.16.0/windows/amd64/ydb.exe) | [See the changelog](../../../changelog-cli.md#2-16-0) |
Expand Down
29 changes: 28 additions & 1 deletion ydb/docs/ru/core/changelog-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,29 @@

# Список изменений {{ ydb-short-name }} CLI

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

Дата выхода 5 февраля 2024. Для обновления до версии **2.19.0** перейдите в раздел [Загрузки](downloads/index.md#ydb-cli).

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

* Добавлена поддержка [потоков изменений (changefeeds)](./concepts/cdc.md) при выполнении [команд](./reference/ydb-cli/export-import/tools-dump.md) `ydb tools dump` и `ydb tools restore`. В результате появились изменения в файле бэкапа: для таблиц с потоками изменений создаётся одноимённая директория на каждый поток изменений. Каждая такая директория содержит два файла: `changefeed_description.pb` с описанием потока изменений и `topic_description.pb` с информацией о связанном топике.
* Добавлена рекомендация с текстом `CREATE TABLE` при схемной ошибке во время выполнения [команды](./reference/ydb-cli/export-import/import-file.md) `ydb import file csv`.
* Добавлен вывод статистики для текущего процесса при выполнении [команды](./reference/ydb-cli/commands/workload/) `ydb workload`.
* Добавлен текст запроса к сообщению, если запрос завершился ошибкой при выполнении [команды](./reference/ydb-cli/commands/workload/) `ydb workload run`.
* Добавлено сообщение в случае ошибки истечения глобального таймаута при выполнении [команды](./reference/ydb-cli/commands/workload/) `ydb workload run`.
* Внесены временные изменения в экспериментальной команде `ydb admin storage`.
* **_(Требуется сервер v25.1+)_** Добавлена поддержка [представлений (VIEW)](./concepts/datamodel/view.md) при выполнении операций `ydb export s3` и `ydb import s3`. Представления экспортируются как YQL-выражение `CREATE VIEW`, которое выполняется при импорте.
* **_(Требуется сервер v25.1+)_** Добавлена опция `--skip-checksum-validation` для [команды](./reference/ydb-cli/export-import/import-s3.md) `ydb import s3`, позволяющая отключить валидацию контрольной суммы на стороне сервера.
* **_(Требуется сервер v25.1+)_** Добавлены новые экспериментальные опции `--chain-length`, `--chain-work-duration`, `--no-tail-chain` для команды `ydb debug ping`.

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

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

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

Дата выхода 24 декабря 2024. Для обновления до версии **2.18.0** перейдите в раздел [Загрузки](downloads/index.md#ydb-cli).
Expand All @@ -11,7 +34,7 @@
* Добавлена поддержка [представлений (VIEW)](./concepts/datamodel/view) при выполнении операций резервного копирования `ydb tools dump` и восстановления `ydb tools restore`. Представления сохраняются в файл "create_view.sql" в виде запросов `CREATE VIEW`, которые будут выполнены для восстановления.
* В [команду](./reference/ydb-cli/workload-topic#run-write) `ydb workload topic run` добавлены опции `--tx-commit-interval` и `--tx-commit-messages`, которые задают интервал между коммитами транзакций в миллисекундах и в количестве записанных сообщений соответственно.
* В [команде](./reference/ydb-cli/topic-read) `ydb topic read` параметр `--consumer` перестал быть обязательным. В режиме чтения без подписчика обязательно должны быть указаны идентификаторы партиций с помощью параметра `--partition-ids`. Чтение в этом случае выполняется без сохранения коммита оффсетов.
* [Команда](./reference/ydb-cli/export-import/import-file) `ydb import file csv` теперь сохраняет прогресс выполнения. Повторный запуск команды импорта продолжится с той строки, на которой она была прервана.
* [Команда](./reference/ydb-cli/export-import/import-file.md) `ydb import file csv` теперь сохраняет прогресс выполнения. Повторный запуск команды импорта продолжится с той строки, на которой она была прервана.
* В командах `ydb workload kv` и `ydb workload stock` значение параметра `--executer` по умолчанию изменено на "generic", благодаря чему они больше не используют устаревшую инфраструктуру выполнения запросов.
* Изменен формат загрузки данных в таблицы для нагрузочных тестов `ydb workload` с CSV на Parquet.

Expand All @@ -28,6 +51,10 @@

Дата выхода 4 декабря 2024. Для обновления до версии **2.17.0** перейдите в раздел [Загрузки](downloads/index.md#ydb-cli).

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

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

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

* Улучшена производительность [параллельного восстановления из файловой системы](./reference/ydb-cli/export-import/tools-restore.md) с помощью команды `{{ ydb-cli }} tools restore`.
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
Используйте бинарный файл amd64, если ваш Mac на базе процессора Intel.
Версия | Дата выпуска | Скачать | Список изменений
:--- | :--- | :--- | :---
v.2.19.0 | 05.02.2025 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.19.0/darwin/amd64/ydb) | [См. список](../../../changelog-cli.md#2-19-0)
v.2.18.0 | 24.12.24 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.18.0/darwin/amd64/ydb) | [См. список](../../../changelog-cli.md#2-18-0)
v.2.17.0 | 04.12.24 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.17.0/darwin/amd64/ydb) | [См. список](../../../changelog-cli.md#2-17-0)
v.2.16.0 | 26.11.24 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.16.0/darwin/amd64/ydb) | [См. список](../../../changelog-cli.md#2-16-0)
Expand Down
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
Используйте бинарный файл arm64, если ваш Mac на базе процессора Apple Silicon (M1, M2 или более поздние).
Версия | Дата выпуска | Скачать | Список изменений
:--- | :--- | :--- | :---
v.2.19.0 | 05.02.2025 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.19.0/darwin/arm64/ydb) | [См. список](../../../changelog-cli.md#2-19-0)
v.2.18.0 | 24.12.24 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.18.0/darwin/arm64/ydb) | [См. список](../../../changelog-cli.md#2-18-0)
v.2.17.0 | 04.12.24 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.17.0/darwin/arm64/ydb) | [См. список](../../../changelog-cli.md#2-17-0)
v.2.16.0 | 26.11.24 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.16.0/darwin/arm64/ydb) | [См. список](../../../changelog-cli.md#2-16-0)
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
Версия | Дата выпуска | Скачать | Список изменений
:--- | :--- | :--- | :---
v.2.19.0 | 05.02.2025 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.19.0/linux/amd64/ydb) | [См. список](../../../changelog-cli.md#2-19-0)
v.2.18.0 | 24.12.24 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.18.0/linux/amd64/ydb) | [См. список](../../../changelog-cli.md#2-18-0)
v.2.17.0 | 04.12.24 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.17.0/linux/amd64/ydb) | [См. список](../../../changelog-cli.md#2-17-0)
v.2.16.0 | 26.11.24 | [Бинарный файл](https://storage.yandexcloud.net/yandexcloud-ydb/release/2.16.0/linux/amd64/ydb) | [См. список](../../../changelog-cli.md#2-16-0)
Expand Down
Loading