> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-detect-table-modification.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Metabase — это простой в использовании инструмент с открытым исходным кодом и графическим интерфейсом для анализа ваших данных.

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

export const PartnerBadge = () => {
  return <div className="PartnerBadge">
            <div className="PartnerBadgeIcon">
                <svg width="16" height="16" viewBox="0 0 16 16" fill="none" xmlns="http://www.w3.org/2000/svg">
                    <polyline points="12.5 9.5 10 12 6 11 2.5 8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="4.54 4.41 8 3.5 11.46 4.41" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M2.15,3.78 L0.55,6.95 A0.5,0.5 0,0,0 0.77,7.62 L2.5,8.5 L4.54,4.41 L2.82,3.55 A0.5,0.5 0,0,0 2.15,3.78 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M13.5,8.5 L15.23,7.62 A0.5,0.5 0,0,0 15.45,6.95 L13.85,3.78 A0.5,0.5 0,0,0 13.18,3.55 L11.46,4.41 Z" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <path d="M11.5,4.5 L9,4.5 L6.15,7.27 A0.5,0.5 0,0,0 6.24,8.05 C7.33,8.74 8.81,8.72 10,7.5 L12.5,9.5 L13.5,8.5" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                    <polyline points="7.75 13.5 5.15 12.85 3.5 11.67" stroke="currentColor" strokeLinecap="round" strokeLinejoin="round" strokeWidth="1" />
                </svg>
            </div>
            Партнерская интеграция
        </div>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

Metabase — это простой в использовании инструмент с открытым исходным кодом и удобным интерфейсом для работы с данными. Metabase — это Java-приложение, которое можно запустить, просто <a href="https://www.metabase.com/start/oss/jar" target="_blank">скачав JAR-файл</a> и выполнив команду `java -jar metabase.jar`. Metabase подключается к ClickHouse с помощью JDBC-драйвера, который нужно скачать и поместить в папку `plugins`:

<div id="goal">
  ## Цель
</div>

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

<Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=ed3177332a1002ccce163945a51229d1" alt="Визуализация круговой диаграммы в Metabase с данными из ClickHouse" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_08.webp" />

<p />

<Tip>
  **Добавьте данные**

  Если у вас нет датасета для работы, можно добавить один из примеров. В этом руководстве используется датасет [UK Price Paid](/ru/get-started/sample-datasets/uk-price-paid), так что можете выбрать его. В этой категории документации есть и другие варианты.
</Tip>

<div id="1-gather-your-connection-details">
  ## 1. Подготовьте сведения о подключении
</div>

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

| Параметр(ы)               | Описание                                                                                                               |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `HOST` and `PORT`         | Обычно используется порт 8443 при использовании TLS и 8123 без TLS.                                                    |
| `DATABASE NAME`           | По умолчанию есть база данных `default`; используйте имя базы данных, к которой хотите подключиться.                   |
| `USERNAME` and `PASSWORD` | По умолчанию имя пользователя — `default`. Используйте имя пользователя, подходящее для вашего сценария использования. |

Сведения о подключении для вашего сервиса ClickHouse Cloud доступны в консоли ClickHouse Cloud.
Выберите сервис и нажмите **Connect**:

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2d1e2340e1ddccf3199ca1e41eeba836" size="md" alt="Кнопка подключения сервиса ClickHouse Cloud" border width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />

Выберите **HTTPS**. Сведения о подключении будут показаны в примере команды `curl`.

<Image img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/0yJtAU6cqYAQlCWC/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=0yJtAU6cqYAQlCWC&q=85&s=2ea2af378046d5ec87ea8e78de573bc1" size="md" alt="Сведения о подключении к ClickHouse Cloud по HTTPS" border width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />

Если вы используете самоуправляемый ClickHouse, сведения о подключении задаёт ваш администратор ClickHouse.

<div id="2--download-the-clickhouse-plugin-for-metabase">
  ## 2.  Загрузите плагин ClickHouse для Metabase
</div>

1. Если у вас нет папки `plugins`, создайте её в качестве подпапки в каталоге, где сохранён `metabase.jar`.

2. Плагин представляет собой JAR-файл с именем `clickhouse.metabase-driver.jar`. Загрузите последнюю версию JAR-файла по адресу <a href="https://github.com/clickhouse/metabase-clickhouse-driver/release" target="_blank">[https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest](https://github.com/clickhouse/metabase-clickhouse-driver/releases/latest)</a>

3. Сохраните `clickhouse.metabase-driver.jar` в папке `plugins`.

4. Запустите (или перезапустите) Metabase, чтобы драйвер загрузился корректно.

5. Откройте Metabase по адресу <a href="http://localhost:3000/" target="_blank">[http://hostname:3000](http://hostname:3000)</a>. При первом запуске вы увидите экран приветствия, после чего нужно будет ответить на ряд вопросов. Если система предложит выбрать базу данных, выберите "**Я добавлю данные позже**":

<div id="3--connect-metabase-to-clickhouse">
  ## 3.  Подключите Metabase к ClickHouse
</div>

1. Нажмите значок шестерёнки в правом верхнем углу и выберите **Admin Settings**, чтобы перейти на <a href="http://localhost:3000/admin/settings/setup" target="_blank">страницу администратора Metabase</a>.

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

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

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_01.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=a5220dc3f694834daa750814c6de5c9f" alt="Выбор базы данных в Metabase, где ClickHouse доступен как один из вариантов" border width="1168" height="504" data-path="images/integrations/data-visualization/metabase_01.webp" />

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

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

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_02.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=05c38065e8d96c5b98936ec7d7dc8d22" alt="Форма сведений о подключении в Metabase для базы данных ClickHouse" border width="682" height="1020" data-path="images/integrations/data-visualization/metabase_02.webp" />

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

<div id="4-run-a-sql-query">
  ## 4. Выполните SQL-запрос
</div>

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

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

   <Image size="sm" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_03.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=a47bdbefbe0a384f44aea395faf995c7" alt="Меню New в Metabase с вариантами создания вопросов, SQL-запросов и панелей мониторинга" border width="283" height="322" data-path="images/integrations/data-visualization/metabase_03.webp" />

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

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_04.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=5951b26162f74f2cecc6b7b8c16e7f4a" alt="Редактор SQL в Metabase с запросом к данным UK price paid" border width="674" height="1003" data-path="images/integrations/data-visualization/metabase_04.webp" />

<div id="5-ask-a-question">
  ## 5. Задайте вопрос
</div>

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

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_06.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=944434a8031be4118313eb8fe33d56af" alt="Интерфейс конструктора вопросов Metabase с данными о ценах в Великобритании" border width="869" height="1049" data-path="images/integrations/data-visualization/metabase_06.webp" />

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

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_07.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=3b06e3197791ffbbeb6842c96e464a01" alt="Визуализация Metabase с табличными результатами средней цены по городам" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_07.webp" />

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

   <Image size="md" img="https://mintcdn.com/private-7c7dfe99-detect-table-modification/svLCKm9RWi4jibqG/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=svLCKm9RWi4jibqG&q=85&s=ed3177332a1002ccce163945a51229d1" alt="Круговая диаграмма Metabase со средней ценой по городам в Greater Manchester" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_08.webp" />

<div id="learn-more">
  ## Узнайте больше
</div>

Дополнительную информацию о Metabase и создании панелей мониторинга можно найти, <a href="https://www.metabase.com/docs/latest/" target="_blank">обратившись к документации Metabase</a>.
