Использование REST API Microsoft Power BI с сервером отчетов Power BI

Как и было обещано в предыдущей статье» Используйте Power BI для мониторинга… Power BI », это учебник, призванный объяснить, как использовать REST API Microsoft Power BI, но с ограничениями среды сервера отчетов. Пойдем !

В преамбуле документации Microsoft говорится, что «API Power BI REST предоставляют конечные точки службы для внедрения, администрирования, управления и пользовательских ресурсов. “.

О чем мы говорим ?

Вот, прежде всего, определение API, данное CNIL: «API (аббревиатура от Application Programming Interface) — это программный интерфейс, который позволяет подключать программное обеспечение или услугу к другому программному обеспечению или службе для того, чтобы
для обмена данными и/или функциями».

API можно рассматривать как контракт между поставщиком информации и пользователем, который определяет содержимое, запрошенное у потребителя (в вызове), и содержимое, запрошенное у поставщика (ответ поставщика потребителю информации).

REST API — это не просто JSON (произносится как d͡ʒeɪsən, а не ʒi.sɔn, спасибо GI и ди-джеям 😉) в ответ на HTTP-запрос.

REST API — это API, который учитывает ограничения стиля архитектуры REST (Representational State Transfer), а именно:

• Архитектура клиент-сервер и http-запросы
• Связь без сохранения состояния, это означает, что информация о клиенте никогда не сохраняется между запросами.
• Единый интерфейс между компонентами, обеспечивающий стандартизированную передачу информации
• Многоуровневая система, невидимая для клиента, для определения приоритетов типов серверов, участвующих в восстановлении данных.

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

Майкрософт

Вызов REST API Power BI

Уже опубликовано множество руководств по вызову REST API Power BI. Подводить итоги :

1. Добавляем коннектор кинув этот файл в каталоге пользовательских коннекторов; соединитель Power BI появится в списке:

2. Тестируем вызов API, например «Получить отчеты», используя сайт Microsoft для получения токена (ему предшествует «Bearer»)

3. Пишем несколько строк M-кода (вызов https://login.microsoftonline.com/xxxxxxxxxx/oauth2/token) для получения этого токена.

Это все очень хорошо, скажете вы, я видел эти уроки, но как вы это сделаете, когда вы выбрали не облако и сервис Power BI, а «на месте» и его сервер отчетов?

Специфика решения сервера отчетов

Сервер отчетов Power BI — это локальный сервер отчетов с веб-порталом, на котором отображаются и управляются отчеты и ключевые показатели эффективности.

Сервер отчетов Power BI похож на онлайн-службу Power BI, но с некоторыми отличиями. Вы не можете делать с сервером отчетов Power BI все, что можно делать со службой Power BI. Процитируем отсутствие в Power BI Report Server составных моделей, дашбордов, вопросов-ответов (snif), потоковой передачи в реальном времени, предупреждений о данных… И этот список, к сожалению, не исчерпывающий.

Но… но тогда?

Хорошие новости, уверяю вас: вы можете вызывать REST API Power BI с помощью сервера отчетов. К счастью, потому что вы здесь для этого, верно?

Microsoft говорит, что URL-адрес запроса должен иметь следующую структуру: {URI-схема}://{URI-хост}/{ресурс-путь}? {Строка запроса}

Итак, вам нужно будет объединить:

• Протокол (http/https)
• URL-адрес хоста (папка отчетов на сервере отчетов)
• Базовый путь: /api/v2.0
• Имя API
• Возможные параметры

Вызов REST API Power BI с сервером отчетов: пример

Возьмем пример API для чтения отчетов. С нашим сервером отчетов необходимо будет подделать следующий URL-адрес: https://powerbi.masociete.com/reports/api/v2.0/PowerBIReports

Поэтому вскоре мы разработаем функцию вызова API:

И тогда будет по-детски вызывать API:

Советы по чтению

Я даю вам эту ссылку на документация Майкрософт. Вы найдете особенно на сайте SwaggerHub отличная помощь при вызове API-интерфейсов Power BI REST, доступных с сервером отчетов.

Независимо от того, есть ли у вас доступ к базе данных Power BI или вы используете REST API (интерфейсы службы или сервера отчетов), возможности монитор Power BI увлекательны, и вся информация, которую вы сможете извлечь, поможет вам улучшить управление вашей средой Power BI.