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

​
Цель

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

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

Соберите сведения о подключении

Чтобы подключиться к ClickHouse по HTTP(S), вам понадобится следующая информация:Сведения о подключении для вашего сервиса ClickHouse Cloud доступны в консоли ClickHouse Cloud. Выберите сервис и нажмите Connect:
Кнопка подключения сервиса ClickHouse Cloud
Выберите HTTPS. Сведения о подключении будут показаны в примере команды curl.
Сведения о подключении к ClickHouse Cloud по HTTPS
Если вы используете самоуправляемый 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. Если драйвер установлен правильно, в выпадающем меню Database type появится ClickHouse:
  4. Укажите для своей базы данных Display name — это параметр Metabase, поэтому можно использовать любое имя.
  5. Введите сведения о подключении к базе данных ClickHouse. Включите защищённое подключение, если ваш сервер ClickHouse настроен на использование SSL. Например:
  6. Нажмите кнопку Save, и Metabase просканирует базу данных на наличие таблиц.
4

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

  1. Выйдите из Admin settings, нажав кнопку Exit admin в правом верхнем углу.
  2. В правом верхнем углу нажмите меню + New и обратите внимание, что вы можете задавать вопросы, выполнять SQL-запросы и создавать панель мониторинга:
  3. Например, вот SQL-запрос, выполненный к таблице uk_price_paid, который возвращает среднюю цену покупки по годам с 1995 по 2022:
5

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

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

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

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