Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

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

View as MarkdownEdit this pageReport an issueSet up docs MCP
Поддерживается сообществом

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

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

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

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

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

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

Параметр(ы) Описание
HOST and PORT Обычно используется порт 8443 при использовании TLS и 8123 без TLS.
DATABASE NAME По умолчанию есть база данных default; используйте имя базы данных, к которой хотите подключиться.
USERNAME and PASSWORD По умолчанию имя пользователя — default. Используйте имя пользователя, подходящее для вашего сценария использования.

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

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

Выберите HTTPS. Сведения о подключении будут показаны в примере команды curl.

Сведения о подключении к ClickHouse Cloud по HTTPS

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

Скачайте QStudio

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

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

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

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

Выполните запрос к ClickHouse

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

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

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

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

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

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

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

Navigation