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
31 changes: 30 additions & 1 deletion ydb/docs/en/core/changelog-cli.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,29 @@
# {{ 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).
* 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/index.md).
* Added query text to the error message if a query fails in the `ydb workload run` [command](./reference/ydb-cli/commands/workload/index.md).
* Added a message if the global timeout expired in the `ydb workload run` [command](./reference/ydb-cli/commands/workload/index.md).
* **_(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+)_** **_(Experimental)_** Added new options for the `ydb debug ping` command: `--chain-length`, `--chain-work-duration`, `--no-tail-chain`.
* **_(Requires server v25.1+)_** **_(Experimental)_** Added new options for the `ydb admin storage fetch` command: `--dedicated-storage-section` and `--dedicated-cluster-section`.
* **_(Requires server v25.1+)_** **_(Experimental)_** Added new options for the `ydb admin storage replace` command: `--filename`, `--dedicated-cluster-yaml`, `--dedicated-storage-yaml`, `--enable-dedicated-storage-section` and `--disable-dedicated-storage-section`.

### Bug fixes

* Fixed a bug where the arm64 {{ ydb-short-name }} CLI binary was downloading the amd64 binary to replace itself during the `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/index.md).
* 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 the `ydb workload` [commands](./reference/ydb-cli/commands/workload/index.md) 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,9 +33,10 @@ 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.
* **_(Requires server v25.1+)_** **_(Experimental)_** Added new `ydb admin storage` command with `fetch` and `replace` subcommands to manage server storage configuration.

### Backward incompatible changes

Expand All @@ -27,6 +52,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+)_** **_(Experimental)_** 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
31 changes: 30 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,30 @@

# Список изменений {{ 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`.
* Добавлена рекомендация с текстом `CREATE TABLE` при схемной ошибке во время выполнения [команды](./reference/ydb-cli/export-import/import-file.md) `ydb import file csv`.
* Добавлен вывод статистики для текущего процесса при выполнении [команды](./reference/ydb-cli/commands/workload/index.md) `ydb workload`.
* Добавлен текст запроса к сообщению, если запрос завершился ошибкой при выполнении [команды](./reference/ydb-cli/commands/workload/index.md) `ydb workload run`.
* Добавлено сообщение в случае ошибки истечения глобального таймаута при выполнении [команды](./reference/ydb-cli/commands/workload/index.md) `ydb workload run`.
* **_(Требуется сервер 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+)_** **_(Экспериментально)_** Для команды `ydb debug ping` добавлены новые опции: `--chain-length`, `--chain-work-duration`, `--no-tail-chain`.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Для команды `ydb admin storage fetch` добавлены новые опции: `--dedicated-storage-section` and `--dedicated-cluster-section`.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Для команды `ydb admin storage replace` добавлены новые опции: `--filename`, `--dedicated-cluster-yaml`, `--dedicated-storage-yaml`, `--enable-dedicated-storage-section` and `--disable-dedicated-storage-section`.

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

* Исправлена ошибка, из-за которой [команда](./reference/ydb-cli/commands/service.md) `ydb update` в arm64-версии исполняемого файла YDB CLI скачивала и заменяла себя исполняемым файлом amd64-версии. Чтобы обновить ранее установленный YDB CLI до последней arm64-версии (а не amd64), его нужно переустановить.
* [Команда](./reference/ydb-cli/commands/workload/index.md) `ydb workload run` теперь возвращает корректный код возврата.
* Исправлена ошибка, из-за которой [команды](./reference/ydb-cli/workload-tpch.md) `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** перейдите в раздел [Загрузки](downloads/index.md#ydb-cli).
Expand All @@ -11,9 +35,10 @@
* Добавлена поддержка [представлений (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.
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Добавлена команда `ydb admin storage` с подкомандами `fetch` и `replace` для управления конфигурацией хранилища сервера.

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

Expand All @@ -28,6 +53,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
Loading