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

Community Maintained

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

Цель

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

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

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

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

Чтобы подключиться к ClickHouse с помощью HTTP(S), вам необходима следующая информация:

• ХОСТ и ПОРТ: как правило, порт 8443 при использовании TLS или 8123 при отсутствии TLS.

• ИМЯ БАЗЫ ДАННЫХ: по умолчанию существует база данных с именем default, используйте имя базы данных, к которой вы хотите подключиться.

• ИМЯ ПОЛЬЗОВАТЕЛЯ и ПАРОЛЬ: по умолчанию имя пользователя default. Используйте имя пользователя, подходящее для вашего случая.

Данные для вашего сервиса ClickHouse Cloud доступны в консоли ClickHouse Cloud. Выберите сервис, к которому вы хотите подключиться, и нажмите Подключиться:

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

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

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

   

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

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

   

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

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

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

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

   

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

   

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

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

   

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

   

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

   

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

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