Skip to content

Commit 544a6a7

Browse files
pnv1blinkov
andauthored
Add release notes for YDB CLI 2.19.0 (#14164)
Co-authored-by: Ivan Blinkov <ivan@blinkov.ru>
1 parent ee34c01 commit 544a6a7

File tree

12 files changed

+70
-2
lines changed

12 files changed

+70
-2
lines changed

ydb/docs/en/core/changelog-cli.md

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,29 @@
11
# {{ ydb-short-name }} CLI changelog
22

3+
## Version 2.19.0 {#2-19-0}
4+
5+
Released on February 5, 2025. To update to version **2.19.0**, select the [Downloads](downloads/index.md#ydb-cli) section.
6+
7+
### Features
8+
9+
* Added [changefeeds](./concepts/cdc.md) support in `ydb tools dump` and `ydb tools restore` [commands](./reference/ydb-cli/export-import/tools-dump.md).
10+
* Added `CREATE TABLE` text suggestion on schema error during `ydb import file csv` [command](./reference/ydb-cli/export-import/import-file.md).
11+
* Added statistics output on the current progress of the query in the `ydb workload` [command](./reference/ydb-cli/commands/workload/index.md).
12+
* Added query text to the error message if a query fails in the `ydb workload run` [command](./reference/ydb-cli/commands/workload/index.md).
13+
* Added a message if the global timeout expired in the `ydb workload run` [command](./reference/ydb-cli/commands/workload/index.md).
14+
* **_(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.
15+
* **_(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.
16+
* **_(Requires server v25.1+)_** **_(Experimental)_** Added new options for the `ydb debug ping` command: `--chain-length`, `--chain-work-duration`, `--no-tail-chain`.
17+
* **_(Requires server v25.1+)_** **_(Experimental)_** Added new options for the `ydb admin storage fetch` command: `--dedicated-storage-section` and `--dedicated-cluster-section`.
18+
* **_(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`.
19+
20+
### Bug fixes
21+
22+
* 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.
23+
* Fixed the return code of the `ydb workload run` [command](./reference/ydb-cli/commands/workload/index.md).
24+
* 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.
25+
* Fixed a bug with backslashes in the `ydb workload` [commands](./reference/ydb-cli/commands/workload/index.md) paths on Windows.
26+
327
## Version 2.18.0 {#2-18-0}
428

529
Released on December 24, 2024. To update to version **2.18.0**, select the [Downloads](downloads/index.md#ydb-cli) section.
@@ -9,9 +33,10 @@ Released on December 24, 2024. To update to version **2.18.0**, select the [Down
933
* 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.
1034
* 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.
1135
* 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.
12-
* 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.
36+
* 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.
1337
* 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.
1438
* Replaced the CSV format with Parquet for filling tables in `ydb workload` benchmarks.
39+
* **_(Requires server v25.1+)_** **_(Experimental)_** Added new `ydb admin storage` command with `fetch` and `replace` subcommands to manage server storage configuration.
1540

1641
### Backward incompatible changes
1742

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

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

55+
### Features
56+
57+
* **_(Requires server v25.1+)_** **_(Experimental)_** Added `ydb debug ping` command for performance and connectivity debugging.
58+
3059
### Performance
3160

3261
* 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.

ydb/docs/en/core/downloads/_includes/ydb-cli/darwin_amd64.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
Use the amd64 binary if you have an Intel-based Mac.
22
| Version | Release date | Download | Changelog |
33
:--- | :--- | :--- | :---
4+
| 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) |
45
| 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) |
56
| 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) |
67
| 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) |

ydb/docs/en/core/downloads/_includes/ydb-cli/darwin_arm64.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
Use the arm64 binary if you have an M-series Mac.
22
| Version | Release date | Download | Changelog |
33
:--- | :--- | :--- | :---
4+
| 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) |
45
| 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) |
56
| 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) |
67
| 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) |

ydb/docs/en/core/downloads/_includes/ydb-cli/linux_amd64.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
| Version | Release date | Download | Changelog |
22
:--- | :--- | :--- | :---
3+
| 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) |
34
| 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) |
45
| 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) |
56
| 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) |

ydb/docs/en/core/downloads/_includes/ydb-cli/linux_arm64.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
| Version | Release date | Download | Changelog |
22
:--- | :--- | :--- | :---
3+
| 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) |
34
| 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) |
45
| 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) |
56
| 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) |

ydb/docs/en/core/downloads/_includes/ydb-cli/windows.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
| Version | Release date | Download | Changelog |
22
:--- | :--- | :--- | :---
3+
| 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) |
34
| 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) |
45
| 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) |
56
| 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) |

ydb/docs/ru/core/changelog-cli.md

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,30 @@
22

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

5+
## Версия 2.19.0 {#2-19-0}
6+
7+
Дата выхода 5 февраля 2024. Для обновления до версии **2.19.0** перейдите в раздел [Загрузки](downloads/index.md#ydb-cli).
8+
9+
### Функциональность
10+
11+
* Добавлена поддержка [потоков изменений (changefeeds)](./concepts/cdc.md) при выполнении [команд](./reference/ydb-cli/export-import/tools-dump.md) `ydb tools dump` и `ydb tools restore`.
12+
* Добавлена рекомендация с текстом `CREATE TABLE` при схемной ошибке во время выполнения [команды](./reference/ydb-cli/export-import/import-file.md) `ydb import file csv`.
13+
* Добавлен вывод статистики для текущего процесса при выполнении [команды](./reference/ydb-cli/commands/workload/index.md) `ydb workload`.
14+
* Добавлен текст запроса к сообщению, если запрос завершился ошибкой при выполнении [команды](./reference/ydb-cli/commands/workload/index.md) `ydb workload run`.
15+
* Добавлено сообщение в случае ошибки истечения глобального таймаута при выполнении [команды](./reference/ydb-cli/commands/workload/index.md) `ydb workload run`.
16+
* **_(Требуется сервер v25.1+)_** Добавлена поддержка [представлений (VIEW)](./concepts/datamodel/view.md) при выполнении операций `ydb export s3` и `ydb import s3`. Представления экспортируются как YQL-выражение `CREATE VIEW`, которое выполняется при импорте.
17+
* **_(Требуется сервер v25.1+)_** Добавлена опция `--skip-checksum-validation` для [команды](./reference/ydb-cli/export-import/import-s3.md) `ydb import s3`, позволяющая отключить валидацию контрольной суммы на стороне сервера.
18+
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Для команды `ydb debug ping` добавлены новые опции: `--chain-length`, `--chain-work-duration`, `--no-tail-chain`.
19+
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Для команды `ydb admin storage fetch` добавлены новые опции: `--dedicated-storage-section` and `--dedicated-cluster-section`.
20+
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Для команды `ydb admin storage replace` добавлены новые опции: `--filename`, `--dedicated-cluster-yaml`, `--dedicated-storage-yaml`, `--enable-dedicated-storage-section` and `--disable-dedicated-storage-section`.
21+
22+
### Исправления ошибок
23+
24+
* Исправлена ошибка, из-за которой [команда](./reference/ydb-cli/commands/service.md) `ydb update` в arm64-версии исполняемого файла YDB CLI скачивала и заменяла себя исполняемым файлом amd64-версии. Чтобы обновить ранее установленный YDB CLI до последней arm64-версии (а не amd64), его нужно переустановить.
25+
* [Команда](./reference/ydb-cli/commands/workload/index.md) `ydb workload run` теперь возвращает корректный код возврата.
26+
* Исправлена ошибка, из-за которой [команды](./reference/ydb-cli/workload-tpch.md) `ydb workload tpch import generator` и `ydb workload tpcds import generator` завершались с ошибкой из-за отсутствия необходимых таблиц в схеме.
27+
* Исправлена ошибка с обратными слешами при указании путей в [команде]](./reference/ydb-cli/commands/workload/index.md) `ydb workload` на Windows.
28+
529
## Версия 2.18.0 {#2-18-0}
630

731
Дата выхода 24 декабря 2024. Для обновления до версии **2.18.0** перейдите в раздел [Загрузки](downloads/index.md#ydb-cli).
@@ -11,9 +35,10 @@
1135
* Добавлена поддержка [представлений (VIEW)](./concepts/datamodel/view) при выполнении операций резервного копирования `ydb tools dump` и восстановления `ydb tools restore`. Представления сохраняются в файл "create_view.sql" в виде запросов `CREATE VIEW`, которые будут выполнены для восстановления.
1236
* В [команду](./reference/ydb-cli/workload-topic#run-write) `ydb workload topic run` добавлены опции `--tx-commit-interval` и `--tx-commit-messages`, которые задают интервал между коммитами транзакций в миллисекундах и в количестве записанных сообщений соответственно.
1337
* В [команде](./reference/ydb-cli/topic-read) `ydb topic read` параметр `--consumer` перестал быть обязательным. В режиме чтения без подписчика обязательно должны быть указаны идентификаторы партиций с помощью параметра `--partition-ids`. Чтение в этом случае выполняется без сохранения коммита оффсетов.
14-
* [Команда](./reference/ydb-cli/export-import/import-file) `ydb import file csv` теперь сохраняет прогресс выполнения. Повторный запуск команды импорта продолжится с той строки, на которой она была прервана.
38+
* [Команда](./reference/ydb-cli/export-import/import-file.md) `ydb import file csv` теперь сохраняет прогресс выполнения. Повторный запуск команды импорта продолжится с той строки, на которой она была прервана.
1539
* В командах `ydb workload kv` и `ydb workload stock` значение параметра `--executer` по умолчанию изменено на "generic", благодаря чему они больше не используют устаревшую инфраструктуру выполнения запросов.
1640
* Изменен формат загрузки данных в таблицы для нагрузочных тестов `ydb workload` с CSV на Parquet.
41+
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Добавлена команда `ydb admin storage` с подкомандами `fetch` и `replace` для управления конфигурацией хранилища сервера.
1742

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

@@ -28,6 +53,10 @@
2853

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

56+
### Функциональность
57+
58+
* **_(Требуется сервер v25.1+)_** **_(Экспериментально)_** Добавлена команда `ydb debug ping` для проверки производительности и связанности.
59+
3160
### Производительность
3261

3362
* Улучшена производительность [параллельного восстановления из файловой системы](./reference/ydb-cli/export-import/tools-restore.md) с помощью команды `{{ ydb-cli }} tools restore`.

ydb/docs/ru/core/downloads/_includes/ydb-cli/darwin_amd64.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
Используйте бинарный файл amd64, если ваш Mac на базе процессора Intel.
22
Версия | Дата выпуска | Скачать | Список изменений
33
:--- | :--- | :--- | :---
4+
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)
45
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)
56
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)
67
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)

ydb/docs/ru/core/downloads/_includes/ydb-cli/darwin_arm64.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
Используйте бинарный файл arm64, если ваш Mac на базе процессора Apple Silicon (M1, M2 или более поздние).
22
Версия | Дата выпуска | Скачать | Список изменений
33
:--- | :--- | :--- | :---
4+
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)
45
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)
56
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)
67
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)

0 commit comments

Comments
 (0)