Перейти к основному содержимому
Перейти к основному содержимому

Power BI

ClickHouse Supported

Microsoft Power BI может выполнять запросы к данным или загружать их в память из ClickHouse Cloud или самоуправляемого развертывания.

Существует несколько версий Power BI, которые вы можете использовать для визуализации ваших данных:

  • Power BI Desktop: настольное приложение для Windows для создания панелей и визуализаций
  • Power BI Service: доступно в Azure как SaaS для размещения панелей, созданных в Power BI Desktop

Power BI требует, чтобы вы создавали свои панели в настольной версии и публиковали их в Power BI Service.

Этот учебник проведет вас через следующие этапы:

Prerequisites​

Power BI Installation​

Этот учебник предполагает, что у вас установлена Microsoft Power BI Desktop на вашем компьютере с Windows. Вы можете скачать и установить Power BI Desktop здесь

Мы рекомендуем обновить Power BI до последней версии. Соединитель ClickHouse доступен по умолчанию с версии 2.137.751.0.

Gather your ClickHouse connection details​

Вам понадобятся следующие данные для подключения к вашему экземпляру ClickHouse:

  • Хост - ClickHouse
  • Имя пользователя - Учетные данные пользователя
  • Пароль - Пароль пользователя
  • База данных - Имя базы данных на экземпляре, к которому вы хотите подключиться

Power BI Desktop​

Чтобы начать запрашивать данные в Power BI Desktop, вам нужно выполнить следующие шаги:

  1. Установить драйвер ClickHouse ODBC
  2. Найти соединитель ClickHouse
  3. Подключиться к ClickHouse
  4. Запрашивать и визуализировать ваши данные

Install the ODBC Driver​

Скачайте последнюю версии ClickHouse ODBC.

Выполните поставленный установщик .msi и следуйте инструкциям мастера.

Мастер установки драйвера ClickHouse ODBC с вариантами установки

примечание

Отладочные символы являются необязательными и не требуются

Verify ODBC Driver​

После завершения установки драйвера вы можете проверить успешность установки:

Поиск ODBC в меню Пуск и выберите "ODBC Data Sources (64-bit)".

Поиск Windows, показывающий вариант ODBC Data Sources (64-bit)

Убедитесь, что драйвер ClickHouse находится в списке.

Администраторы источников данных ODBC, показываемые драйверами ClickHouse на вкладке Драйверы

Find the ClickHouse Connector​

примечание

Доступно в версии 2.137.751.0 Power BI Desktop

На начальном экране Power BI Desktop нажмите "Получить данные".

Главный экран Power BI Desktop с кнопкой Получить данные

Поиск по "ClickHouse"

Диалоговое окно Power BI Получить данные с ClickHouse в строке поиска

Connect to ClickHouse​

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

  • Хост (обязательный) - Домен/адрес вашего экземпляра. Убедитесь, что он указан без префиксов/суффиксов.
  • Порт (обязательный) - Порт вашего экземпляра.
  • База данных - Имя вашей базы данных.
  • Опции - Любая ODBC опция, указанная на странице ClickHouse ODBC GitHub
  • Режим подключения к данным - DirectQuery
Диалог подключения ClickHouse с полями хоста, порта, базы данных и режима под�ключения

примечание

Мы рекомендуем выбирать DirectQuery для выполнения запросов к ClickHouse напрямую.

Если у вас есть случай использования, связанный с небольшим объемом данных, вы можете выбрать режим импорта, и вся информация будет загружена в Power BI.

  • Укажите имя пользователя и пароль
Диалог.credentials для подключения ClickHouse для имени пользователя и пароля

Query and Visualise Data​

В конечном итоге вы должны увидеть базы данных и таблицы в представлении Навигатор. Выберите нужную таблицу и нажмите "Загрузить", чтобы импортировать данные из ClickHouse.

Представление Навигатор Power BI, показывающее таблицы базы данных ClickHouse и образец данных

После завершения импорта ваши данные ClickHouse должны быть доступны в Power BI, как обычно.


Power BI Service​

Чтобы использовать Microsoft Power BI Service, вам нужно создать локальный шлюз данных.

Для получения дополнительной информации о том, как настроить пользовательские соединители, пожалуйста, обратитесь к документации Microsoft о том, как использовать пользовательские соединители данных с локальным шлюзом данных.

ODBC Driver (Import Only)​

Мы рекомендуем использовать соединитель ClickHouse, который использует DirectQuery.

Установите драйвер ODBC на локальный шлюз данных и проверьте, как описано выше.

Create a new User DSN​

После завершения установки драйвера можно создать источник данных ODBC. Поиск ODBC в меню Пуск и выберите "ODBC Data Sources (64-bit)".

Поиск Windows, показывающий вариант ODBC Data Sources (64-bit)

Нам нужно добавить новый пользовательский DSN. Нажмите кнопку "Добавить" слева.

Администраторы источников данных ODBC с выделенной кнопкой Добавить для создания нового DSN

Выберите версию драйвера ODBC для Unicode.

Диалог создания нового источника данных с выбором драйвера ClickHouse Unicode

Заполните данные подключения.

Диалог конфигурации драйвера ClickHouse ODBC с параметрами подключения

примечание

Если вы используете развертывание с включенным SSL (например, ClickHouse Cloud или самоуправляемый экземпляр), в поле SSLMode вы должны указать require.

  • Host всегда должен указываться без протокола (т.е. http:// или https://).
  • Timeout — это целое число, представляющее секунды. Значение по умолчанию: 30 секунд.

Get Data Into Power BI​

Если у вас еще не установлен Power BI скачайте и установите Power BI Desktop.

На начальном экране Power BI Desktop нажмите "Получить данные".

Главный экран Power BI Desktop с кнопкой Получить данные

Выберите "Другое" -> "ODBC".

Диалог Power BI Получить данные с выбранной опцией ODBC в категории Другое

Выберите ранее созданный вами источник данных из списка.

Диалог выбора драйвера ODBC с настроенным DSN ClickHouse

примечание

Если вы не указали учетные данные во время создания источника данных, вам будет предложено указать имя пользователя и пароль.

Диалог ввода учетных данных для подключения ODBC DSN

В конечном итоге вы должны увидеть базы данных и таблицы в представлении Навигатор. Выберите нужную таблицу и нажмите "Загрузить", чтобы импортировать данные из ClickHouse.

Представление Навигатор Power BI, показывающее таблицы базы данных ClickHouse и образец данных

После завершения импорта ваши данные ClickHouse должны быть доступны в Power BI, как обычно.

Known Limitations​

UInt64​

Беззнаковые целочисленные типы, такие как UInt64 или большие, не будут загружены в набор данных автоматически, поскольку Int64 является максимальным целым числом, поддерживаемым Power BI.

примечание

Чтобы правильно импортировать данные, перед нажатием кнопки "Загрузить" в Навигаторе сначала нажмите "Преобразовать данные".

В этом примере таблица pageviews содержит столбец UInt64, который по умолчанию распознается как "Binary". "Преобразовать данные" открывает редактор Power Query, где мы можем переназначить тип столбца, установив его, например, как текст.

Редактор Power Query, показывающий преобразование типа данных для столбца UInt64

После завершения нажмите "Закрыть и применить" в верхнем левом углу и продолжите загрузку данных.