ClickHouse поддерживает протокол MySQL. Это позволяет некоторым клиентам, для которых нет нативных коннекторов ClickHouse, использовать вместо них протокол MySQL; совместимость была проверена со следующими BI-инструментами:
Если вы используете другие, не прошедшие проверку клиенты или интеграции, имейте в виду следующие ограничения:
- Реализация SSL может быть не полностью совместимой; возможны проблемы с TLS SNI.
- Для некоторых инструментов могут требоваться возможности диалекта (например, специфичные для MySQL функции или настройки), которые пока не реализованы.
Если доступен нативный драйвер (например, DBeaver), всегда предпочтительнее использовать его вместо интерфейса MySQL. Кроме того, хотя большинство клиентских библиотек MySQL должны работать нормально, интерфейс MySQL не гарантирует полной совместимости и не является полной заменой для существующей кодовой базы с MySQL-запросами.
Если в вашем сценарии используется конкретный инструмент, у которого нет нативного драйвера ClickHouse, и вы хотите работать с ним через интерфейс MySQL, но столкнулись с определёнными несовместимостями, пожалуйста, создайте issue в репозитории ClickHouse.
::::note
Чтобы лучше поддерживать SQL-диалект указанных выше BI-инструментов, интерфейс MySQL в ClickHouse неявно выполняет SELECT-запросы с настройкой prefer_column_name_to_alias = 1.
Отключить это нельзя, и в редких пограничных случаях это может приводить к различиям в поведении между запросами, отправленными через обычный интерфейс запросов ClickHouse и через интерфейс запросов MySQL.
::::
Включение интерфейса MySQL в ClickHouse Cloud
- После создания сервиса ClickHouse Cloud нажмите кнопку
Connect.
- В раскрывающемся списке
Connect with выберите MySQL.
- Включите переключатель, чтобы активировать интерфейс MySQL для этого сервиса. После этого для сервиса будет открыт порт
3306, и отобразится экран подключения MySQL с вашим уникальным именем пользователя MySQL. Пароль будет таким же, как у пользователя сервиса по умолчанию.
Скопируйте показанную строку подключения MySQL.
Создание нескольких пользователей MySQL в ClickHouse Cloud
mysql4<subdomain>, который использует тот же пароль, что и default. Часть <subdomain> — это первый сегмент имени хоста вашего ClickHouse Cloud. Такой формат необходим для работы с инструментами, которые поддерживают защищённое соединение, но не передают информацию SNI при TLS-рукопожатии, из-за чего внутренняя маршрутизация невозможна без дополнительной подсказки в имени пользователя (клиент консоли MySQL — один из таких инструментов).
Поэтому мы настоятельно рекомендуем при создании нового пользователя для работы с интерфейсом MySQL использовать формат mysql4<subdomain>_<username>, где <subdomain> служит подсказкой для идентификации вашего сервиса ClickHouse Cloud, а <username> — произвольный суффикс на ваш выбор.
Для имени хоста ClickHouse Cloud вида foobar.us-east1.aws.clickhouse.cloud часть <subdomain> будет равна foobar, а пользовательское имя MySQL может выглядеть так: mysql4foobar_team1.
-
Необязательно — создайте профиль настроек, который будет применяться к вашему пользовательскому пользователю. Например,
my_custom_profile с дополнительной настройкой, которая будет применяться по умолчанию при подключении под пользователем, которого мы создадим позже:
CREATE SETTINGS PROFILE my_custom_profile SETTINGS prefer_column_name_to_alias=1;
prefer_column_name_to_alias приведён здесь только в качестве примера — вы можете использовать и другие настройки.
-
Создайте пользователя в следующем формате:
mysql4<subdomain>_<username> (см. выше). Пароль должен быть в формате двойного хэша SHA1. Например:
CREATE USER mysql4foobar_team1 IDENTIFIED WITH double_sha1_password BY 'YourPassword42$';
CREATE USER mysql4foobar_team1 IDENTIFIED WITH double_sha1_password BY 'YourPassword42$' SETTINGS PROFILE 'my_custom_profile';
my_custom_profile — имя профиля, который вы создали ранее.
-
Выдайте новому пользователю необходимые разрешения для работы с нужными таблицами или базами данных. Например, если вы хотите предоставить доступ только к
system.query_log:
GRANT SELECT ON system.query_log TO mysql4foobar_team1;
-
Используйте созданного пользователя для подключения к вашему сервису ClickHouse Cloud через интерфейс MySQL.
Устранение неполадок при работе с несколькими пользователями MySQL в ClickHouse Cloud
ERROR 2013 (HY000): Lost connection to MySQL server at 'reading authorization packet', system error: 54
mysql4<subdomain>_<username>, как описано (выше).
Включение интерфейса MySQL в самоуправляемом ClickHouse
config.d/:
<clickhouse>
<mysql_port>9004</mysql_port>
</clickhouse>
{} <Information> Application: Listening for MySQL compatibility protocol: 127.0.0.1:9004
Подключение MySQL к ClickHouse
mysql:
mysql --protocol tcp -h [hostname] -u [username] -P [port_number] [database_name]
$ mysql --protocol tcp -h 127.0.0.1 -u default -P 9004 default
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 4
Server version: 20.2.1.1-ClickHouse
Copyright (c) 2000, 2019, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
mysql>
-
подготовленные запросы не поддерживаются
-
некоторые типы данных передаются как строки
Чтобы отменить долго выполняющийся запрос, используйте оператор KILL QUERY connection_id (при обработке он заменяется на KILL QUERY WHERE query_id = connection_id). Например:
$ mysql --protocol tcp -h mysql_server -P 9004 default -u default --password=123 -e "KILL QUERY 123456;"
Последнее изменение 10 июня 2026 г.
