> ## 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.

> Holistics — это платформа на базе ИИ для BI самообслуживания и встроенной аналитики, которая помогает всем принимать более взвешенные решения благодаря управляемым и легкодоступным метрикам.

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

export const CommunityMaintainedBadge = () => {
  return <div className="CommunityMaintainedBadge">
            <div className="CommunityMaintainedIcon">
            <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" fill="currentColor" viewBox="0 0 256 256">
                <path d="M244.8,150.4a8,8,0,0,1-11.2-1.6A51.6,51.6,0,0,0,192,128a8,8,0,0,1-7.37-4.89,8,8,0,0,1,0-6.22A8,8,0,0,1,192,112a24,24,0,1,0-23.24-30,8,8,0,1,1-15.5-4A40,40,0,1,1,219,117.51a67.94,67.94,0,0,1,27.43,21.68A8,8,0,0,1,244.8,150.4ZM190.92,212a8,8,0,1,1-13.84,8,57,57,0,0,0-98.16,0,8,8,0,1,1-13.84-8,72.06,72.06,0,0,1,33.74-29.92,48,48,0,1,1,58.36,0A72.06,72.06,0,0,1,190.92,212ZM128,176a32,32,0,1,0-32-32A32,32,0,0,0,128,176ZM72,120a8,8,0,0,0-8-8A24,24,0,1,1,87.24,82a8,8,0,1,0,15.5-4A40,40,0,1,0,37,117.51,67.94,67.94,0,0,0,9.6,139.19a8,8,0,1,0,12.8,9.61A51.6,51.6,0,0,1,64,128,8,8,0,0,0,72,120Z"></path>
            </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>;
};

<CommunityMaintainedBadge />

