# Подключение Power BI

В этой статье мы пройдем процесс подключения Microsoft Power BI к **IoT Query**. Для большей наглядности мы также создадим панель мониторинга, которая подключается к аналитической базе данных и отслеживает статус транспортных средств в реальном времени, используя Microsoft Power BI.

{% hint style="info" %}
Это руководство является частью **IoT Query** наборa документации и специально охватывает подключение Power BI к вашему хранилищу данных. Если вы всё ещё выбираете BI‑инструмент, обратитесь к [Выбор инструментов BI](https://www.navixy.com/docs/analytics/ru/iot-query/connection-setup/selecting-bi-tools) обзору.
{% endhint %}

## Функции панели мониторинга

* Отобразить общее количество транспортных средств
* Визуализация статусов движения транспортных средств (движется/остановлено/припарковалось)
* Визуализация статусов подключения (активен/в простое/офлайн)
* Подробная таблица с текущим статусом всех транспортных средств
* Фильтрация по типу транспортного средства, группе, статусу движения и статусу подключения
* Возможности экспорта данных и отчетов

## Технические требования

* Windows 10/11 или Windows Server 2016+
* Microsoft Power BI Desktop (текущая версия)
* Учетная запись Microsoft для доступа к Power BI Service (необязательно)
* Минимум 4 ГБ ОЗУ (рекомендуется 8 ГБ)
* Доступ в интернет для подключения к базе данных

## Установка и настройка

### 1. Установите Power BI Desktop

1. Скачайте Power BI Desktop с официального сайта Microsoft: <https://powerbi.microsoft.com/desktop/>
2. Запустите установщик и следуйте его инструкциям.

### 2. Скачайте файл панели мониторинга

1. Скачайте [moving\_status\_dashboard.pbix](https://raw.githubusercontent.com/SquareGPS/bi-intergrations/main/power_bi/moving_status_dashboard.pbix) файл из [репозитория bi-intergrations](https://github.com/SquareGPS/bi-intergrations) -> `power_bi`. Вы можете клонировать весь репозиторий для дальнейшей работы:

   ```sh
   git clone https://github.com/SquareGPS/bi-intergrations.git
   ```
2. Откройте загруженный `moving_status_dashboard.pbix` файл двойным щелчком или через меню Power BI Desktop: **File → Open**.

## Подключение к базе данных

### 1. Обновите параметры подключения

1. После открытия файла панели мониторинга перейдите в **Transform data → Edit parameters**.
2. Обновите следующие параметры:

* `DB_HOST` - адрес сервера базы данных
* `DB_NAME` - имя базы данных
* `DB_USER` - имя пользователя
* `DB_PASS` - пароль (не сохраняйте файлы с реальными учетными данными в общем доступе)
* `DB_PORT` - порт подключения (по умолчанию 5432)

3. Нажмите **OK** и примените изменения.

#### Справочник параметров подключения

<table><thead><tr><th width="189.727294921875">Параметр Lakehouse</th><th width="214.1817626953125">Расположение настроек Power BI</th><th>Примечания</th></tr></thead><tbody><tr><td><strong>Хост</strong></td><td><code>DB_HOST</code> параметр</td><td>Адрес сервера базы данных, указанный в вашем приветственном письме</td></tr><tr><td><strong>Порт</strong></td><td><code>DB_PORT</code> параметр</td><td>По умолчанию 5432 для PostgreSQL</td></tr><tr><td><strong>Имя базы данных</strong></td><td><code>DB_NAME</code> параметр</td><td>Назначенное вам имя базы данных</td></tr><tr><td><strong>Имя пользователя</strong></td><td><code>DB_USER</code> параметр</td><td>Ваше имя пользователя базы данных</td></tr><tr><td><strong>Пароль</strong></td><td><code>DB_PASS</code> параметр</td><td>Ваш защищённый пароль базы данных</td></tr><tr><td><strong>Режим SSL</strong></td><td>Настройки подключения</td><td>Установите значение <strong>require</strong> в диалоговом окне Options</td></tr><tr><td><strong>Схема</strong></td><td>Редактор запросов</td><td>Укажите схему (<strong>raw_business_data</strong> или <strong>raw_telematics_data</strong>) в каждом запросе</td></tr></tbody></table>

### 2. Настройте учетные данные

1. При первом подключении Power BI запросит учетные данные для доступа к базе данных.
2. Выберите **Учетная запись и пароль базы данных** в качестве типа аутентификации.
3. Введите учетные данные, предоставленные вашим администратором.
4. Установите уровень конфиденциальности на **Organization** или **Private**.

## Использование панели мониторинга

После настройки подключения вы можете:

1. **Обновлять данные** - нажать кнопку **Refresh** на ленте или использовать сочетание клавиш Ctrl+R.
2. **Использовать фильтры** - применять фильтры на правой панели или непосредственно на элементах отчета:
   1. Фильтр по типу транспортного средства
   2. Фильтр по группам
   3. Фильтр по статусу движения/подключения
3. **Изучать данные в деталях** - щелкните по элементам визуализации, чтобы просмотреть подробную информацию.
4. **Создавать закладки** - сохранять конкретные настройки фильтров и представления для быстрого доступа.

## Конфигурация обновления данных

### Локальное обновление

1. В Power BI Desktop откройте меню **Home → Refresh**.
2. Чтобы настроить регулярные обновления через Power BI Service, опубликуйте отчет в Power BI Service.

### Облачное обновление (Power BI Service)

1. (Необязательно) Опубликуйте панель мониторинга в Power BI Service, используя кнопку **Publish** в Power BI Desktop.
2. В Power BI Service перейдите в настройки набора данных.
3. В разделе **Scheduled refresh** настройте частоту обновления.
4. Чтобы подключиться к локальной или приватной базе данных, вам потребуется установить и настроить Power BI Gateway.

## Устранение неполадок

### Проблемы с подключением к базе данных

* **Ошибка подключения:** Проверьте корректность учетных данных и параметров подключения.
* **Ошибка брандмауэра:** Убедитесь, что ваш IP-адрес добавлен в белый список для доступа к базе данных.
* **Проблемы с Gateway:** При использовании Power BI Gateway проверьте состояние службы шлюза.

### Проблемы с производительностью

* **Медленная загрузка визуализаций:**
  * Уменьшите количество одновременно отображаемых элементов
  * Проверьте режим Import/DirectQuery в модели данных
* **Высокое потребление памяти:**
  * Сократите объем импортируемых данных, применив фильтры на уровне запроса
  * Удалите ненужные столбцы из модели данных

### Другие проблемы

Вот несколько трюков, которые могут помочь исправить распространённые проблемы:

1. Перезапустите Power BI Desktop и файл панели мониторинга
2. Проверьте наличие обновлений Power BI Desktop
3. При необходимости переустановите Power BI Desktop
4. Очистите кеш Power BI: **File → Options → Global → Clear items from cache**

## Дальнейшие шаги

После успешного подключения Power BI к вашей инстанции Private Telematics Lakehouse мы рекомендуем вам:

* Изучите доступные схемы данных, просматривая раздел [Обзор схемы](https://www.navixy.com/docs/analytics/ru/iot-query/schema-overview) чтобы лучше понять структуру данных и взаимосвязи.
* Начните с простых запросов, ориентированных на конкретные бизнес‑сущности, прежде чем создавать сложные панели — ознакомьтесь с нашим [примером запросов](https://www.navixy.com/docs/analytics/ru/example-queries) в качестве примера.

### **Поддержка**

По техническим вопросам или запросам доступа к демонстрационной базе данных, пожалуйста, свяжитесь: <support@squaregps.com>