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

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

Community Maintained

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

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

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

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

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

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

  • ХОСТ и ПОРТ: как правило, порт 8443 при использовании TLS или 8123 при отсутствии TLS.

  • ИМЯ БАЗЫ ДАННЫХ: по умолчанию существует база данных с именем default, используйте имя базы данных, к которой вы хотите подключиться.

  • ИМЯ ПОЛЬЗОВАТЕЛЯ и ПАРОЛЬ: по умолчанию имя пользователя default. Используйте имя пользователя, подходящее для вашего случая.

Данные для вашего сервиса ClickHouse Cloud доступны в консоли ClickHouse Cloud. Выберите сервис, к которому вы хотите подключиться, и нажмите Подключиться:

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

Выберите HTTPS, и данные будут доступны в примере команды curl.

Детали подключения ClickHouse Cloud по HTTPS

Если вы используете самоуправляемый ClickHouse, детали подключения устанавливаются вашим администратором ClickHouse.

2. Загрузите QStudio​

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

3. Добавьте базу данных​

  • Когда вы впервые откроете QStudio, нажмите на меню Сервер->Добавить сервер или на кнопку добавления сервера на панели инструментов.
  • Затем укажите данные:
Экран настройки подключения базы данных QStudio с показом параметров подключения ClickHouse
  1. Тип сервера: Clickhouse.com
  2. Обратите внимание, что для хоста вы ДОЛЖНЫ включить https:// Хост: https://abc.def.clickhouse.cloud Порт: 8443
  3. Имя пользователя: default Пароль: XXXXXXXXXXX
  4. Нажмите Добавить

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

4. Делайте запросы к ClickHouse​

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

  • Ctrl + e - Выполняет выделенный текст

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

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

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

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

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