Project: YDB (App Definition and Development / Database)
File: changelog-cli.md

Released on January 12, 2024. To update to version 2.8.0, select the section. Features: Added configuration management commands for the cluster `ydb admin config` and `ydb admin volatile-config`. Added support for loading PostgreSQL-compatible data types by command. Only for row-oriented tables. Added support for directory load from an S3-compatible storage in the command. Currently only available on Linux and Mac OS. Added support for outputting the results of , and commands in the format. In the commands, the `--executer` option has been added, which allows to specify which type of queries to use. Added a column with median benchmark execution time in the statistics table of the command. _(Experimental)_* Added the `generic` request type to the command, allowing to perform and operations, return with arbitrarily-sized results and support for . The command uses an experimental API, compatibility is not guaranteed. _(Experimental)_* In the `ydb table query explain` command, the `--collect-diagnostics` option has been added to collect query diagnostics and save it to a file. The command uses an experimental API, compatibility is not guaranteed. Bug fixes: Fixed an error displaying tables in `pretty` format with characters. Fixed an error substituting the wrong primary key in the command . Released on October 23, 2023. To update to version 2.7.0, select the section. Features: Added the command, which prepares a dump obtained by the utility for loading into the YDB postgres-compatible layer. Added the `ydb workload query` load testing command, which loads the database with in multiple threads. Added a command `ydb scheme permissions list` to list permissions. In the commands , , , and , the `--flame-graph` option has been added, specifying the path to the file in which you need to save the visualization of query execution statistics. in the interactive query execution mode are now case-insensitive. Added validation for and their . Added table reading in the scenario with transactions in the command . Added the `--commit-messages` option to the command , specifying the number of messages in a single transaction. Added the options `--only-table-in-tx` and `--only-topic-in-tx` in the command , specifying restrictions on the types of queries in a single transaction. Added new columns `Select time` and `Upsert time` in the statistics table in the command . Bug fixes: Fixed an error when loading an empty JSON list by commands: , and . Released on September 7, 2023. To update to version 2.6.0, select the section. Features: Added `--path` option to , which contains the path to the directory with tables created by the command. Added command, which loads the database with read requests from topics and write requests to the table. Added the option `--consumer-prefix` in the commands , , specifying prefixes of consumer names. Added the `--partition-ids` option in the command, which specifies a comma-separated list of topic partition identifiers to read from. Added support for CSV and TSV parameter formats in execution commands. The has been redesigned. Added : `SET`, `EXPLAIN`, `EXPLAIN AST`. Added saving history between CLI launches and auto-completion of YQL queries. Added the command , which outputs the current connection parameters without connecting to the database. Added the command , which loads the database with write and read requests. The `--percentile` option in the commands can now take floating point

