Merge 007ffe5 into f6e8a74

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

@@ -1,5 +1,33 @@
 # {{ ydb-short-name }} CLI changelog
 
+## Version 2.19.0 {#2-19-0}
+
+Released on February 4, 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.
+
+{% note info "Following changes require YDB server of version 25.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.
+* 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.
+* Added new experimental options for the `ydb debug ping` command: `--chain-length`, `--chain-work-duration`, `--no-tail-chain`.
+
+{% endnote %}
+
+### 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.
@@ -9,7 +37,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.
 
@@ -27,6 +55,14 @@ 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
+
+{% note info "Following changes require YDB server of version 25.1+" %}
+
+* Added `ydb debug ping` command for performance and connectivity debugging
+
+{% endnote %}
+
 ### 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.

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

@@ -1,6 +1,7 @@
 Use the amd64 binary if you have an Intel-based Mac.
 | Version | Release date | Download | Changelog |
 :--- | :--- | :--- | :---
+| v.2.19.0 | 04/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) |

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

@@ -1,6 +1,7 @@
 Use the arm64 binary if you have an M-series Mac.
 | Version | Release date | Download | Changelog |
 :--- | :--- | :--- | :---
+| v.2.19.0 | 04/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) |

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

@@ -1,5 +1,6 @@
 | Version | Release date | Download | Changelog |
 :--- | :--- | :--- | :---
+| v.2.19.0 | 04/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) |

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

@@ -1,5 +1,6 @@
 | Version | Release date | Download | Changelog |
 :--- | :--- | :--- | :---
+| v.2.19.0 | 04/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) |

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

@@ -1,5 +1,6 @@
 | Version | Release date | Download | Changelog |
 :--- | :--- | :--- | :---
+| v.2.19.0 | 04/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) |

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

@@ -2,6 +2,34 @@
 
 # Список изменений {{ ydb-short-name }} CLI
 
+## Версия 2.19.0 {#2-19-0}
+
+Дата выхода 4 февраля 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`.
+
+{% note info "Следующие изменения требуют версию сервера YDB 25.1+" %}
+
+* Добавлена поддержка [представлений (VIEW)](./concepts/datamodel/view.md) при выполнении операций `ydb export s3` и `ydb import s3`. Представления экспортируются как YQL-выражение `CREATE VIEW`, которое выполняется при импорте.
+* Добавлена опция `--skip-checksum-validation` для [команды](./reference/ydb-cli/export-import/import-s3.md) `ydb import s3`, позволяющая отключить валидацию контрольной суммы на стороне сервера.
+* Добавлены новые экспериментальные опции `--chain-length`, `--chain-work-duration`, `--no-tail-chain` для команды `ydb debug ping`.
+
+{% endnote %}
+
+### Исправления ошибок
+
+* Исправлена ошибка, из-за которой [команда](./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).
@@ -11,7 +39,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.
 
@@ -28,6 +56,14 @@
 
 Дата выхода 4 декабря 2024. Для обновления до версии **2.17.0** перейдите в раздел [Загрузки](downloads/index.md#ydb-cli).
 
+### Функциональность
+
+{% note info "Следующие изменения требуют версию сервера YDB 25.1+" %}
+
+* Добавлена команда `ydb debug ping` для проверки производительности и внутренней связности сервера
+
+{% endnote %}
+
 ### Производительность
 
 * Улучшена производительность [параллельного восстановления из файловой системы](./reference/ydb-cli/export-import/tools-restore.md) с помощью команды `{{ ydb-cli }} tools restore`.

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

@@ -1,6 +1,7 @@
 Используйте бинарный файл amd64, если ваш Mac на базе процессора Intel.
 Версия | Дата выпуска | Скачать | Список изменений
 :--- | :--- | :--- | :---
+v.2.19.0 | 04.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)

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

@@ -1,6 +1,7 @@
 Используйте бинарный файл arm64, если ваш Mac на базе процессора Apple Silicon (M1, M2 или более поздние).
 Версия | Дата выпуска | Скачать | Список изменений
 :--- | :--- | :--- | :---
+v.2.19.0 | 04.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)

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

@@ -1,5 +1,6 @@
 Версия | Дата выпуска | Скачать | Список изменений
 :--- | :--- | :--- | :---
+v.2.19.0 | 04.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)