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

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

Community Maintained

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

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

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

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

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

To connect to ClickHouse with HTTP(S) you need this information:

Parameter(s)Description
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 are 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 обнаружит, что у вас не установлен JDBC‑драйвер ClickHouse, он предложит загрузить его для вас:

4. Запрос к ClickHouse​

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

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

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

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

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

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

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