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

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

Partner Integration

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

Цель​

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

Визуализация круговой диаграммы Metabase, показывающая данные из ClickHouse

Добавьте немного данных

Если у вас нет набора данных для работы, вы можете добавить один из примеров. В этом руководстве используется набор данных UK Price Paid, поэтому вы можете выбрать его. В той же категории документации есть и несколько других вариантов.

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

Чтобы подключиться к 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. Загрузка плагина 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":

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

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

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

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

    Выбор базы данных в Metabase, показывающий ClickHouse в качестве опции

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

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

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

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

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

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

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

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

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

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

5. Задайте вопрос​

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

    Интерфейс построения запроса Metabase с данными по ценам в Великобритании

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

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

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

    Круговая диаграмма Metabase со средними ценами по городам в Большом Манчестере

Подробнее​

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