DB

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

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

Важно!

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

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

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

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

Обратите внимание!

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

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

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

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

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

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

Примечание

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

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

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

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

Поддерживаемые классы для автодополнения

• com.mysql.jdbc.Driver - драйвер для MySql. Получаемый шаблон строки подключения: jdbc:mysql://<host>:<port>/<database>
• net.sourceforge.jtds.jdbc.Driver - драйвер MS-SQL Server использующий jTDS драйвер. Получаемый шаблон строки подключения: jdbc:jtds:sqlserver://<host>:<port>/<database>;useCursors=true
• com.microsoft.sqlserver.jdbc.SQLServerDriver - драйвер для MS-SQL Server, использующим MS Generic драйвер. Получаемый шаблон строки подключения: jdbc:sqlserver://<host>:<port>;databaseName=<database>;selectMethod=cursor
• oracle.jdbc.OracleDriver - драйвер для Oracle. Получаемый шаблон строки подключения: jdbc:oracle:thin:@<host>:<port>:<database>
• com.ibm.db2.jcc.DB2Driver - драйвер для DB2. Получаемый шаблон строки подключения: jdbc:db2://<host>:<port>/<database>
• com.sybase.jdbc4.jdbc.SybDriver - драйвер для Sybase ASE (jConnect). Получаемый шаблон строки подключения: jdbc:sybase:Tds:<host>:<port>/<database>
• org.postgresql.Driver - драйвер для Postgresql. Получаемый шаблон строки подключения: jdbc:postgresql://<host>:<port>/<database>
• org.postgresql.Driver - драйвер для Postgresql. Получаемый шаблон строки подключения: jdbc:postgresql://<host>:<port>/<database>
• com.informix.jdbc.IfxDriver - драйвер для Informix. Получаемый шаблон строки подключения: jdbc:informix-sqli://<host>:<port>/<database>:informixserver=<informixserver>;DELIMIDENT=Y
• com.teradata.jdbc.TeraDriver - драйвер для Teradata. Получаемый шаблон строки подключения: jdbc:teradata://<host>
• com.amazon.redshift.jdbc41.Driver - драйвер для AWS RedShift. Получаемый шаблон строки подключения: jdbc:redshift://<host>:<port>/<database>
• com.simba.spark.jdbc41.Driver - драйвер для Spark SQL. Получаемый шаблон строки подключения: jdbc:spark://<host>:<port>/<database>

Если вашего драйвера нет среди доступных, то будет использован шаблон jdbc://<host>:<port>/<database>, после чего любую уже готовую строку подключения можно отредактировать в продвинутом режиме .