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

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

Community Maintained

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

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

1. Соберите параметры подключения к ClickHouse​

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

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

Чтобы подключиться к 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. Скачайте 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 обнаружит, что у вас не установлен JDBC‑драйвер ClickHouse, он предложит загрузить его для вас:

4. Запрос к ClickHouse​

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

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

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

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

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

Следующие шаги​

Ознакомьтесь с QStudio, чтобы узнать о возможностях QStudio, и с документацией ClickHouse, чтобы узнать о возможностях ClickHouse.