Конструктор строк подключения ClickHouse
Создавайте строки подключения ClickHouse для HTTP-интерфейса и нативного протокола в одной форме или вставьте готовую, чтобы проверить порт, протокол и настройки TLS. Всё работает в вашем браузере: ничего из того, что вы вводите, никуда не отправляется.
Открыть это подключение в SQLly
Открывает редактор подключений 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 Server
- Строки подключения к PostgreSQL
- Строки подключения к MySQL
- Строки подключения к MariaDB
- Строки подключения к SQLite
- Строки подключения к Oracle
- Строки подключения Redis
- Строки подключения DuckDB
- Строки подключения libSQL
- Все движки и форматы
- Форматировщик SQL
- Все бесплатные инструменты
Подключитесь один раз. А потом просто пишите SQL.
SQLly — это нативная рабочая среда SQL для macOS, Windows и Linux. Вставляйте строку подключения в её редактор подключений, храните пароли в системной связке ключей и получайте IntelliSense с учётом схемы для ClickHouse и других баз данных.