Перейти к основному содержанию
Перейти к основному содержанию

Подключение Retool к ClickHouse

Partner Integration

1. Соберите сведения о подключении

Чтобы подключиться к ClickHouse по HTTP(S), вам потребуется следующая информация:

Параметр(ы)Описание
HOST и PORTОбычно используется порт 8443 при использовании TLS или 8123 при отсутствии TLS.
DATABASE NAMEПо умолчанию существует база данных default; используйте имя базы данных, к которой вы хотите подключиться.
USERNAME и PASSWORDПо умолчанию имя пользователя — default. Используйте имя пользователя, соответствующее вашему сценарию.

Сведения о вашем сервисе ClickHouse Cloud доступны в консоли ClickHouse Cloud. Выберите сервис и нажмите Connect:

Кнопка подключения сервиса ClickHouse Cloud

Выберите HTTPS. Параметры подключения отображаются в примере команды curl.

Параметры HTTPS-подключения ClickHouse Cloud

Если вы используете самостоятельное (self-managed) развертывание ClickHouse, параметры подключения задаются администратором ClickHouse.

2. Создайте ресурс ClickHouse

Войдите в свой аккаунт Retool и перейдите на вкладку Resources. Выберите «Create New» → «Resource»:

Создание нового ресурса

Выберите «JDBC» из списка доступных коннекторов:

Выбор коннектора JDBC

В мастере настройки убедитесь, что в поле «Driver name» выбран com.clickhouse.jdbc.ClickHouseDriver:

Выбор правильного драйвера

Укажите учетные данные ClickHouse в следующем формате: jdbc:clickhouse://HOST:PORT/DATABASE?user=USERNAME&password=PASSWORD. Если для вашего экземпляра требуется SSL или вы используете ClickHouse Cloud, добавьте &ssl=true к строке подключения, чтобы она выглядела так: jdbc:clickhouse://HOST:PORT/DATABASE?user=USERNAME&password=PASSWORD&ssl=true

Указание учетных данных

После этого протестируйте подключение:

Тестирование подключения

Теперь вы можете перейти к работе в приложении, используя ресурс ClickHouse.