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

С подключением Metabase к ClickHouse

Community Maintained

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

Цель​

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

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

Добавьте данные

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

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

To connect to ClickHouse with HTTP(S) you need this information:

  • The HOST and PORT: typically, the port is 8443 when using TLS or 8123 when not using TLS.

  • The DATABASE NAME: out of the box, there is a database named default, use the name of the database that you want to connect to.

  • The USERNAME and PASSWORD: out of the box, the username is default. Use the username appropriate for your use case.

The details for your ClickHouse Cloud service are available in the ClickHouse Cloud console. Select the service that you will connect to and click Connect:

ClickHouse Cloud service connect button

Choose HTTPS, and the details are available in an example curl command.

ClickHouse Cloud HTTPS connection details

If you are using self-managed ClickHouse, the connection details are set by your ClickHouse administrator.

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. Нажмите на значок шестеренки в правом верхнем углу и выберите Настройки администратора, чтобы перейти на вашу административную страницу Metabase.

  2. Нажмите Добавить базу данных. Альтернативно, вы можете нажать на вкладку Базы данных и выбрать кнопку Добавить базу данных.

  3. Если установка вашего драйвера прошла успешно, вы увидите ClickHouse в выпадающем меню для Тип базы данных:

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

  4. Дайте вашей базе данных Отображаемое имя, которое является настройкой Metabase - используйте любое имя, которое вам нравится.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Визуализация круговой диаграммы Metabase со средними ценами по городам в Большом Манчестере

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

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

Связанный контент​