> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/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>;
};

<PartnerBadge />

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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=87b54ca62deb669566b0a67ceac7e478" alt="Визуализация круговой диаграммы в Metabase с данными из ClickHouse" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_08.webp" />

<p />

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

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

<Steps>
  <Step title="Соберите сведения о подключении" id="1-gather-your-connection-details">
    Чтобы подключиться к ClickHouse по HTTP(S), вам понадобится следующая информация:

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

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

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/cloud-connect-button.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=ec0a298a33ca841e947fa5e8bae47362" alt="Кнопка подключения сервиса ClickHouse Cloud" width="998" height="932" data-path="images/_snippets/cloud-connect-button.webp" />
      </Frame>
    </div>

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

    <div className="ch-image-md">
      <Frame>
        <img src="https://mintcdn.com/private-7c7dfe99/CFFsa2agBPbviR4r/images/_snippets/connection-details-https.webp?fit=max&auto=format&n=CFFsa2agBPbviR4r&q=85&s=cb0fbd98aa2b5b7ca484c9f53395ee07" alt="Сведения о подключении к ClickHouse Cloud по HTTPS" width="1320" height="1184" data-path="images/_snippets/connection-details-https.webp" />
      </Frame>
    </div>

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

  <Step title="Скачайте плагин ClickHouse для Metabase" id="2--download-the-clickhouse-plugin-for-metabase">
    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>. При первом запуске вы увидите экран приветствия, и вам нужно будет ответить на ряд вопросов. Если появится запрос на выбор базы данных, выберите "**I'll add my data later**":
  </Step>

  <Step title="Подключите Metabase к ClickHouse" id="3--connect-metabase-to-clickhouse">
    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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_01.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=586acaa7da62b005cdc30f06f2319f11" 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_02.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=42c1c15bc5fa13bbb2e3102f57fcf1ac" alt="Форма сведений о подключении в Metabase для базы данных ClickHouse" border width="682" height="1020" data-path="images/integrations/data-visualization/metabase_02.webp" />

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

  <Step title="Выполните SQL-запрос" id="4-run-a-sql-query">
    1. Выйдите из **Admin settings**, нажав кнопку **Exit admin** в правом верхнем углу.

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

           <Image size="sm" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_03.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=2e11e4ee4b8c466e146cf02e3aec5164" 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_04.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=f868f4778e9a0a44e8f34485d3992e63" alt="Редактор SQL в Metabase, показывающий запрос к данным UK price paid" border width="674" height="1003" data-path="images/integrations/data-visualization/metabase_04.webp" />
  </Step>

  <Step title="Задайте вопрос" id="5-ask-a-question">
    1. Нажмите **+ New** и выберите **Question**. Обратите внимание, что вопрос можно построить, начав с базы данных и таблицы. Например, следующий вопрос задаётся к таблице `uk_price_paid` в базе данных `default`. Вот простой вопрос, который вычисляет среднюю цену по городам в графстве Greater Manchester:

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_06.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=315caa354ba8213b40c642f3a3e1a9ca" alt="Интерфейс конструктора вопросов Metabase с данными UK price paid" 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_07.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=e3b7c74397644bd33510044a6d24bad7" 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/etDiFo_9fGSe5rMN/images/integrations/data-visualization/metabase_08.webp?fit=max&auto=format&n=etDiFo_9fGSe5rMN&q=85&s=87b54ca62deb669566b0a67ceac7e478" alt="Круговая диаграмма в Metabase со средней ценой по городам в Greater Manchester" border width="1222" height="893" data-path="images/integrations/data-visualization/metabase_08.webp" />
  </Step>
</Steps>

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

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