Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

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

View as MarkdownEdit this pageReport an issueSet up docs MCP
Партнерская интеграция

Metabase — это простой в использовании инструмент с открытым исходным кодом и удобным интерфейсом для работы с данными. Metabase — это Java-приложение, которое можно запустить, просто скачав JAR-файл и выполнив команду java -jar metabase.jar. Metabase подключается к ClickHouse с помощью JDBC-драйвера, который нужно скачать и поместить в папку plugins:

Цель

В этом руководстве вы будете задавать вопросы к данным в ClickHouse через Metabase и визуализировать полученные ответы. Один из результатов будет выглядеть так:

Визуализация круговой диаграммы в Metabase с данными из 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.

Скачайте плагин ClickHouse для Metabase

  1. Если у вас нет папки plugins, создайте её как вложенную папку там, где сохранён metabase.jar.

  2. Плагин представляет собой JAR-файл с именем clickhouse.metabase-driver.jar. Скачайте последнюю версию JAR-файла по адресу https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest

  3. Сохраните clickhouse.metabase-driver.jar в папке plugins.

  4. Запустите (или перезапустите) Metabase, чтобы драйвер загрузился корректно.

  5. Откройте Metabase по адресу http://hostname:3000. При первом запуске вы увидите экран приветствия, и вам нужно будет ответить на ряд вопросов. Если появится запрос на выбор базы данных, выберите "I'll add my data later":

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

  1. Нажмите на значок шестерёнки в правом верхнем углу и выберите Admin Settings, чтобы перейти на страницу администратора Metabase.

  2. Нажмите Add a database. Либо откройте вкладку Databases и нажмите кнопку Add database.

  3. Если драйвер установлен правильно, в выпадающем меню Database type появится ClickHouse:

    Выбор базы данных в Metabase, где ClickHouse доступен как один из вариантов

  4. Укажите для своей базы данных Display name — это параметр Metabase, поэтому можно использовать любое имя.

  5. Введите сведения о подключении к базе данных ClickHouse. Включите защищённое подключение, если ваш сервер ClickHouse настроен на использование SSL. Например:

    Форма сведений о подключении в Metabase для базы данных ClickHouse

  6. Нажмите кнопку Save, и Metabase просканирует базу данных на наличие таблиц.

Выполните SQL-запрос

  1. Выйдите из Admin settings, нажав кнопку Exit admin в правом верхнем углу.

  2. В правом верхнем углу нажмите меню + New и обратите внимание, что вы можете задавать вопросы, выполнять SQL-запросы и создавать панель мониторинга:

    Меню New в Metabase с вариантами создания вопросов, SQL-запросов и панелей мониторинга

  3. Например, вот SQL-запрос, выполненный к таблице uk_price_paid, который возвращает среднюю цену покупки по годам с 1995 по 2022:

    Редактор SQL в Metabase, показывающий запрос к данным UK price paid

Задайте вопрос

  1. Нажмите + New и выберите Question. Обратите внимание, что вопрос можно построить, начав с базы данных и таблицы. Например, следующий вопрос задаётся к таблице uk_price_paid в базе данных default. Вот простой вопрос, который вычисляет среднюю цену по городам в графстве Greater Manchester:

    Интерфейс конструктора вопросов Metabase с данными UK price paid

  2. Нажмите кнопку Visualize, чтобы увидеть результаты в табличном виде.

    Визуализация Metabase, показывающая табличные результаты средних цен по городам

  3. Под результатами нажмите кнопку Visualization, чтобы изменить визуализацию на столбчатую диаграмму (или любой другой доступный вариант):

    Круговая диаграмма в Metabase со средней ценой по городам в Greater Manchester

Узнайте больше

Дополнительную информацию о Metabase и создании панелей мониторинга можно найти, обратившись к документации Metabase.

Navigation