The default values for the `--seconds` and `--warmup` options in the commands have been increased to 60 seconds and 5 seconds, respectively. Changed the default value for the `--supported-codecs` option to `RAW` in the and commands. Bug fixes: Fixed string loss when loading with the command. Fixed ignored statistics during the warm-up of commands . Fixed incomplete statistics output in the and commands. Fixed incorrect output of progress bar in and commands. Fixed loading large files with the header in the command. Fixed hanging of the command. Fixed error `Unknown value Rejected` when executing the command. Released on June 20, 2023. To update to version 2.5.0, select the section. Features: For the `ydb import file` command, a parameter has been added that specifies the time within which the operation should be performed on the server. Added a progress bar in commands and . Added the command , which loads the database with requests to read rows using a new experimental API call ReadRows (implemented only in the branch), which performs faster key reading than . New parameters `--warmup-time`, `--percentile`, `--topic` have been added to the , setting the test warm-up time, the percentile in the statistics output and the topic name, respectively. Added the command to run the TPC-H benchmark. Added the `--ordered` flag in the command , which preserves the order by primary key in tables. Performance: The data loading speed in the `ydb import file` command has been increased by adding parallel loading. The number of threads is set by the new parameter . A performance of the command has been increased by reducing the number of data copies. Released on May 24, 2023. To update to version 2.4.0, select the section. Features: Added the ability to upload multiple files in parallel with the command . Added support for deleting column tables for the command . Improved stability of the command . Release date: May 1, 2023. To update to version 2.3.0, select the section. Features: Added the interactive mode of query execution. To switch to the interactive mode, run without arguments. This mode is experimental: backward compatibility is not guaranteed yet. Added the command for or renaming of a secondary index. Added the `ydb workload topic` command for generating the load that reads messages from topics and writes messages to topics. Added the option for the `ydb scheme rmdir` command. Use it to delete a directory recursively, with all its content. Added support for the `topic` and `coordination node` types in the command. Added the option for the `ydb topic consumer` command. Use it to commit messages you have read. Added the option for the `ydb import file csv|tsv` command. Use it as an alternative to the file header when specifying a column list. Added the option for the `ydb import file csv|tsv` command. Use it to make sure that your data is newline-free. This option streamlines import by reading data from several file sections in parallel. Bug fixes: Fixed the bug that resulted in excessive memory and CPU utilization when executing the `ydb import file` command. Release date: March 3, 2023. To update to version 2.2.0, select the section. Features: Fixed the error that didn't allow specifying supported compression algorithms when adding a topic

Added support for streaming YQL scripts and queries based on options . You can now to provide YQL query options Password input requests are now output to `stderr` instead of `stdout`. You can now save the root CA certificate path in a . Added a global option named to use the specified file as storage for profile settings. Added a new type of load testing: . Release date: December 30, 2022. To update to version 2.1.1, select the section. Improvements: Added support for the `--stats` option of the command for column-oriented tables. Added support for Parquet files to enable their import with the command. Added support for additional logging and retries for the command. Release date: November 18, 2022. To update to version 2.1.0, select the section. Features: You can now . Added the and commands to update and replace profiles, respectively. Added the `-1` option for the command to enable output of a single object per row. You can now save the IAM service URL in a profile. Added support for username and password-based authentication without specifying the password. Added support for AWS profiles in the command. You can now create profiles using `stdin`. For example, you can pass the `yc ydb database get information` command output to the `ydb config profile create` command input. Bug fixes: Fixed the error when request results were output in JSON-array format incorrectly if they included multiple server responses. Fixed the error that disabled profile updates so that an incorrect profile was used. Release date: September 20, 2022. To update to version 2.0.0, select the section. Features: Added the ability to work with topics: `ydb topic create`: Create a topic. `ydb topic alter`: Update a topic. `ydb topic write`: Write data to a topic. `ydb topic read`: Read data from a topic. `ydb topic drop`: Delete a topic. Added a new type of load testing: `ydb workload kv init`: Create a table for kv load testing. `ydb workload kv run`: Apply one of three types of load: run multiple `UPSERT` sessions, run multiple `INSERT` sessions, or run multiple sessions of GET requests by primary key. `ydb workload kv clean`: Delete a test table. Added the ability to disable current active profile (see the `ydb config profile deactivate` command). Added the ability to delete a profile non-interactively with no commit (see the `--force` option under the `ydb config profile remove` command). Added CDC support for the `ydb scheme describe` command. Added the ability to view the current DB status (see the `ydb monitoring healthcheck` command). Added the ability to view authentication information (token) to be sent with DB queries under the current authentication settings (see the `ydb auth get-token` command). Added the ability for the `ydb import` command to read data from stdin. Added the ability to import data in JSON format from a file or stdin (see the `ydb import file json` command). Improvements: Improved command processing. Improved the accuracy of user input parsing and validation. Release date: June 25, 2022. To update to version 1.9.1, select the section. Features: Added the ability to compress data when exporting it to S3-compatible storage (see the `--compression` option of the command). Added the ability to manage new {{ ydb-short-name }} CLI version availability auto checks (see the `--disable-checks` and `--enable-checks` options of the command).