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

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

Holistics — это платформа BI самообслуживания с ИИ и программируемым семантическим слоем для согласованных и надежных метрик.

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

​

Предварительные требования

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

• Разрешения: Чтобы добавлять новые источники данных, вы должны иметь роль Admin в Holistics.
• Сетевой доступ: Ваш сервер ClickHouse должен быть доступен с IP-адресов Holistics.
• Пользователь базы данных: Создайте для Holistics отдельного пользователя с правами только для чтения вместо учетной записи администратора.

​

Рекомендуемые привилегии

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

-- Пример: предоставление доступа на чтение к конкретной базе данных
GRANT SELECT ON my_database.* TO holistics_user;

-- Предоставление доступа к системным метаданным
GRANT SELECT ON system.* TO holistics_user;

1. ​

   Соберите сведения о подключении

   Чтобы подключиться к 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.

2. ​

   Настройте сетевой доступ

   Поскольку Holistics — облачное приложение, его серверы должны иметь доступ к вашей базе данных. У вас есть два варианта:

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

   2. Обратный SSH-туннель: Если ваша база данных находится в частной сети (VPC) и не может быть доступна публично, используйте Reverse SSH Tunnel.

3. ​

   Добавьте источник данных в Holistics

   1. В Holistics перейдите в Settings → Data Sources.

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

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

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

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

      • Success: Нажмите Save.
      • Failure: Проверьте имя пользователя и пароль, а также убедитесь, что IP-адреса Holistics добавлены в список разрешённых.

​

Известные ограничения

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

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

Полный список поддерживаемых возможностей см. на странице ограничений для конкретных баз данных.