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

​
Цель

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

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

​
1. Подготовьте сведения о подключении

Чтобы подключиться к ClickHouse по HTTP(S), вам понадобится следующая информация:
Параметр(ы)Описание
HOST and PORTОбычно используется порт 8443 при использовании TLS и 8123 без TLS.
DATABASE NAMEПо умолчанию есть база данных default; используйте имя базы данных, к которой хотите подключиться.
USERNAME and PASSWORDПо умолчанию имя пользователя — default. Используйте имя пользователя, подходящее для вашего сценария использования.
Сведения о подключении для вашего сервиса ClickHouse Cloud доступны в консоли ClickHouse Cloud. Выберите сервис и нажмите Connect: Выберите HTTPS. Сведения о подключении будут показаны в примере команды curl. Если вы используете самоуправляемый 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. При первом запуске вы увидите экран приветствия, после чего нужно будет ответить на ряд вопросов. Если система предложит выбрать базу данных, выберите “Я добавлю данные позже”:

​
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, нажав кнопку 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.
Последнее изменение 10 июня 2026 г.