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

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

Community Maintained

QStudio — это бесплатный графический интерфейс SQL-клиента, который позволяет запускать SQL-скрипты, легко просматривать таблицы, строить графики и экспортировать результаты. Он работает на всех операционных системах и с любой базой данных.

QStudio подключается к ClickHouse по JDBC.

1. Соберите сведения о вашем ClickHouse​

QStudio использует JDBC поверх HTTP(S) для подключения к ClickHouse. Для этого вам понадобятся:

  • endpoint
  • номер порта
  • имя пользователя
  • пароль

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

Параметр(ы)Описание
HOST and PORTTypically, the port is 8443 when using TLS or 8123 when not using TLS.
DATABASE NAMEOut of the box, there is a database named default, use the name of the database that you want to connect to.
USERNAME and PASSWORDOut of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select a service and click Connect:

ClickHouse Cloud service connect button

Choose HTTPS. Connection details are displayed in an example curl command.

ClickHouse Cloud HTTPS connection details

If you're using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

2. Скачайте QStudio​

QStudio доступен по адресу https://www.timestored.com/qstudio/download/

3. Добавление базы данных​

  • Когда вы впервые откроете QStudio, выберите в меню Server->Add Server или нажмите кнопку добавления сервера на панели инструментов.
  • Затем укажите параметры:
Окно настройки подключения к базе данных QStudio с параметрами подключения к ClickHouse
  1. Server Type: Clickhouse.com
  2. Обратите внимание: в Host ОБЯЗАТЕЛЬНО должен быть указан протокол https:// Host: https://abc.def.clickhouse.cloud Port: 8443
  3. Username: default Password: XXXXXXXXXXX
  4. Нажмите Add

Если QStudio обнаружит, что у вас не установлен драйвер ClickHouse JDBC, он предложит скачать их для вас:

4. Выполнение запросов к ClickHouse​

  • Откройте редактор запросов и выполните запрос. Вы можете запускать запросы с помощью:

  • Ctrl + E — выполняет выделенный текст

  • Ctrl + Enter — выполняет текущую строку

  • Пример запроса:

Интерфейс QStudio, демонстрирующий выполнение примерного SQL-запроса в базе данных ClickHouse

Дальнейшие шаги​

Подробнее о возможностях QStudio см. на странице QStudio, а о возможностях ClickHouse — в документации ClickHouse.