Список изменений YDB CLI
- Версия 2.26.0
- Версия 2.25.0
- Версия 2.24.1
- Версия 2.24.0
- Версия 2.23.0
- Версия 2.22.1
- Версия 2.22.0
- Версия 2.21.0
- Версия 2.20.0
- Версия 2.19.0
- Версия 2.18.0
- Версия 2.17.0
- Версия 2.16.0
- Версия 2.10.0
- Версия 2.9.0
- Версия 2.8.0
- Версия 2.7.0
- Версия 2.6.0
- Версия 2.5.0
- Версия 2.4.0
- Версия 2.3.0
- Версия 2.2.0
- Версия 2.1.1
- Версия 2.1.0
- Версия 2.0.0
- Версия 1.9.1
Версия 2.26.0
Дата выхода 25 сентября 2025. Для обновления до версии 2.26.0 перейдите в раздел Загрузки.
Функциональность
- Добавлены опции
--no-mergeи--no-cacheв командуydb monitoring healthcheck. - Добавлена статистика времени компиляции запроса в команды
ydb workload * run. - Добавлена опция
--retriesв командуydb tools restore, позваляющая задать количество повторных попыток для каждого запроса загрузки данных. - (Требуется сервер v25.4+) Добавлена опция
--replace-sys-aclв командуydb tools restore, которая задаёт, нужно ли заменять ACL для системных объектов.
Версия 2.25.0
Дата выхода 1 сентября 2025. Для обновления до версии 2.25.0 перейдите в раздел Загрузки.
Функциональность
- Добавлена финальная статистика выполнения в команды
ydb workload * run. - Добавлена опция
--start-offsetв командуydb topic read, которая задаёт начальную позицию для чтения из выбранной партиции. - (Требуется сервер v25.3+) Добавлен новый способ указания путей в командах
ydb export s3иydb import s3с новой опцией--includeвместо опции--item. - (Требуется сервер v25.3+) Добавлена поддержка функций шифрования в командах
ydb export s3иydb import s3. - (Требуется сервер v25.3+) (Экспериментально) Добавлены команды
ydb admin cluster bridgeдля управления кластером в режиме bridge:list,switchover,failover,takedown,rejoin.
Улучшения
- Опции аутентификации по имени пользователя и паролю теперь обрабатываются независимо, что позволяет получать их из разных источников приоритета. Например, имя пользователя можно указать с помощью опции
--user, а пароль получить из переменной окруженияYDB_PASSWORD. - Изменён уровень логирования по умолчанию с
EMERGENCYнаWARNдля команд, поддерживающих несколько уровней логирования.
Изменения с потерей обратной совместимости
- Удалена опция
--float-modeиз командydb workload tpch runиydb workload tpcds run. Режим работы с вещественными числами теперь определяется автоматически из схемы таблицы, созданной во время фазыinit.
Исправления ошибок
- Исправлена ошибка, при которой команда
ydb import file csvс опцией--newline-delimitedмогла зависать при некорректных входных данных. - Исправлена ошибка с отображением прогресс-бара в команде
ydb workload clickbench import files— неправильное процентное значение и избыточные переносы строк, приводящие к дублированию строк прогресса. - Исправлена ошибка, при которой команда
ydb workload topic writeмогла завершаться аварийно с ошибкойUnknown AckedMessageIdиз-за внутреннего состояния гонки. - Исправлено сравнение десятичных типов в командах
ydb workload * run.
Версия 2.24.1
Дата выхода 28 июля 2025. Для обновления до версии 2.24.1 перейдите в раздел Загрузки.
Исправления ошибок
- Исправлена ошибка, при которой команда
ydb tools dumpбез уведомления пропускала объекты схемы неподдерживаемых типов и создавала для них пустые директории в целевой папке на файловой системе.
Версия 2.24.0
Дата выхода 23 июля 2025. Для обновления до версии 2.24.0 перейдите в раздел Загрузки.
Функциональность
- Добавлена возможность для команд
ydb workload tpchиydb workload tpcdsиспользовать опцию--scalec дробным значением, что позволяет задавать долю от полного объёма данных и нагрузки бенчмарка. - Добавлена команда
ydb workload tpcc checkдля проверки целостности данных TPC-C.
Улучшения
- Тип хранения по умолчанию в командах
ydb workload * initизменён наcolumn(былоrow), а режим работы с датой и временем по умолчанию — наdatetime32(былоdatetime64).
Исправления ошибок
- Исправлена проблема, из-за которой команда
ydb import file csvмогла зависать.
Версия 2.23.0
Дата выхода 16 июля 2025. Для обновления до версии 2.23.0 перейдите в раздел Загрузки.
Функциональность
- Добавлена команда
ydb workload tpccдля проведения нагрузочного тестирования TPC-C. - Добавлена команда
ydb workload vector selectдля тестирования производительности и полноты векторного индекса. - Добавлена команда
ydb tools infer csvдля генерации SQL-запросаCREATE TABLEна основе CSV-файла с данными.
Улучшения
- Расширена обработка специальных значений (
null,/dev/null,stdout,cout,console,stderr,cerr) для опции--outputв командахydb workload * run. - Команды
ydb workloadтеперь работают с абсолютными путями до объектов схемы в базе данных. - Улучшения в интерактивном режиме выполнения запросов
ydb:- Добавлена проверка соединения с сервером и описание горячих клавиш.
- Улучшены inline-подсказки.
- Добавлено автодополнение имён столбцов таблицы.
- Добавлено кеширование схемы таблиц.
Исправления ошибок
- Исправлена ошибка, из-за которой команда
ydb tools restoreне работала на Windows.
Версия 2.22.1
Дата выхода 17 июня 2025. Для обновления до версии 2.22.1 перейдите в раздел Загрузки.
Исправления ошибок
- Исправлена ошибка, из-за которой сертификат не читался из файла, если путь к файлу указан в профиле в поле
ca-file. - Исправлена ошибка, из-за которой команды
ydb workload query importиydb workload clickbench import filesв состоянии отображали количество строк вместо количества байт.
Версия 2.22.0
Дата выхода 4 июня 2025. Для обновления до версии 2.22.0 перейдите в раздел Загрузки.
Функциональность
- Добавлено автодополнение имён схемных объектов в интерактивном режиме.
- Расширены возможности команды
ydb workload query: добавлены командыydb workload query init,ydb workload query importиydb workload query cleanи изменена командаydb workload query run. Пользуясь ими можно инициализировать таблицы, заполнить их данными, провести нагрузочное тестирование и очистить данные за собой. - В команды
ydb workload clickbench run,ydb workload tpch run,ydb workload tpcds runдобавлена опция--threads, позволяющая указывать количество потоков для отправки запросов. - (Требуется сервер v25.1+) (Экспериментально) Добавлена команда
ydb admin cluster config versionдля отображения версии конфигурации (V1/V2) на узлах.
Изменения с потерей обратной совместимости
- Из команд
ydb workload * runудалена опция--executor. Теперь всегда используется исполнительgeneric.
Исправления ошибок
- Исправлена ошибка, из-за которой команды
ydb workload * cleanудаляли все содержимое целевой директории, а не только таблицы, созданные командой init.
Версия 2.21.0
Дата выхода 22 мая 2024. Для обновления до версии 2.21.0 перейдите в раздел Загрузки.
Функциональность
- Добавлен глобальный параметр
--no-discovery, позволяющий пропустить процесс discovery и подключиться напрямую к указанному пользователем эндпоинту. - Добавлены новые опции для команд нагрузочного тестирования:
- Добавлена опция
--scaleв командыydb workload tpch initиydb workload tpcds initдля установки процента размера данных и нагрузки относительно максимальной нагрузки. - Добавлена опция
--retriesв командыydb workload <clickbench|tpch|tpcds> runдля указания максимального количества повторов каждого запроса. - Добавлена опция
--partition-sizeв командыydb workload <clickbench|tpcds|tpch> initдля установки максимального размера партиции в мегабайтах для строчных таблиц. - Добавлены параметры диапазона дат (
--date-to,--date-from) в операцииydb workload log runдля поддержки равномерного распределения первичных ключей.
- Добавлена опция
- Улучшена функциональность резервного копирования и восстановления:
- Добавлены опции
--replaceи--verify-existenceв командуydb tools restoreдля управления удалением существующих объектов, совпадающих с объектами в резервной копии, перед восстановлением. - Улучшена команда
ydb tools dump: таблицы-реплики у ASYNC REPLICATION и их потоки изменений не сохраняются в локальные резервные копии. Это предотвращает дублирование потоков изменений и уменьшает размер резервной копии на диске.
- Добавлены опции
- Изменения, повышающие удобство использования CLI:
- Вывод подробной справки (
-hh) теперь показывает всё дерево подкоманд. - Добавлена автоматическая вставка парных скобок в интерактивном режиме
ydb. - Добавлена поддержка файлов с BOM (Byte Order Mark) в командах
ydb import file.
- Вывод подробной справки (
- (Требуется сервер v25.1+) (Экспериментально) Улучшена команда
ydb debug latency:- Добавлен параметр
--min-inflightдля установки минимального количества одновременных запросов (по умолчанию: 1). - Добавлена опция
--percentileдля указания пользовательских процентилей задержки. - Вывод команды расширен дополнительными измерениями GRPC ping.
- Добавлен параметр
Исправления ошибок
- Команда
ydb operation getтеперь корректно отображает операции, которые ещё находятся в процессе выполнения. - Исправлены ошибки в команде
ydb scheme rmdir:- Исправлена ошибка, из-за которой команда пыталась удалить поддомены.
- Исправлен порядок удаления: внешние таблицы теперь удаляются перед источниками данных из-за возможных зависимостей между ними.
- Добавлена поддержка coordination nodes при рекурсивном удалении.
- Исправлен код возврата команды
ydb workload * run --check-canonicalпри несовпадении результатов с каноническими. - Исправлена проблема, когда CLI пытался читать параметры из stdin даже при отсутствии данных.
- (Требуется сервер v25.1+) (Экспериментально) Исправлена ошибка авторизации при выполнении команды
ydb admin database restoreпри наличии нескольких учетных записей администраторов базы данных в восстанавливаемой резервной копии.
Версия 2.20.0
Дата выхода 5 марта 2024. Для обновления до версии 2.20.0 перейдите в раздел Загрузки.
Функциональность
- Добавлена поддержка топиков при выполнении команд
ydb tools dumpиydb tools restore. - Добавлена поддержка узлов координации при выполнении команд
ydb tools dumpиydb tools restore. - Добавлена новая команда
ydb workload log import generator. - Добавлены новые глобальные опции для пользовательских сертификатов при соединении через SSL/TLS:
--client-cert-file: файл, содержащий пользовательский сертификат для SSL/TLS соединения, закодированный в PEM или PKCS#12.--client-cert-key-file: файл, содержащий приватный ключ к пользовательскому сертификату, закодированный в PEM.--client-cert-key-password-file: файл, содержащий пароль для приватного ключа пользовательского сертификата.
- Запросы при выполнении команды
ydb workload runтеперь отправляются на сервер в произвольном порядке. - (Требуется сервер v25.1+) Добавлена поддержка внешних источников данных и внешних таблиц при выполнении команд
ydb tools dumpиydb tools restore. - (Экспериментально) Добавлена команда
ydb admin node config initдля инициализации директории с конфигурационными файлами узла. - (Требуется сервер v25.1+) (Экспериментально) Добавлена команда
ydb admin cluster config generateдля генерации файла конфигурации V2 из файла конфигурации V1. - (Требуется сервер v25.1+) (Экспериментально) Добавлены команда
ydb admin cluster dumpи командаydb admin cluster restoreдля создания дампа кластера. Дамп кластера содержит список баз данных с метаданными, пользователей и группы, но не содержит схемные объекты. - (Требуется сервер v25.1+) (Экспериментально) Добавлены команды
ydb admin database dumpиydb admin database restoreдля создания дампа базы данных. Такой дамп содержит метаданные базы данных, схемные объекты, данные в них, пользователей и группы. - (Требуется сервер v25.1+) (Экспериментально) Для команды
ydb admin cluster config fetchдобавлены новые опции--dedicated-storage-sectionи--dedicated-cluster-section, позволяющие получать части конфигурации для кластера и хранилища отдельно.
Исправления ошибок
- Исправлена ошибка, из-за которой дважды отправлялся запрос аутентификации в команде
ydb auth get-tokenпри получении списка эндпойнтов (Discovery запрос) и при фактическом выполнении запроса на получение токена. - Исправлена ошибка в команде
ydb import file csv, при которой прогресс импорта сохранялся даже если отправка пакета данных завершилась ошибкой. - Исправлена ошибка, из-за которой при выполнении команды
ydb tools restoreнекоторые ошибки игнорировались. - Исправлена утечка памяти при генерации данных для
ydb workload tpcds.
Версия 2.19.0
Дата выхода 5 февраля 2025. Для обновления до версии 2.19.0 перейдите в раздел Загрузки.
Функциональность
-
Добавлена поддержка потоков изменений (changefeeds) при выполнении команд
ydb tools dumpиydb tools restore. -
Добавлена рекомендация с текстом
CREATE TABLEпри схемной ошибке во время выполнения командыydb import file csv. -
Добавлен вывод статистики для текущего процесса при выполнении команды
ydb workload. -
Добавлен текст запроса к сообщению, если запрос завершился ошибкой при выполнении команды
ydb workload run. -
Добавлено сообщение в случае ошибки истечения глобального таймаута при выполнении команды
ydb workload run. -
(Требуется сервер v25.1+) Добавлена поддержка представлений (VIEW) при выполнении операций
ydb export s3иydb import s3. Представления экспортируются как YQL-выражениеCREATE VIEW, которое выполняется при импорте. -
(Требуется сервер v25.1+) Добавлена опция
--skip-checksum-validationдля команды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и--dedicated-cluster-section. -
(Требуется сервер v25.1+) (Экспериментально) Для команды
ydb admin storage replaceдобавлены новые опции:--filename,--dedicated-cluster-yaml,--dedicated-storage-yaml,--enable-dedicated-storage-sectionи--disable-dedicated-storage-section.
Исправления ошибок
- Исправлена ошибка, из-за которой команда
ydb updateв arm64-версии исполняемого файла YDB CLI скачивала и заменяла себя исполняемым файлом amd64-версии. Чтобы обновить ранее установленный YDB CLI до последней arm64-версии (а не amd64), его нужно переустановить. - Команда
ydb workload runтеперь возвращает корректный код возврата. - Исправлена ошибка, из-за которой команды
ydb workload tpch import generatorиydb workload tpcds import generatorзавершались с ошибкой из-за отсутствия необходимых таблиц в схеме. - Исправлена ошибка с обратными слешами при указании путей в [команде]](./reference/ydb-cli/commands/workload/index.md)
ydb workloadна Windows.
Версия 2.18.0
Дата выхода 24 декабря 2024. Для обновления до версии 2.18.0 перейдите в раздел Загрузки.
Функциональность
- Добавлена поддержка представлений (VIEW) при выполнении операций резервного копирования
ydb tools dumpи восстановленияydb tools restore. Представления сохраняются в файл "create_view.sql" в виде запросовCREATE VIEW, которые будут выполнены для восстановления. - В команду
ydb workload topic runдобавлены опции--tx-commit-intervalи--tx-commit-messages, которые задают интервал между коммитами транзакций в миллисекундах и в количестве записанных сообщений соответственно. - В команде
ydb topic readпараметр--consumerперестал быть обязательным. В режиме чтения без подписчика обязательно должны быть указаны идентификаторы партиций с помощью параметра--partition-ids. Чтение в этом случае выполняется без сохранения коммита оффсетов. - Команда
ydb import file csvтеперь сохраняет прогресс выполнения. Повторный запуск команды импорта продолжится с той строки, на которой она была прервана. - В командах
ydb workload kvиydb workload stockзначение параметра--executerпо умолчанию изменено на "generic", благодаря чему они больше не используют устаревшую инфраструктуру выполнения запросов. - Изменен формат загрузки данных в таблицы для нагрузочных тестов
ydb workloadс CSV на Parquet. - (Требуется сервер v25.1+) (Экспериментально) Добавлена команда
ydb admin storageс подкомандамиfetchиreplaceдля управления конфигурацией хранилища сервера.
Изменения с потерей обратной совместимости
- В команде
ydb workload * runпараметр--query-settingsзаменен на--query-prefix.
Исправления ошибок
- Исправлена ошибка, из-за которой команда
ydb workload * runв режиме--dry-runмогла приводить к сбою. - Исправлена ошибка в
ydb import file csv, из-за которой несколько столбцов с экранированными кавычками в одной строке обрабатывались неправильно.
Версия 2.17.0
Дата выхода 4 декабря 2024. Для обновления до версии 2.17.0 перейдите в раздел Загрузки.
Функциональность
- (Требуется сервер v25.1+) (Экспериментально) Добавлена команда
ydb debug pingдля проверки производительности и связанности.
Производительность
- Улучшена производительность параллельного восстановления из файловой системы с помощью команды
ydb tools restore.
Исправления ошибок
- Исправлена ошибка в схеме таблиц, созданных командой
ydb workload tpch, из-за которой таблицаpartsuppсодержала неверный список ключевых столбцов. - Исправлена ошибка, из-за которой команда
ydb tools restoreзавершалась с ошибкойToo much data, если было установлено максимальное значение параметра--upload-batchbytes(16MB).
Версия 2.16.0
Дата выхода 26 ноября 2024. Для обновления до версии 2.16.0 перейдите в раздел Загрузки.
Функциональность
- Увеличена пропускная способность команды
ydb import file csvпримерно в 3 раза. - Добавлена поддержка stock-нагрузки для колоночных таблиц.
- Реализована поддержка временных меток в формате ISO 8601 для команд
ydb topic. - В команду
ydb sqlдобавлена опция--explain-ast, которая выводит AST запроса. - Добавлена подсветка синтаксиса ANSI SQL в интерактивном режиме.
- В команды
ydb workload tpchиydb workload tpcdsдобавлена поддержка синтаксиса PostgreSQL. - В команду
ydb workload tpcds runдобавлена опция-cдля сравнения результата с ожидаемым значением и отображения различий. - В команды
ydb tools dumpиydb tools restoreдобавлено логирование событий. - В команду
ydb tools restoreдобавлено указание места возникновения ошибки.
Изменения с потерей обратной совместимости
- В команде
ydb topic writeдля опции--codecзначение по умолчанию изменено наRAW.
Исправления ошибок
- Исправлен progress bar для команды
ydb workload import. - Устранена ошибка восстановления из резервной копии с использованием опции
--import-data, возникавшая при изменении партиционирования таблицы.
Версия 2.10.0
Дата выхода 24 июня 2024. Для обновления до версии 2.10.0 перейдите в раздел Загрузки.
Функциональность
-
Добавлена команда
ydb sql, работающая поверх QueryService, позволяющая выполнять любые DML/DDL команды. -
Добавлен режим
notxдля опции--tx-modeв командеydb table query execute. -
Добавлены времена начала и конца в описании длительных операций (export, import).
-
Добавлена поддержка описания объектов типа replication в командах
ydb scheme describeиydb scheme ls. -
Добавлена поддержка типов big datetime:
Date32,Datetime64,Timestamp64,Interval64. -
Переработана команда
ydb workload:- Добавлена опция
--clearв подкомандеinit, позволяющая удалить все существующие таблицы перед созданием новых. - Добавлена команда
ydb workload * importдля заполнения таблиц начальным контентом перед началом нагрузки.
- Добавлена опция
Изменения с потерей обратной совместимости
-
Переработана команда
ydb workload:- Опция
--pathперемещена на уровень конкретного типа нагрузки. Например:ydb workload tpch --path some/tables/path init .... - Значение опции
--store=s3переименовано в--store=external-s3в подкомандеinit.
- Опция
Исправления ошибок
- Исправлена работа с цветовыми схемами в формате
PrettyTable
Версия 2.9.0
Дата выхода 25 апреля 2024. Для обновления до версии 2.9.0 перейдите в раздел Загрузки.
Функциональность
- Улучшены таблицы с логическими планами запросов: стали информативнее, добавлены цвета, исправлены некоторые ошибки.
- Для команды
ydb workloadподдержана опция-v, включающая вывод отладочной информации. - Добавлена возможность запустить
ydb workload tpch --store s3с источником s3 для измерения производительности федеративных запросов. - Добавлена опция
--rateдля командыydb workloadдля ограничения количества транзакций (запросов) в секунду. - Добавлена опция
--use-virtual-addressingдля импорта/экспорта s3, позволяющая переключить режим virtual hosting of buckets для схемы путей s3. - Улучшена производительность команды
ydb scheme lsпараллельным запуском листингов директорий.
Исправления ошибок
- Исправлено обрезание лишних символов при переносе строк в таблицах CLI
- Исправлена ошибка обращения к памяти в команде
tools restore. - Исправлено игнорирование опции
--timeoutв generic и scan запросах. - Добавлен таймаут 60s на проверку версии и скачивание бинарного файла CLI для избежания бесконечного ожидания.
- Исправлен ряд незначительных ошибок: опечатки, обработка пустых файлов и т.д.
Версия 2.8.0
Дата выхода 12 января 2024. Для обновления до версии 2.8.0 перейдите в раздел Загрузки.
Функциональность
- Добавлены команды управления конфигурациями кластера ydb admin config и ydb admin volatile-config.
- Добавлена поддержка загрузки PostgreSQL-совместимых типов командой ydb import file csv|tsv|json. Только для строковых таблиц.
- Добавлена поддержка загрузки директории из S3-совместимого хранилища в команде ydb import s3. Пока доступна только под Linux и Mac OS.
- Добавлена поддержка вывода результата выполнения команд ydb table query execute, ydb yql и ydb scripting yql в формате Apache Parquet.
- В командах ydb workload добавлена опция
--executer, задающая используемый тип запросов. - Добавлена колонка медианного времени выполнения бенчмарка в таблице статистики в команде ydb workload clickbench.
- (Experimental) Добавлен тип запросов
genericв команде ydb table query execute, позволяющий выполнять DDL и DML операции, с результатами произвольного размера и c поддержкой MVCC. Команда использует экспериментальное API, совместимость не гарантируется. - (Experimental) В команде
ydb table query explainдобавлена опция--collect-diagnosticsдля сбора диагностики запроса и сохранения её в файл. Команда использует экспериментальное API, совместимость не гарантируется.
Исправления ошибок
- Исправлена ошибка вывода таблиц в
prettyформате с Unicode символами. - Исправлена ошибка подстановки неправильного первичного ключа в команде ydb tools pg-convert.
Версия 2.7.0
Дата выхода 23 октября 2023. Для обновления до версии 2.7.0 перейдите в раздел Загрузки.
Функциональность
- Добавлена команда ydb tools pg-convert, выполняющая подготовку дампа, полученного утилитой pg_dump, к загрузке в postgres-совместимую прослойку YDB.
- Добавлена команда нагрузочного тестирования
ydb workload query, которая нагружает базу запросами выполнения скрипта в несколько потоков. - Добавлена команда для просмотра списка разрешений
ydb scheme permissions list. - В командах ydb table query execute, ydb table query explain, ydb yql и ydb scripting yql добавлена опция
--flame-graph, задающая путь до файла, в котором необходимо сохранить визуализацию статистики выполнения запросов. - Специальные команды интерактивного режима выполнения запросов теперь не чувствительны к регистру.
- Добавлена валидация специальных команд и их параметров.
- Добавлено чтение из таблицы в сценарии с транзакциями в команде ydb workload transfer topic-to-table run.
- Добавлена опция
--commit-messagesв команде ydb workload transfer topic-to-table run, задающая число сообщений в одной транзакции. - Добавлены опции
--only-table-in-txи--only-topic-in-txв команде ydb workload transfer topic-to-table run, задающие ограничения на виды запросов в одной транзакции. - Добавлены новые колонки
Select timeиUpsert timeв таблице статистики в команде ydb workload transfer topic-to-table run.
Исправления ошибок
- Исправлена ошибка при загрузке пустого JSON списка командами ydb table query execute, ydb scripting yql и ydb yql.
Версия 2.6.0
Дата выхода 7 сентября 2023. Для обновления до версии 2.6.0 перейдите в раздел Загрузки.
Функциональность
- В ydb workload tpch run добавлена опция
--path, содержащая путь до директории с таблицами, созданными командой ydb workload tpch init. - Добавлена команда ydb workload transfer topic-to-table, которая нагружает базу запросами на чтение из топиков и запись в таблицу.
- Добавлена опция
--consumer-prefixв командax ydb workload topic init, ydb workload topic run read|full, задающая префиксы имен читателей. - Добавлена опция
--partition-idsв команде ydb topic read, задающая список id партиций топика для чтения, разделенных запятой. - Добавлена поддержка форматов параметров CSV и TSV в командах исполнения YQL запросов.
- Переработан интерактивный режим выполнения запросов. Добавлены новые специфичные команды интерактивного режима:
SET stats,EXPLAIN,EXPLAIN AST. Добавлены сохранение истории между запусками CLI и автодополнение YQL запросов. - Добавлена команда ydb config info, которая выводит текущие параметры соединения без подключения к базе данных.
- Добавлена команда ydb workload kv run mixed, которая нагружает базу запросами на запись и чтение.
- Опция
--percentileв командах ydb workload topic run write|read|full теперь может принимать вещественные значения. - Увеличены значения по умолчанию для опций
--secondsи--warmupв командах ydb workload topic run write|read|full до 60 секунд и 5 секунд соответственно. - Изменено значение по умолчанию для опции
--supported-codecsнаRAWв командах ydb topic create и ydb topic consumer add.
Исправления ошибок
- Исправлена потеря строк при загрузке командой ydb import file json.
- Исправлен неучет статистики во время прогрева команд ydb workload topic run write|read|full.
- Исправлен неполный вывод статистики в командах ydb scripting yql и ydb yql.
- Исправлен неправильный вывод progress bar'a в командах ydb tools dump и ydb tools restore.
- Исправлена ошибка загрузки больших файлов с заголовком в команде ydb import file csv|tsv.
- Исправлено зависание команды ydb tools restore --import-data.
- Исправлена ошибка
Unknown value Rejectedпри выполнении команды ydb operation list buildindex.
Версия 2.5.0
Дата выхода 20 июня 2023. Для обновления до версии 2.5.0 перейдите в раздел Загрузки.
Функциональность
- Для команды
ydb import fileдобавлен параметр --timeout, задающий время, в течение которого должна быть выполнена операция на сервере. - Добавлен индикатор прогресса в командах ydb scheme rmdir --recursive и ydb import file.
- Добавлена команда ydb workload kv run read-rows, которая нагружает базу запросами на чтение строк, используя новый экспериментальный API вызов ReadRows (реализован только в ветке main), выполняющий более быстрое чтение по ключу, чем select.
- В ydb workload topic добавлены новые параметры
--warmup-time,--percentile,--topic, задающие время прогрева теста, процентиль в выводе статистики и имя топика соответственно. - Добавлена команда ydb workload tpch для запуска нагрузочного теста TPC-H.
- Добавлен флаг
--orderedв команде ydb tools dump, сохраняющий порядок по первичному ключу в таблицах.
Производительность
- Увеличена скорость загрузки данных в команде
ydb import fileза счет добавления параллельной загрузки. Число потоков задается новым параметром --threads. - Увеличена производительность команды ydb import file json, за счет уменьшения числа копирований данных.
Версия 2.4.0
Дата выхода 24 мая 2023. Для обновления до версии 2.4.0 перейдите в раздел Загрузки.
Функциональность
- Добавлена возможность загрузки нескольких файлов командой ydb import file.
- Добавлена поддержка удаления колоночных таблиц для команды ydb scheme rmdir --recursive.
- Повышена стабильность работы команды ydb workload topic.
Версия 2.3.0
Дата выхода 1 мая 2023. Для обновления до версии 2.3.0 перейдите в раздел Загрузки.
Функциональность
- Добавлен интерактивный режим выполнения запросов. Для перехода в интерактивный режим выполните команду ydb yql без аргументов. Режим экспериментальный, обратная совместимость пока не гарантируется.
- Добавлена команда ydb index rename для атомарной замены или переименования вторичного индекса.
- Добавлена команда
ydb workload topicдля запуска нагрузки, которая читает и записывает сообщения в топики. - Для команды
ydb scheme rmdirдобавлен параметр --recursive, который позволяет рекурсивно удалить директорию вместе со всем содержимым. - Для команды ydb scheme describe добавлена поддержка типов
topicиcoordination node. - Для команды
ydb topic consumerдобавлен параметр --commit для подтверждения прочитанных сообщений. - Для команды
ydb import file csv|tsvдобавлен параметр --columns, с помощью которого можно указать список колонок вместо заголовка в файле. - Для команды
ydb import file csv|tsvдобавлен параметр --newline-delimited, который подтверждает отсутствие символа переноса строки в данных. Использование этого параметра ускоряет импорт за счет параллельного чтения из нескольких секций файла.
Исправления ошибок
- Исправлена ошибка, которая приводила к повышенному потреблению памяти и процессора при выполнении команды
ydb import file.
Версия 2.2.0
Дата выхода 3 марта 2023. Для обновления до версии 2.2.0 перейдите в раздел Загрузки.
Функциональность
- Исправлена ошибка, когда невозможно было указать поддерживаемые алгоритмы сжатия при добавлении читателя топика.
- Добавлена поддержка потокового выполнения YQL-скриптов и запросов на основе параметров, передаваемых через
stdin. - Значения параметров YQL-запросов теперь могут быть переданы из файла.
- Запрос на ввод пароля теперь выводится в
stderrвместоstdout. - Путь к корневому CA сертификату теперь может быть сохранен в профиле.
- Добавлен глобальный параметр --profile-file для использования указанного файла в качестве хранилища для настроек профилей.
- Добавлен новый тип нагрузочного тестирования ydb workload clickbench.
Версия 2.1.1
Дата выхода 30 декабря 2022. Для обновления до версии 2.1.1 перейдите в раздел Загрузки.
Улучшения
- Добавлена поддержка параметра
--statsкоманды ydb scheme describe для колоночных таблиц. - Добавлена поддержка файлов в формате Parquet для импорта командой ydb import.
- Поддержаны дополнительное логирование и ретраи для команды ydb import.
Версия 2.1.0
Дата выхода 18 ноября 2022. Для обновления до версии 2.1.0 перейдите в раздел Загрузки.
Функциональность
- Добавлена возможность неинтерактивного создания профиля.
- Добавлены команды ydb config profile update и ydb config profile replace для изменения и замены профилей.
- Для команды ydb scheme ls добавлен параметр
-1, включающая режим вывода по одному объекту на строку. - URL сервиса IAM теперь можно сохранять в профиле.
- Добавлена возможность использовать аутентификацию по логину и паролю без указания пароля.
- Добавлена поддержка профилей AWS в команде ydb export s3.
- Добавлена возможность создания профиля используя
stdin. Например, можно передать вывод команды YC CLIyc ydb database get informationна вход командеydb config profile create.
Исправления ошибок
- Исправлена ошибка, когда некорректно выводился результат запроса в формате JSON-array, если он состоял из нескольких ответов сервера.
- Исправлена ошибка, приводящая к невозможности изменить профиль, используя при этом некорректный профиль.
Версия 2.0.0
Дата выхода 20 сентября 2022. Для обновления до версии 2.0.0 перейдите в раздел Загрузки.
Функциональность
-
Добавлена возможность работы с топиками:
ydb topic create— создание топика;ydb topic alter— изменение топика;ydb topic write— запись данных в топик;ydb topic read— чтение данных из топика;ydb topic drop— удаление топика.
-
Добавлен новый тип нагрузочного тестирования:
ydb workload kv init— создание таблицы для тестирования kv нагрузки;ydb workload kv run— запуск одной из 3 видов нагрузки: запуск нескольких сессий вставкиUPSERT, запуск нескольких сессий вставкиINSERTили запуск нескольких сессий с GET-запросами по первичному ключу;ydb workload kv clean— удаление тестовой таблицы.
-
Добавлена возможность деактивировать текущий активный профиль (см. команду
ydb config profile deactivate). -
Добавлена возможность неинтерактивного удаления профиля без подтверждения (см. параметр
--forceкомандыydb config profile remove). -
Добавлена поддержка CDC для команды
ydb scheme describe. -
Добавлена возможность просмотра текущего статуса БД (см. команду
ydb monitoring healthcheck). -
Добавлена возможность просмотра аутентификационной информации (токена), с которой будут отправляться запросы к БД при текущих настройках аутентификации (см. команду
ydb auth get-token). -
Добавлена возможность чтения данных из стандартного потока ввода для команды
ydb import. -
Добавлена возможность импорта данных в формате JSON из файла или стандартного потока ввода (см. команду
ydb import file json).
Улучшения
- Улучшен процессинг команд. Парсинг и валидация пользовательского ввода теперь более точные.
Версия 1.9.1
Дата выхода 25 июня 2022. Для обновления до версии 1.9.1 перейдите в раздел Загрузки.
Функциональность
- Добавлена возможность сжатия данных при экспорте в S3-совместимое хранилище (см. параметр
--compressionкоманды ydb export s3). - Добавлена возможность управления автоматической проверкой доступности новой версии YDB CLI (см. параметры
--disable-checksи--enable-checksкоманды ydb version).