Перейти к основному содержимому
Версия: 4.1

ClickHouse

Выбор типа конфигурации​

Для указания типа конфигурации необходимо выбрать одну из плиток, представленных на странице. В данном случае необходимо выбрать плитку Clickhouse.

Важно!

После сохранения поменять тип конфигурации невозможно.

Заполнение информации о подключении​

Дальнейшая информация о конфигурации вводится в блоке "Введите информацию о конфигурации". Поля, отмеченные красной звездочкой, обязательны. Если в каком-либо поле ввода будут некорректные данные, то конфигурация не сохранится и появится информация о некорректном вводе напротив поля с ошибкой. Для того, чтобы ввести информацию о подключении, следуйте следующим шагам:

  1. Для ввода информации об имени конфигурации введите данные в поле ввода с названием "Имя конфигурации". Допускаются только латиница или цифры в стиле CamelCase.
  2. После этого выберите JDBC драйвер в поле "Загрузите драйвер". Если нужного драйвера нет среди предложенных, то можно загрузить свой, нажав на кнопку "Загрузить файл" под полем ввода. После этого откроется модальное окно, в котором необходимо выбрать JDBC-драйвер с расширением .jar. В остальных случаях драйвер не будет загружен.
  3. Поле "Имя класса драйвера" заполняется автоматически. Если в JDBC-драйвере несколько классов, можно ввести нужный класс. При его вводе допускаются только латиница или цифры.
Обратите внимание!

По умолчанию поле строка подключения автодополняется на основе класса JDBC драйвера. Для Clickhouse поддерживаются следующие классы: cc.blynk.clickhouse.ClickHouseDriver, com.clickhouse.jdbc.ClickHouseDriver. Если драйвер не использует эти классы, строка подключения все равно автодополнится, но для корректной работы подключения необходимо будет проверить поле ввода "Строка подключения" на правильность сгенерированных данных. Иначе перейдите в продвинутый режим и откорректируйте ее.

  1. Введите хост в поле "Хост". Допускаются строки вида http://172.168.0.1 или https://yourhost.
  2. Введите порт в поле "Порт". Допускаются только цифры.
  3. При необходимости в подключении к базе данных по умолчанию, можно ввести ее название в поле "База данных по умолчанию".
  4. Если в вашем подключении есть валидация SSL, то необходимо включить поле "Валидация SSL". После этого появится предупреждение о необходимости сохранения данных в keystore, показанное на рисунке.

Предупреждение о keystore Сlickhouse

После этого можете включить проверку имени хоста, а также указать путь до trust store в поле "Путь до trust store". Допускаются только строки вида /my_path/to/trust-store/.

Важно!

SSL параметры устанавливаются для официального драйвера Clickhouse. Если вы используете другой драйвер, перейдите в продвинутый режим и введите необходимые параметры вручную.

  1. Если в соединении есть авторизация с помощью пользователя и пароля или только пользователя, введите соответствующие поля "Пользователь" и "Пароль".

  2. Для проверки подключения, нажмите на кнопку "Проверить подключение". Если подключение к Clickhouse прошло успешно, будет выведено следующее сообщение:

Успешное подключение

В противном случае будет выведена ошибка вида:

Ошибка подключения

Примечание

В статье показан лишь пример сообщения об ошибке. Фактическая ошибка может быть другой.

Конфигурация может сохраниться с ошибками подключения. Но она не сохранится с ошибками о формате введенных данных или с пустыми данными в обязательных полях.

Особенности редактирования конфигурации​

Конфигурация редактируется по тем же правилам, что и создается. Можно редактировать поля в любом произвольном порядке для необходимой настройки конфигурации.