> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/analytics/ru/iot-query/connection-setup/selecting-bi-tools/connecting-power-bi.md).

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

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

{% hint style="info" %}
эта документация **IoT Query** и, в частности, описывает подключение Power BI к вашему хранилищу данных. Если вы всё ещё выбираете, какой BI-инструмент использовать, обратитесь к [Выбор BI-инструментов](/docs/analytics/ru/iot-query/connection-setup/selecting-bi-tools.md) обзору.
{% 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>Query Editor</td><td>Укажите схему (<strong>raw_business_data</strong> или <strong>raw_telematics_data</strong>) в каждом запросе</td></tr></tbody></table>

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

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

## Использование дашборда

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

1. **Обновлять данные** - нажмите кнопку **Обновить** на ленте или используйте сочетание клавиш 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-адрес добавлен в allowlist для доступа к базе данных.
* **Проблемы с шлюзом:** При использовании 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 мы рекомендуем вам:

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

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

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/analytics/ru/iot-query/connection-setup/selecting-bi-tools/connecting-power-bi.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
