// бесплатный инструмент

Конструктор строк подключения ClickHouse

Создавайте строки подключения ClickHouse для HTTP-интерфейса и нативного протокола в одной форме или вставьте готовую, чтобы проверить порт, протокол и настройки TLS. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.

Открыть это подключение в SQLly

Открывает редактор подключений SQLly с заполненными полями.

Приватность на уровне архитектуры. Конструктор и декодер — обычный JavaScript, работающий в этой вкладке. Страница никуда не отправляет то, что вы вводите, ничего не хранит (даже в вашем браузере) и продолжает работать офлайн после загрузки. Ссылка «Открыть в SQLly» ведёт из вашего браузера прямо в приложение на вашем компьютере.

Форматы строк подключения ClickHouse

У ClickHouse два клиентских протокола на разных портах: HTTP (8123 или 8443 с TLS), который используют JDBC, clickhouse-connect и драйвер .NET, и нативный TCP-протокол (9000 или 9440 с TLS) для clickhouse-client и clickhouse-go. Указать клиенту порт чужого протокола — самая частая ошибка подключения.

HTTP URL HTTP-интерфейс, curl

https://ch.example.com:8443/?database=analytics

Собственный DSN clickhouse-go v2

clickhouse://default:[email protected]:9440/analytics?secure=true

JDBC clickhouse-java 0.8+

jdbc:clickhouse:https://ch.example.com:8443/analytics?user=default&password=your_password&ssl=true

ADO.NET ClickHouse.Driver

Host=ch.example.com;Protocol=https;Username=default;Password=your_password;Database=analytics

Заполнители, такие как your_password — это лишь примеры: соберите свою строку в форме выше. Подробнее о подключении SQLly к ClickHouse: SQLly для ClickHouse.

Порты ClickHouse

Из руководства ClickHouse по сетевым портам.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
8123 - - HTTP-интерфейс.
8443 - - HTTPS-интерфейс.
9000 - - Нативный TCP-протокол.
9440 - - Нативный протокол через TLS.
9004 / 9005 - - Интерфейсы совместимости с MySQL и PostgreSQL.

Параметры DSN clickhouse-go v2

clickhouse://user:password@host1:9000,host2:9000/database?param=value; http:// и https:// DSN используют HTTP-интерфейс.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
secure - ложь TLS.
skip_verify - ложь Пропустить проверку сертификатов.
dial_timeout - 30 с Тайм-аут подключения с указанием единицы измерения.
read_timeout - 5 мин Таймаут чтения.
compress - - Метод сжатия.
connection_open_strategy - - Как выбираются хосты.

Ключи ClickHouse.Driver (.NET)

Стиль ADO.NET.

Ключевое словоСинонимыПо умолчаниюЧто оно делает
Host - localhost Хост сервера.
Port - 8123 / 8443 HTTP(S)-порт.
Protocol - http http или https.
Username - default Имя пользователя.
Password - пусто Пароль.
Database - пусто База данных по умолчанию.
Compression - истина Сжимать трафик.
UseSession - ложь Использовать сессию на стороне сервера.
Timeout - 120 Секунды.

Параметры clickhouse-client

clickhouse-client также принимает строку подключения в качестве первого аргумента: clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters].

Ключевое словоСинонимыПо умолчаниюЧто оно делает
--host, -h - localhost Хост сервера.
--port - 9000 (9440 с --secure) Нативный порт.
--user, -u - default Пользователь.
--password --ask-password - Пароль; --ask-password запросы.
--database, -d - default База данных.
--secure, -s - - TLS; включается автоматически для порта 9440 и хостов ClickHouse Cloud.

Распространённые ошибки подключения к ClickHouse

Port 9000 is for clickhouse-client program. You must use port 8123 for HTTP.

Почему: HTTP-клиент (браузер, curl, JDBC, clickhouse-connect, .NET) был направлен на порт нативного протокола.

Исправлено: Используйте 8123 или 8443 для HTTPS.

Code: 516. DB::Exception: default: Authentication failed: password is incorrect, or there is no user with such name.

Почему: Неправильный пользователь или пароль, либо пользователю запрещён вход с вашего адреса.

Исправлено: Проверьте учетные данные и разрешенные хосты пользователя в конфигурации пользователей сервера.

Code: 81. DB::Exception: Database analytics does not exist. (UNKNOWN_DATABASE)

Почему: База данных в строке не существует.

Исправлено: Проверить SHOW DATABASES и правописание.

Unexpected packet / connection reset on the native port

Почему: Клиент нативного протокола (clickhouse-client, clickhouse-go) подключается к HTTP-порту, а обычный клиент — к TLS-порту 9440.

Исправлено: Используйте 9000 без TLS или 9440 с TLS --secure / secure=true.

Часто задаваемые вопросы о строке подключения ClickHouse

Какой порт использовать для ClickHouse?

HTTP-клиенты (JDBC, clickhouse-connect, .NET, curl) используют 8123, или 8443 для HTTPS. Нативные клиенты (clickhouse-client, clickhouse-go native DSN) используют 9000, или 9440 для TLS. ClickHouse Cloud работает на 8443 и 9440.

Какой формат JDBC URL для ClickHouse?

jdbc:clickhouse:http://host:8123/database или jdbc:clickhouse:https://host:8443/database?ssl=true (драйвер 0.8+). Драйвер не угадывает протокол по порту, поэтому его нужно указывать.

Можно ли указать пароль в HTTP URL?

Избегайте этого: URL-адреса могут оказаться в логах. Передавайте его в X-ClickHouse-User и X-ClickHouse-Key заголовках или через базовую HTTP-аутентификацию.

// вообще без строк подключения

Подключитесь один раз. А потом просто пишите SQL.

SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставляйте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для ClickHouse и других баз данных.