Начало работы с коллекциями рабочих областей Microsoft Power BI

  • Статья

Коллекции рабочих областей Power BI — это служба Azure, которая позволяет разработчикам приложений добавлять интерактивные отчеты Power BI в собственные приложения. Служба Коллекции рабочих областей Power BI работала с существующими приложениями, вам не нужно изменять способ, с помощью которого пользователи выполняют вход.

Важно!

Использовать службу "Коллекции рабочих областей Power BI" не рекомендуется. Она будет доступна до июня 2018 года или до даты, указанной в договоре. Мы советуем организовать перенос приложения в Power BI Embedded, чтобы избежать прерываний в его работе. Сведения о том, как перенести данные из коллекций рабочих областей Power BI в Power BI Embedded, см. в этой статье.

Ресурсы для службы Коллекции рабочих областей Power BI подготавливаются с помощью интерфейсов API Azure Resource Manager. В нашем примере подготавливаемый ресурс — это коллекция рабочих областей Power BI.

Общий поток работы с коллекциями рабочих областей Power BI

Создание коллекции рабочей области

Коллекция рабочей области — это ресурс и контейнер Azure верхнего уровня для содержимого, которое будет внедрено в приложение. Коллекция рабочей области может быть создана двумя способами:

  • вручную с помощью портала Azure;
  • программно с помощью интерфейсов API Azure Resource Manager.

Давайте рассмотрим шаги по созданию коллекции рабочих областей с помощью портал Azure.

  1. Откройте и войдите в портал Azure: https://portal.azure.com.

  2. На панели вверху выберите +Создать.

    Пункт

  3. В разделе Данные+аналитика выберите Коллекция рабочих областей Power BI.

  4. В начальном сообщении при наличии имеющейся подписки на коллекцию рабочих областей Power BI в нижней части выберите Create a workspace collection (Создать коллекцию рабочих областей).

  5. В колонке Коллекция рабочих областей Power BI введите необходимые сведения.

    Создание коллекции рабочих областей

  6. Нажмите кнопку создания.

Подготовка коллекции рабочих областей занимает несколько секунд. После этого откроется колонка коллекции рабочих областей.

Коллекция рабочих областей на портале Azure

Колонка создания содержит сведения, необходимые для вызова API-интерфейсов, которые создают рабочие области и развертывают в них содержимое.

Просмотр ключей доступа для вызова API Power BI

Сведения, необходимые для вызова REST API Power BI, включают в себя такой важный элемент, как ключи доступа. Эти ключи используются для создания маркеров приложения для проверки подлинности запросов к API. Чтобы просмотреть ключи доступа, в колонке Параметры щелкните Ключи доступа. Дополнительные сведения о маркерах приложений см. в статье Authenticating and authorizing with Power BI Workspace Collections (Аутентификация и авторизация в коллекциях рабочих областей Power BI).

Ключи доступа в параметрах коллекции рабочих областей на портале Azure

Обратите внимание: у вас есть два ключа.

Два ключа в колонке

Скопируйте эти ключи и надежно сохраните их в приложении. Важно обращаться с этими ключами как с паролем, так как они предоставляют доступ ко всему содержимому в коллекции рабочих областей.

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

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

Работа с рабочими областями

После создания коллекции рабочих областей необходимо создать рабочую область для размещения отчетов и наборов данных. Чтобы создать рабочую область, необходимо использовать Post Worksapce REST API.

Создание наборов данных и отчетов Power BI для внедрения в приложение с помощью Power BI Desktop

Теперь, когда вы создали экземпляр Power BI для приложения и получили ключи доступа, можно приступать к созданию наборов данных и отчетов Power BI для внедрения. Наборы данных и отчеты можно создавать с помощью Power BI Desktop. Power BI Desktop можно скачать бесплатно. Или же, чтобы быстро приступить к работе, можно скачать PBIX-файл с примером анализа данных о продажах.

Примечание

Дополнительные сведения об использовании Power BI Desktop см. в статье Начало работы с Power BI Desktop.

С помощью Power BI Desktop вы можете подключиться к источнику данных. Для этого импортируйте копию данных в Power BI Desktop или подключитесь непосредственно к источнику данных с помощью DirectQuery.

Ниже описаны различия между импортом и DirectQuery.

Используя режим Import DirectQuery
Таблицы, столбцы и данные импортируются или копируются в Power BI Desktop. При работе с представлениями Power BI Desktop запрашивает копию данных. Чтобы определить изменения в базовых данных, вам нужно повторно обновить или импортировать готовый текущий набор данных. В Power BI Desktop импортируются или копируются только таблицы и столбцы. При работе с представлениями Power BI Desktop запрашивает базовый источник данных (это значит, что вы всегда просматриваете актуальные данные).

Дополнительные сведения о подключении к источнику данных см. в этой статье.

Когда вы сохраните документ в Power BI Desktop, будет создан PBIX-файл. Этот файл содержит ваш отчет. Кроме того, при импорте данных PBIX-файл будет содержать полный набор данных, а при использовании DirectQuery— только схему набора данных. В рабочей области PBIX-файл развертывается программным способом с помощью API импорта Power BI.

Примечание

Коллекции рабочих областей Power BI предусматривают дополнительные API. С их помощью можно изменять сервер и базу данных, на которые указывает ваш набор данных, а также указывать данные учетной записи службы для подключения к базе данных. Дополнительные сведения см. в статьях Post SetAllConnections (Публикация SetAllConnections) и Patch Gateway Datasource (Исправление источника данных шлюза).

Создание наборов данных и отчетов Power BI с помощью API

Наборы данных

Вы можете создавать наборы данных в коллекциях рабочих областей Power BI с помощью REST API. Затем данные можно передать в свой набор данных. Это позволит работать с данными без использования Power BI Desktop. Дополнительные сведения см. в статье о публикации наборов данных.

Отчеты

С помощью API JavaScript можно создать отчет на основе набора данных прямо в приложении. Дополнительные сведения см. в статье Create a new report from a dataset in Power BI Workspace Collections (Создание отчета из набора данных в коллекциях рабочих областей Power BI).

См. также:

Приступая к работе с примером Microsoft Power BI Embedded
Аутентификация и авторизация в коллекциях рабочих областей Power BI
Внедрение отчета в Power BI Embedded
Create a new report from a dataset in Power BI Workspace Collections (Создание отчета из набора данных в коллекциях рабочих областей Power BI)Сохранение отчетов
Power BI Desktop
Пример внедрения JavaScript

Остались вопросы? Ответы на них см. в сообществе Power BI.