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

Databrain — это платформа встраиваемой аналитики, которая позволяет создавать интерактивные панели мониторинга, метрики и визуализации данных и делиться ими с вашими клиентами. Databrain подключается к ClickHouse через интерфейс HTTPS, поэтому визуализировать и анализировать данные ClickHouse можно в современном и удобном интерфейсе.

В этом руководстве описано, как подключить Databrain к вашему экземпляру ClickHouse.

• База данных ClickHouse, размещённая либо в вашей инфраструктуре, либо в ClickHouse Cloud.
• Учётная запись Databrain.
• Рабочее пространство Databrain для подключения источника данных.

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

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

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

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

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

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

Разрешите IP-адреса Databrain (если требуется)

Если в вашем экземпляре ClickHouse включена IP-фильтрация, вам нужно будет добавить IP-адреса Databrain в белый список.

Для пользователей ClickHouse Cloud:

1. Перейдите к своему сервису в консоли ClickHouse Cloud
2. Перейдите в Settings → Security
3. Добавьте IP-адреса Databrain в список разрешённых

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

1. Войдите в учетную запись Databrain и перейдите в рабочее пространство, в котором хотите добавить источник данных.

2. В меню навигации выберите Data Sources.

3. Нажмите Add a Data Source или Connect Data Source.

4. Выберите ClickHouse из списка доступных коннекторов.

5. Заполните сведения о подключении:
   • Destination Name: Укажите понятное имя для этого подключения (например, "Production ClickHouse" или "Analytics DB")
   • Host: Укажите URL хоста ClickHouse (например, https://your-instance.region.aws.clickhouse.cloud)
   • Port: Введите 8443 (порт HTTPS по умолчанию для ClickHouse)
   • Username: Введите имя пользователя ClickHouse
   • Password: Введите пароль ClickHouse

6. Нажмите Test Connection, чтобы убедиться, что Databrain может подключиться к вашему экземпляру ClickHouse.

7. После успешной проверки подключения нажмите Save или Connect, чтобы добавить источник данных.

Настройте разрешения пользователя

Убедитесь, что пользователь ClickHouse, от имени которого выполняется подключение, имеет необходимые разрешения:

-- Предоставьте разрешения на чтение информации о схеме
GRANT SELECT ON information_schema.* TO your_databrain_user;

-- Предоставьте доступ на чтение к вашей базе данных и таблицам
GRANT SELECT ON your_database.* TO your_databrain_user;

Замените your_databrain_user и your_database на фактические имя пользователя и имя базы данных.

1. После подключения перейдите в рабочее пространство в Databrain.

2. В обозревателе данных отобразится список таблиц ClickHouse.

3. Нажмите на таблицу, чтобы изучить её схему и просмотреть данные.

1. Нажмите Create Metric, чтобы начать создавать визуализации на основе данных ClickHouse.

2. Выберите источник данных ClickHouse и таблицу, которую хотите визуализировать.

3. Используйте интуитивно понятный интерфейс Databrain, чтобы:

   • Выбрать размерности и показатели
   • Применить фильтры и агрегации
   • Выбрать типы визуализации (столбчатые, линейные, круговые диаграммы, таблицы и т. д.)
   • Добавить пользовательские SQL-запросы для расширенного анализа

4. Сохраните метрику, чтобы использовать её на разных панелях мониторинга.

1. Нажмите Create Dashboard, чтобы создать панель мониторинга.

2. Добавьте метрики на панель мониторинга, перетаскивая сохранённые метрики.

3. Настройте структуру и внешний вид панели мониторинга.

4. Поделитесь панелью мониторинга с командой или встроите её в своё приложение.

Databrain предлагает несколько расширенных возможностей при работе с ClickHouse:

• Пользовательская SQL-консоль: Пишите и выполняйте пользовательские SQL-запросы напрямую к базе данных ClickHouse
• Мультиарендность и выделенная архитектура: Подключайте базу данных ClickHouse как для выделенной, так и для мультиарендной архитектуры
• Планирование отчетов: Настраивайте автоматические отчеты и отправляйте их заинтересованным лицам по электронной почте
• Инсайты на базе ИИ: Используйте ИИ для создания сводок и получения инсайтов из данных
• Встраиваемая аналитика: Встраивайте панели мониторинга и метрики напрямую в свои приложения
• Семантический слой: Создавайте переиспользуемые модели данных и бизнес-логику

Если вам не удается подключиться к ClickHouse:

1. Проверьте учетные данные: еще раз проверьте имя пользователя, пароль и URL хоста
2. Проверьте порт: убедитесь, что используете порт 8443 для HTTPS (или 8123 для HTTP, если не используете SSL)
3. Белый список IP-адресов: убедитесь, что IP-адреса Databrain добавлены в белый список в настройках межсетевого экрана/безопасности ClickHouse
4. SSL/TLS: убедитесь, что SSL/TLS правильно настроен, если вы используете HTTPS
5. Разрешения пользователя: убедитесь, что у пользователя есть разрешения SELECT для information_schema и ваших целевых баз данных

Если запросы выполняются медленно:

1. Оптимизируйте запросы: эффективно используйте фильтры и агрегации
2. Создавайте materialized view: для часто используемых агрегаций рассмотрите создание materialized view в ClickHouse
3. Используйте подходящие типы данных: убедитесь, что в схеме ClickHouse используются оптимальные типы данных
4. Оптимизация индексов: используйте первичные ключи и индексы пропуска ClickHouse

Чтобы узнать больше о возможностях Databrain и о том, как создавать мощную аналитику:

• Документация Databrain
• Руководство по интеграции ClickHouse
• Создание панелей мониторинга
• Создание метрик