clickhousectl (chctl) — это единый интерфейс командной строки (CLI) для ClickHouse и Postgres, который работает как на вашем ноутбуке, так и в ClickHouse Cloud. Локально он устанавливает и переключает версии ClickHouse, запускает серверы ClickHouse в рамках проектов и Postgres на базе Docker, а также подключает клиенты. В Cloud он охватывает весь жизненный цикл ClickHouse, ClickHouse Managed Postgres, ClickPipes, ClickStack, резервных копий, ключей и участников.
В версии v0.5.0 была добавлена поддержка пользовательских функций (UDF) из локальной среды в Cloud, появилась наблюдаемость для ClickHouse Managed Postgres и стандартизирована структура команд. Основные изменения в v0.6.0:
- Проекты, которые работают как Git: выполняйте команды из любой поддиректории проекта, фиксируйте корневой каталог проекта с помощью переменной окружения и добавляйте конфигурацию сервера в репозиторий.
- Подключения к Cloud без пароля: клиент cloud clickhouse выполняет вход через браузер, а команда create --dotenv записывает одноразовый пароль в файл .env, скрывая его от терминала.
- Поиск, автодополнение оболочки и обратная связь: находите команду или флаг по ключевому слову, дополняйте их по нажатию клавиши Tab и сообщайте нам, если CLI чего-то не умел.
- ClickHouse Managed Postgres: сервис перешел в статус GA (общедоступен), а в CLI добавлена поддержка Postgres 19, эндпоинтов AWS PrivateLink, количества резервных копий (standby) и защиты от удаления.
- ClickPipes из результатов обнаружения: флаг --columns-from превращает вывод команды обнаружения схемы в целевые столбцы пайпа.
- Проверенные установки: скрипт установки, обновление и npm проверяют каждый загруженный файл по контрольным суммам релиза. Установка больше не зависит от GitHub API.
Некоторые из этих изменений затрагивают существующее поведение, а OAuth-авторизации, сохраненные в версии 0.5.x, потребуют одного повторного входа. См. примечания по обновлению.
Если у вас уже установлена утилита, обновите ее на месте:
Если нет, установите ее одним из удобных способов ниже:
В версии 0.5.x команды, привязанные к проекту, использовали строго текущую директорию. Если вы запускали сервер в корне проекта, а затем переходили в src/ с помощью cd, CLI переставал его видеть. В версии 0.6.0 директория, содержащая .clickhouse/, считается корнем проекта — точно так же, как директория с .git/ для Git.
Выполните clickhousectl local init один раз в директории вашего проекта. После этого локальные серверы, инстансы Postgres, сохраненные API-ключи, источники UDF и резервный файл .env будут определяться из этой директории или любой ее поддиректории.
Ближайшая папка .clickhouse/ имеет приоритет, поэтому проект, вложенный внутрь другого, является самостоятельным проектом. Поиск останавливается на вашей домашней директории, поэтому глобальная папка ~/.clickhouse/ никогда не станет проектом для находящихся в ней поддиректорий. Папка .clickhouse/ игнорируется Git, поэтому после клонирования репозитория достаточно один раз выполнить local init. Запуск сервера без предварительного выполнения local init по-прежнему работает.
Скриптам, CI-задачам и монорепозиториям часто требуется фиксированный корень проекта независимо от того, где запускается команда. Установите переменную CLICKHOUSECTL_PROJECT_DIR, и поиск будет пропущен:
Именованные конфигурации раньше применялись только с флагом --config и только из вашей домашней директории. Ничто не применялось при каждом запуске, и команда разработчиков не могла совместно использовать конфигурацию через репозиторий. Теперь при каждом запуске local clickhouse перед файлом --config объединяются две директории config.d:
Последние слои имеют приоритет, а путь к данным и порты, управляемые CLI, всегда идут в самом конце. Команда local init создает шаблон clickhouse/config.d/, а local clickhouse configs показывает, что именно будет применяться.
См. руководство по локальной разработке.
Облачный API возвращает пароль пользователя по умолчанию только один раз, в момент создания. Благодаря двум новым возможностям вам редко придется его видеть.
Команда cloud clickhouse client открывает клиент clickhouse для облачного сервиса по родному протоколу TLS. Клиент выполняет вход через браузер от имени вашего облачного пользователя, поэтому пароль сервиса не используется. Для этого требуется установленный ClickHouse версии 25.12 или новее, а аргументы после -- передаются в клиент clickhouse без изменений.
Шаг с браузером требует участия человека, поэтому продолжайте использовать cloud clickhouse query в CI-системах и агентах.
Команда cloud clickhouse create --dotenv записывает настройки подключения нового сервиса и его одноразовый пароль в файл .env (или в указанный вами файл). Пароль попадает исключительно в файл. Он не выводится ни в человекочитаемом формате, ни в формате JSON, поэтому он никогда не попадет в контекст агента или лог выполнения.
Целевой файл проверяется до создания сервиса. Если запись не удалась после создания, команда выводит пароль обычным образом и завершается с кодом 1, благодаря чему учетные данные никогда не теряются.
Для существующего сервиса команда cloud clickhouse dotenv записывает те же настройки без пароля. Это операция чтения, поэтому она работает с OAuth-авторизацией:
Обе команды записывают переменные CLICKHOUSE_HOST, CLICKHOUSE_PORT, CLICKHOUSE_HTTP_PORT, CLICKHOUSE_USER и CLICKHOUSE_SECURE=true. Существующий файл редактируется на месте, и заменяются только эти ключи, поэтому пароль, записанный при создании, сохранится после последующего вызова dotenv.
См. руководство по облачным сервисам.
Агенты изучают CLI с помощью --help. Это перестает работать, когда нужная им возможность скрыта за флагом, а не за командой. Например, «список IP-адресов с доступом» задается флагом --ip-allow. Новый поиск верхнего уровня ранжирует команды по их пути, флагам, описаниям и контексту агента, а также показывает до трех подходящих флагов для каждой из них. Небольшая таблица синонимов сопоставляет слова из консоли со словами из CLI.
Флаг --limit задает количество возвращаемых команд (по умолчанию 5), а --json возвращает массив результатов. Поиск, не давший результатов, завершается с кодом 0 и возвращает пустой массив. Он работает офлайн и не затрагивает состояние.
Дерево команд глубокое, поэтому в версии 0.6.0 добавлено автодополнение по клавише Tab для bash, zsh и fish. Одна строка в файле запуска вашей оболочки регистрирует и clickhousectl, и chctl:
Автодополнение охватывает команды, флаги, имена локальных серверов и инстансов Postgres, а также установленные версии. Оно запускает установленный CLI при каждом нажатии Tab, поэтому оно остается актуальным после обновления. Функция работает офлайн и не записывает телеметрию.
Телеметрия показывает, какие команды выполнялись, а не то, что пользователь пытался сделать. Команда clickhousectl feedback отправляет короткое сообщение в свободной форме команде разработчиков, а контекст агента в справке призывает агентов программирования использовать эту функцию, если в CLI не хватало возможностей или справка ввела их в заблуждение.
Длина сообщения составляет не более 500 символов. Оно отправляется вместе с версией CLI, ОС, архитектурой, признаком обнаружения агента программирования и идентификаторами облачных организаций, к которым принадлежат ваши активные учетные данные. Оно никогда не включает ваше имя, адрес электронной почты, ключи или названия организаций. Обратная связь — это явное действие, поэтому отключение телеметрии и DO_NOT_TRACK не блокируют ее. В справочнике по обратной связи перечислено все, что отправляется.
Postgres 19. Команда postgres create --pg-version 19 поддерживается для организаций, у которых включен Postgres 19.
Частные эндпоинты через AWS PrivateLink (бета-версия). Новая группа команд cloud postgres private-endpoint создает сервис эндпоинтов для сервиса AWS Postgres, утверждает VPC-эндпоинты, которым разрешено подключение, и управляет дополнительными регионами, которым разрешен доступ к нему. API полностью заменяет каждый отправляемый ему список, поэтому команда update считывает эндпоинт, объединяет ваши изменения и отправляет только те списки, которые изменились. Утверждение одного VPC-эндпоинта никогда не отменяет другой.
Количество резервных копий (standby). Флаг --standby-count 0|1|2 при создании и обновлении задает количество горячих резервных копий. Значение none соответствует 0, async — 1, а sync — 1 или 2. Количество, не поддерживаемое указанным типом высокой доступности (--ha-type), вызывает ошибку использования до отправки любого запроса. Команды get и list отображают это количество.
Защита от удаления. Команда postgres update --deletion-protection true заставляет API отклонять запросы на удаление для этого сервиса, пока вы не отключите эту функцию. Она применяется к организациям с включенной защитой от удаления, а команды get и list отображают этот параметр.
Небольшие изменения:
- Команды logs, metrics, slow-queries list, slow-queries get и backup list теперь принимают --name <postgres-name> вместо ID сервиса.
- Команда slow-queries list теперь показывает базу данных, пользователя, операцию и приложение для каждого шаблона — это ключи, необходимые для slow-queries get.
- Параметр logs --severity теперь проверяется на соответствие поддерживаемым уровням перед отправкой запроса.
- Команды config patch и config replace теперь считывают документ из stdin при использовании --file -.
- Новые размеры локальных SSD GCP теперь принимаются через --size, а в справке указан небольшой размер для каждого провайдера.
- Справка для switchover теперь описывает принцип работы команды. Она также работает для сервисов без HA, перемещая первичный узел на вновь подготовленный сервер.
См. руководство по ClickHouse Managed Postgres.
Защита от удаления. Включите её с помощью clickhouse create --deletion-protection или измените позже через clickhouse update --deletion-protection true|false. Команда clickhouse delete отклоняет защищенный сервис с кодом ошибки deletion_protected, а поле command в ошибке содержит команду обновления, которая отключает защиту. При использовании --force сервис проверяется перед остановкой, поэтому защищенный сервис также никогда не будет остановлен.
Провайдеры аутентификации JWT (бета-версия). Команда cloud clickhouse jwt-provider позволяет пользователям входить в сервис с помощью JWT от вашего провайдера идентификации (доступно в тарифном плане Enterprise). Владелец токена получает роли ClickHouse, указанные в утверждении (claim) ролей токена. Команда update заменяет всю конфигурацию, поэтому передавайте --roles-claim повторно, чтобы сохранить её.
Профили инстансов. Организации Enterprise и BYOC могут изменить профиль инстанса с помощью clickhouse scale --profile. Команда clickhouse profile list показывает доступные профили.
Любой регион. Команда clickhouse create --region теперь принимает любой ID региона и оставляет проверку за Cloud, поэтому частный регион, который не указан публично, работает так же, как и публичный. Если Cloud отклоняет регион, а известный регион является близким совпадением, ошибка укажет на него. Параметр --custom-region, добавленный в версии 0.5.1 для этого случая, теперь является устаревшим псевдонимом --region и будет удален в версии 1.0.0.
Также: clickhouse delete --force ожидает остановки не более 10 минут и ничего не удаляет в случае тайм-аута, а backup list принимает --name <service-name> вместо ID сервиса.
См. руководство по облачному сервису.
Создание канала (pipe) для Kafka, Kinesis, объектного хранилища или Pub/Sub раньше требовало ручного копирования каждого обнаруженного поля в флаг --column. Эти четыре команды создания теперь принимают --columns-from <PATH|->, который считывает вывод clickpipe schema-discover --json в исходном виде. Каждое исходное поле становится целевым столбцом, наряду с каждым полем метаданных, которое не отключено по умолчанию, и каждый тип используется в обнаруженном виде.
Сначала отредактируйте discovery.json, чтобы удалить ненужные поля или добавить новые с помощью --column. --columns-from - считывает stdin, поэтому результаты обнаружения можно передать напрямую в команду create. Команда schema-discover также помечает, какие поля являются метаданными, добавляемыми ClickPipes (например, _topic или _path), в новых столбцах Virtual и Disabled By Default.
Новые параметры:
- MongoDB: --table-mapping-json принимает mongoConfig. {"persistDeletedDocuments": true} сохраняет полный документ в том виде, в котором он был непосредственно перед удалением, а не только его _id.
- Postgres и MySQL: --use-json-native-format true сохраняет столбцы JSON как собственный формат ClickHouse JSON, а не как String. Это выбор при создании, требующий включения функции для организации.
- Объектное хранилище: --skip-first-lines <N> для форматов TabSeparated при создании и schema-discover, а также --object-storage-max-file-size <BYTES> при создании и обновлении настроек.
- Обратные частные конечные точки: --custom-private-dns-mapping NAME=TARGET_ID теперь принимается для VPC_ENDPOINT_SERVICE, где целью является ID зоны доступности, например use1-az1.
- Команда clickpipe list и поиск по --name теперь следуют по каждой странице, поэтому они видят все каналы без дополнительных флагов.
CLI также перехватывает больше ошибок до отправки запроса и более четко сообщает о результатах выполнения команды:
- Создание Kafka и обнаружение схемы требуют аутентификации, а создание Kafka, Kinesis и Pub/Sub требует указания столбцов. API всегда отклонял такие запросы, а теперь они завершаются ошибкой локально как ошибки использования.
- Флаги каждого источника проверяются перед чтением учетных данных.
- Команда clickpipe start завершается с кодом 1 и собственным кодом ошибки, когда API принимает запуск, но не применяет его: clickpipe_still_pausing, clickpipe_start_not_applied или clickpipe_start_no_effect для завершенного канала.
- Обновление cdc-scaling требует наличия обоих параметров --cpu-millicores и --memory-gb и сообщает, что изменение было принято, а не завершено.
- Команда clickpipe update отклоняет корневой объект настроек, так как обновление всего канала не применяет его. Используйте clickpipe settings update.
См. руководство по ClickPipes и справочник по конфигурации ClickPipe.
Дашборды и алерты теперь принимают графики PromQL. Установите configType в значение promql в конфигурации графика, чтобы запрашивать выражения для источника типа promql при создании, обновлении и проверке дашборда, а также во встроенных графиках алертов. В версии 0.5.0 проверка графиков в самом CLI отклоняла их до того, как они достигали API.
Команда alert list получила серверные фильтры: --tag, --search, --source и --state. Повторите флаг, чтобы выбрать любое из нескольких значений.
Источники логов теперь принимают поля OpenTelemetry eventNameExpression и severityNumberExpression в команде source create|update --file, а источники метрик и PromQL принимают minAutoGranularity.
CLI по-прежнему отклоняет неизвестные ключи в теле --file перед отправкой, но теперь оставляет значения для обработки API. Новый тип графика или значение перечисления в ClickStack больше не требует выпуска новой версии CLI для использования.
См. руководство по ClickStack.
Три новые группы бета-команд:
- cloud org byoc access управляет тем, когда персонал ClickHouse может получить доступ к вашей инфраструктуре BYOC. --mode always разрешает доступ, --mode never запрещает его, а --mode window разрешает его на --duration секунд, начиная с --start.
- cloud org preview перечисляет функции предварительного просмотра, предлагаемые организации, и позволяет включать или выключать их.
- cloud member notification-settings перечисляет и обновляет собственные переопределения участника для настроек уведомлений по умолчанию для его роли, используя флаги или тело --file.
Команда cloud org role list и поиск по имени роли теперь следуют по каждой странице, поэтому они остаются полными для организаций с более чем 250 ролями. Команда cloud activity list по умолчанию возвращает данные за последние 7 дней, так как полная история активной организации переполняет контекст агента. Передайте --from-date для более старых записей. --to-date теперь включает указанный день.
Асинхронные записи в Cloud возвращаются сразу после того, как API принимает их. Агенты редко читают таблицу завершения в документации, поэтому они угадывали, что нужно опрашивать. Вывод --json для этих команд теперь содержит объект next с разрешенной командой чтения, полем для проверки и значениями, означающими выполнение или сбой:
Запускайте команду как есть и останавливайте, когда поле принимает одно из значений until. Это касается создания, запуска, возобновления, остановки и удаления службы ClickHouse, создания, восстановления, создания read-replica, изменения размера и повышения роли Postgres, запуска, остановки и повторной синхронизации ClickPipe, масштабирования CDC и создания обратной частной конечной точки. Команды без надежного сигнала завершения, такие как переключение (switchover) Postgres или изменение HA, не имеют значения next, а в справочнике по автоматизации указано, что именно нужно проверять для них.
- Ошибка 403 больше не является ошибкой аутентификации. Раньше любая ошибка 403 от Cloud API завершалась с кодом 4 и статусом auth_required, из-за чего при отказе по квоте или политике агентам приходилось заново входить в систему с действительным ключом. Теперь ошибка 403 завершается с кодом 1, статусом http_4xx и сообщением сервера. Код 4 остался для 401, отсутствующих учетных данных и отклоненных проверок учетных данных.
- Неверный ввод всегда завершается с кодом 2. Ввод, который проверяется после синтаксического анализа, но заведомо не может завершиться успешно (например, неизвестный --provider, некорректный --ip-allow или тело --file с неизвестными полями), раньше завершался с кодом 1. Пустой идентификатор ресурса, часто представляющий собой не заданную переменную оболочки, также считается ошибкой использования, и запрос не отправляется.
- resource_not_found означает ровно то, о чем говорит. Ошибка стабильно сообщается для отсутствующих ресурсов, выбранных по идентификатору или --name, а поле command перечисляет то, что реально существует в этой области видимости. Удаление, отклоненное API для все еще существующей службы, возвращает http_4xx.
- Ошибки называют проблему своими именами. Для --file, который не удается прочитать, указываются флаг и путь. Для тела запроса с неправильной структурой указывается JSON-путь к проблемному значению, например policies[0].permissions[0]. Справка (Help) перечисляет поля тела --file, а ошибки перечислений (enum) выводят список допустимых значений.
- Единый конверт ошибок в формате JSON. Ошибки update и skills, а теперь и auth login, logout и signup, подчиняются правилам JSON-режима. Локальные ошибки сохраняют собственную сводку clickhousectl в поле message, а текст из других программ (ClickHouse, Docker, ОС) помещают в details.
- CLICKHOUSECTL_AUTO_JSON=0 сохраняет вывод для людей под управлением обнаруженного агента кодирования. Явное указание --json по-прежнему имеет приоритет.
- Обновления изменения размера (Resize), HA и масштабирования CDC сообщают, что изменение было принято, а не завершено.
- Курсоры пагинации, начинающиеся с -, принимаются, и каждая команда списка, предложенная подсказкой, проверяется при синтаксическом анализе.
До сих пор скрипт установки, npm postinstall и update доверяли TLS-сертификатам по единому пути загрузки, и двоичный файл никак не проверялся. Начиная с версии v0.6.0, каждый релиз публикует файл SHA256SUMS и подтверждение происхождения сборки (build provenance attestation) GitHub для своих архивов. Архивы обслуживаются с builds.clickhouse.com, а SHA256SUMS считывается из релиза GitHub, поэтому сервер, доставляющий архив, не может одновременно поручиться за него.
Чтобы убедиться, что архив был собран релизным воркфлоу репозитория, проверьте его подлинность с помощью GitHub CLI:
Сам update действует аккуратнее:
- Он отказывается перезаписывать двоичный файл, управляемый npm, pip, uv или pipx, и выводит команду обновления для соответствующего пакетного менеджера.
- Он заменяет двоичный файл только после того, как новый успешно выполнит команду --version. В случае сбоя старый двоичный файл остается на своем месте.
- Последняя версия определяется на основе builds.clickhouse.com. Версия 0.5.0 обращалась к GitHub API, который разрешает 60 неаутентифицированных запросов в час с одного IP-адреса, поэтому update мог завершиться с ошибкой 403 rate limit exceeded. Если вы столкнулись с этим на версии 0.5.x, перезапустите скрипт установки.
- Фоновую проверку обновлений можно отключить с помощью CLICKHOUSECTL_NO_UPDATE_CHECK=1. Команда --version больше не ожидает ответа от сети до 10 секунд, а повторная попытка при неудачной проверке предпринимается через час, а не через день.
См. верификацию релиза.
OAuth-авторизации привязаны к своему серверу авторизации. Теперь cloud auth login сохраняет конфигурацию сервера авторизации вместе с токенами, и каждое обновление использует эту сохраненную конфигурацию. В авторизации, сохраненной версией 0.5.x, ее нет, поэтому auth status отображает OAuth как Login required, а команды Cloud завершаются с кодом 4 и сообщением о необходимости повторного входа. Запустите clickhousectl cloud auth login один раз после обновления.
Сохраненный ключ API работает только с тем API, для которого он был сохранен. Когда auth login --api-key проверяет ключ в API, отличном от производственного, с помощью --url, этот API сохраняется вместе с ключом. Последующая команда, указывающая другой API, завершается с кодом 4 без отправки ключа.
Сохраненные учетные данные завершаются неудачно при любых сомнениях (fail closed). Существующий, но нечитаемый credentials.json останавливает команды Cloud с ошибкой, указывающей на файл. CLI больше не переключается на учетные данные окружения или OAuth, которые вы не собирались использовать. OAuth-авторизация, которую не удается обновить, сохраняется и отображается как Expired, хотя раньше она удалялась. Токены записываются атомарно, а обновление заблокировано, поэтому две одновременно запущенные команды не смогут повредить файл.
Сохраненные ключи запросов упразднены. Начиная с версии 0.5.0, cloud clickhouse query привязывает ваш активный ключ API к конечной точке Query API службы. Версия 0.6.0 прекращает использование старых ключей для каждой службы, которые предыдущие версии создавали и сохраняли, хотя сами ключи все еще существуют в вашей организации. Она также удаляет repair-query-key. Оставшаяся запись удаляется при следующем запросе или удалении этой службы, а CLI выводит команду удаления облачного ключа для указанного ключа. Ключ API только для чтения не может привязать себя самостоятельно, и теперь завершается ошибкой query_key_bind_forbidden вместе с командой, которая привязывает его с помощью ключа с правами записи.
А также: когда учетные данные относятся к нескольким организациям и ни одна из них не выбрана, команда завершается с кодом 2 и выводит идентификатор и имя каждой организации. Значение --org-name, совпадающее более чем с одной организацией, выводит идентификаторы, которые нужно передать в --org-id. Потоковое устройство OAuth (device flow) может выполнять вход для пользовательской целевой конечной точки API путем установки переменных CLICKHOUSECTL_AUTH_URL и CLICKHOUSECTL_CLIENT_ID.
См. справочник по аутентификации.
Запуск собранной вами самостоятельно сборки ClickHouse. local install --binary <PATH> копирует файл в ~/.clickhouse/versions/, запускает копию с флагом --version и устанавливает ее под тем номером версии, который она сообщает. После этого local use, clickhouse start --version и local remove работают с ней как с любой другой установкой. Передайте --force, чтобы заменить ее после пересборки.
Остальное — серия исправлений:
- Остановленный сервер перезапускается на той версии, на которой он работал в последний раз. Раньше stop очищал записанную версию, поэтому последующий запуск без --version запускал каталог данных на версии по умолчанию и молча обновлял или понижал ее.
- Команды, принимающие имя сервера, используют единое правило выбора, если имя не указано: сервер с именем default, в противном случае — единственный сервер проекта для этого движка. При наличии нескольких серверов и отсутствии default они завершаются с ошибкой server_selection_required и выводят список имен. remove никогда не угадывает.
- Команды только для чтения, такие как list, больше не создают каталог .clickhouse/ в текущей директории.
- Проверка портов обнаруживает подстановочные знаки (wildcard) и прослушиватели ::1, отклоняет порт 0 и равные порты HTTP и TCP, а опущенный порт никогда не занимает тот порт, который использует другой прослушиватель.
- Процессы сервера обнаруживаются нативно, без использования pgrep, ps или lsof, а перед тем как CLI доверится сохраненному PID, проверяется, что это действительно сервер ClickHouse.
- local clickhouse stop, remove и local remove больше не требуют Docker.
- Точные версии снова устанавливаются на Intel macOS.
- dotenv заключает в кавычки значения, содержащие $ или другие специальные символы оболочки.
И для локального Postgres:
- Локальный клиент postgres теперь останавливает скрипт при первой неудачной инструкции и завершается с кодом 3. Раньше при сбое в --queries-file или в переданном через пайп скрипте выводилась ошибка и происходил выход с кодом 0. Передайте -- -v ON_ERROR_STOP=0, чтобы выполнить оставшиеся инструкции.
- Новые контейнеры получают имена clickhousectl-pg-<хеш проекта>-<имя>-<мажорная версия>, поэтому два проекта могут использовать одно и то же имя экземпляра. Существующие контейнеры сохраняют свои имена.
- Возобновление работы экземпляра, порт которого теперь занят, завершается ошибкой port_in_use. Остановка уже остановленного экземпляра проходит успешно и сообщает already_stopped.
См. руководство по локальной разработке.
local server теперь называется local clickhouse, а cloud service — cloud service, при этом ch и pg служат короткими псевдонимами для этих двух движков. Старые имена по-прежнему работают. Локально список и команда stop-all для каждого движка теперь охватывают только этот движок, а команда local status показывает оба.
Переименования сохраняют старое написание, поэтому большинство скриптов продолжают работать. Эти изменения требуют действий или меняют то, что видит существующий скрипт.
clickhousectl создан на базе clickhouse-cloud-api, типизированного Rust-клиента для ClickHouse Cloud API, который выпускается синхронно с CLI. Начиная с версии 0.6.0, в нем появилось changelog, описывающее изменения, которые должен внести вызывающий код на Rust при обновлении. Основные изменения в этом релизе:
- Поля меток времени теперь имеют тип jiff::Timestamp вместо типов chrono. При передаче по сети они по-прежнему имеют формат RFC 3339 в UTC.
- Структуры запросов с обязательным полем больше не реализуют Default, поэтому конструкция ..Default::default() не сможет молча заполнить поле, которое API только что сделал обязательным.
- Крейт реэкспортирует reqwest, поэтому предсобранный HTTP-клиент использует ту же версию, что и библиотека.
Спасибо Emanuele De Cupis, который добавил авторизацию через OAuth-устройство для пользовательских целевых API (#1082), @divyenduz, который убрал метку Beta с Postgres (#1382), и Андрею Чудновскому, который добавил Postgres 19 (#1462).