[Holistics](https://www.holistics.io/) — это платформа BI самообслуживания с ИИ и программируемым семантическим слоем для согласованных и надежных метрик.

Подключив ClickHouse к Holistics, ваши команды получат быстрый и надежный опыт самообслуживания с поддержкой ИИ, основанный на семантическом слое, описанном в коде. Бизнес-пользователи смогут уверенно работать с данными с помощью drag-and-drop и ИИ, а вы сохраните определения метрик переиспользуемыми, компонуемыми и версионируемыми в Git.

<div id="prerequisites">
  ## Предварительные требования
</div>

Перед подключением убедитесь, что выполнены следующие условия:

* **Разрешения:** Чтобы добавлять новые источники данных, вы должны иметь роль Admin в Holistics.
* **Сетевой доступ:** Ваш сервер ClickHouse должен быть доступен с [IP-адресов Holistics](https://docs.holistics.io/docs/connect/ip-whitelisting).
* **Пользователь базы данных:** Создайте для Holistics отдельного пользователя с правами только для чтения вместо учетной записи администратора.

<div id="recommended-privileges">
  ### Рекомендуемые привилегии
</div>

Выделенному пользователю требуются привилегии `SELECT` для таблиц, которые вы хотите запрашивать, а также для таблиц `system` (для определения схемы).

```sql theme={null}
-- Example: Grant read access to a specific database
GRANT SELECT ON my_database.* TO holistics_user;

-- Grant access to system metadata
GRANT SELECT ON system.* TO holistics_user;
```

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

    | **Parameter**     | **Description**                                                                                |
    | ----------------- | ---------------------------------------------------------------------------------------------- |
    | **Host**          | Имя хоста вашего сервера ClickHouse (например, `mz322.eu-central-1.aws.clickhouse.cloud`).     |
    | **Port**          | **8443** для ClickHouse Cloud (SSL/TLS). **8123** для самоуправляемых экземпляров без SSL.     |
    | **Database Name** | Имя базы данных, к которой вы хотите подключиться. Обычно по умолчанию используется `default`. |
    | **Username**      | Пользователь базы данных. По умолчанию — `default`.                                            |
    | **Password**      | Пароль пользователя базы данных.                                                               |

    Эти сведения можно найти, нажав кнопку **Connect** в консоли ClickHouse Cloud и выбрав **HTTPS**.

    <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_01.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=512a3ef076212baa4887e0f241b400c4" alt="Расположение кнопки Connect в консоли ClickHouse Cloud" border width="998" height="932" data-path="images/integrations/data-visualization/holistics_01.webp" />
  </Step>

  <Step title="Настройте сетевой доступ" id="step-2-configure-network-access">
    Поскольку Holistics — облачное приложение, его серверы должны иметь доступ к вашей базе данных. У вас есть два варианта:

    1. **Прямое подключение (рекомендуется):** Добавьте IP-адреса Holistics в список разрешённых в вашем межсетевом экране или в ClickHouse Cloud IP Access List. Список IP-адресов можно найти в руководстве [IP Whitelisting](https://docs.holistics.io/docs/connect/ip-whitelisting).

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_02.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=ec2b20fe5329b6bd9ed39a5547b5c1cc" alt="Пример добавления IP-адресов в список разрешённых в ClickHouse Cloud" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_02.webp" />

    2. **Обратный SSH-туннель:** Если ваша база данных находится в частной сети (VPC) и не может быть доступна публично, используйте [Reverse SSH Tunnel](https://docs.holistics.io/docs/connect/connect-tunnel).
  </Step>

  <Step title="Добавьте источник данных в Holistics" id="step-3-add-data-source-in-holistics">
    1. В Holistics перейдите в **Settings → источник данных**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_03.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=140bed8bce68e86bcb0f42e6486ea30a" alt="Переход к источнику данных в настройках Holistics" border width="1647" height="1129" data-path="images/integrations/data-visualization/holistics_03.webp" />

    2. Нажмите **New Data Source** и выберите **ClickHouse**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_04.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=d92626890c46a53d7ff9dc980c02cf6a" alt="Выбор ClickHouse из списка новых источников данных" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_04.webp" />

    3. Заполните форму данными, собранными на шаге 1.

       | **Field**         | **Setting**                                                                                |
       | ----------------- | ------------------------------------------------------------------------------------------ |
       | **Host**          | Имя хоста ClickHouse                                                                       |
       | **Port**          | `8443` (или `8123`)                                                                        |
       | **Require SSL**   | Включите параметр (**ON**), если используете порт 8443 (обязательно для ClickHouse Cloud). |
       | **Database Name** | `default` (или имя вашей базы данных)                                                      |

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_05.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=cf2745f7ec9288d499a9d1a8ba349a73" alt="Заполнение сведений о подключении к ClickHouse в Holistics" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_05.webp" />

    4. Нажмите **Test Connection**.

           <Image size="md" img="https://mintcdn.com/private-7c7dfe99/PWQnWTwcu17exYX2/images/integrations/data-visualization/holistics_06.webp?fit=max&auto=format&n=PWQnWTwcu17exYX2&q=85&s=c48de7963b5e10198c670e3f62ec4496" alt="Успешная проверка подключения к ClickHouse в Holistics" border width="1651" height="1131" data-path="images/integrations/data-visualization/holistics_06.webp" />

       * **Success:** Нажмите **Save**.
       * **Failure:** Проверьте имя пользователя и пароль, а также убедитесь, что [IP-адреса Holistics добавлены в список разрешённых](https://docs.holistics.io/docs/connect/ip-whitelisting).
  </Step>
</Steps>

<div id="known-limitations">
  ## Известные ограничения
</div>

Holistics поддерживает большинство стандартных возможностей SQL в ClickHouse, за следующими исключениями:

* **Running Total:** Эта аналитическая функция в ClickHouse пока поддерживается ограниченно.
* **Вложенные типы данных:** Для глубоко вложенных структур JSON или Array перед визуализацией может потребоваться выравнивание с помощью SQL-моделей.

Полный список поддерживаемых возможностей см. на [странице ограничений для конкретных баз данных](https://docs.holistics.io/docs/connect/faqs/clickhouse-limitations).