REST API в Power BI – набор данных, импорт, отчеты, push-наборы данных
1. Цель
В двух предыдущих постах мы рассмотрели большую часть REST API Power BI в части 1 и части 2. Сегодня в этом REST API в Power BI мы собираемся разобрать API импорта Power BI, API наборов данных Power BI Push, Power API отчетов BI и API наборов данных Power BI.
Итак, давайте разберем REST API в Power BI.
REST API в Power BI – набор данных, импорт, отчеты, push-наборы данных
2. REST API в Power BI
Это группы API/операций Power BI REST:
- Операционная группа, описание
- Операции администрирования
- Операции доступных функций
- Операции с ресурсами
- Операции с информационными панелями
- Операции внедрения токенов
- Операции со шлюзами
- Групповые операции
- Операции импортирования
- Операции с push наборами данных
- Операции отчетности
- Операции с наборами данных
3. API наборов данных в Power BI
Это – операции с наборами данных REST API в Power BI:
а. Привязать к шлюзу
Связывает определенный набор данных из «Моего рабочего пространства» определенным порталом. Эти решения поддерживает только локальный шлюз данных.
Требуемое расширение: Dataset.ReadWrite.All
А вы знаете о шлюзе Power Bi Gateway?
b. Привязать к шлюзу
Связывает определенный набор данных из определенной рабочей области с определенным порталом. Поддерживается для локального шлюза данных.
Требуемое расширение: Dataset.ReadWrite.All
c. Удалить набор данных по идентификатору
Удаляет определенный набор данных из «Моей рабочей области».
Требуемое расширение: Dataset.ReadWrite.All
d. Удалить набор данных по идентификатору в группе
Удаляет определенный набор данных из определенной рабочей области.
Требуемое расширение: Dataset.ReadWrite.All
е. Найти шлюзы
Возвращает краткое содержание порталов, к которым может быть привязан определенный набор данных из «Моей рабочей области».
- Этот REST API в Power BI применим только для наборов данных, у которых есть не менее одной локальной связи.
- Для наборов данных получаемых только из облака будет возращено пустое значение.
Требуемое расширение: Dataset.Read.All
f. Найти шлюзы в группе
Возвращает краткое содержание входов, к которым может быть привязан определенный набор данных из определенной рабочей области.
- Этот REST API в Power BI подходит только для наборов данных, у которых есть не менее одной локальной связи.
- Для наборов данных получаемых только из облака будет возращено пустое значение.
Требуемое расширение: Dataset.Read.All
g. Получить набор данных по идентификатору
Возвращает заранее определенный набор данных из «Моей рабочей области».
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
h. Получить набор данных по идентификатору в группе
Возвращает определенный набор данных из определенной рабочей области.
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
i. Получить наборы данных
Возвращает краткое содержание наборов данных из «Моей рабочей области».
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
j. Получить наборы данных в группе
Возвращает краткое содержание наборов данных из заранее определенной рабочей области.
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
k. Получить источники данных
Возвращает краткое содержание источников данных для заранее определенного набора данных из «Моей рабочей области».
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
l. Получить источники данных в группе
Возвращает краткое содержание источников данных для определенного набора данных из определенной рабочей области.
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
Перейдите по этой ссылке, чтобы узнать о портале администратора Power BI.
m. Получить источники данных шлюза
Возвращает краткое содержание источников данных для заранее определенного набора данных из «Моей рабочей области».
Примечание. Используйте новый набор данных – API получения источников данных.
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
n. Получить источники данных шлюза в группе
Возвращает краткое содержание источников данных портала для предварительно определенного набора данных из предварительно определенной рабочей области.
Примечание. Используйте набор данных, чтобы получить источники данных в API группах.
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
о. Получить параметры
Возвращает краткое содержание параметров для определенного набора данных из «Моей рабочей области».
Требуемое расширение: Dataset.ReadWrite.All
p. Получить параметры в группе
Возвращает краткое содержание параметров для определенного набора данных из определенной рабочей области.
Требуемое расширение: Dataset.ReadWrite.All
q. Получить историю обновлений
Возвращает историю восстановления предварительно определенного набора данных из «Моей рабочей области».
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
r. Получить историю обновлений в группе
Возвращает историю восстановления предварительно определенного набора данных из предварительно определенной рабочей области.
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
s. Активизировать набор данных
Запускает обновление для заранее определенного набора данных из «Моего рабочего пространства».
Требуемое расширение: Dataset.ReadWrite.All
t. Активизировать набор данных в группе
Запускает обновление для заранее определенного набора данных из заранее определенного рабочего пространства.
Требуемое расширение: Dataset.ReadWrite.All
u. Установить все подключения наборов данных
Обновляет все связи для определенного набора данных из «Моя рабочая область».
Примечание. Чтобы обновить тонкие элементы группы для SQL, AS, OData Feed и SharePoint, используйте «Обновить источники данных». Для других составов источников данных используйте параметры обновления.
Этот REST API в Power BI просто поддерживает наборы данных SQL DirectQuery.
Требуемая степень: Dataset.ReadWrite.All
v. Добавить все подключения наборов данных в одну группу
Обновляет все связи для определенного набора данных из определенной рабочей области.
Примечание. Чтобы обновить точки подключения для SQL, AS, OData Feed и SharePoint, используйте «Обновить источники данных в группе». Для других составов источников данных используйте параметр «Обновить параметры в группе».
Этот REST API в Power BI просто поддерживает наборы данных SQL DirectQuery.
Требуемая степень: Dataset.ReadWrite.All
w. Принять контроль в группе
Передает ответственность за определенный набор данных утвержденному в настоящее время клиенту.
Требуемая степень: Dataset.ReadWrite.All
x. Обновить источники данных
Обновляет источники данных заранее определенного набора данных из «Моей рабочей области».
Обязательно: первый источник данных и новый источник данных должны быть абсолютно одинаковыми.
Для зарезервированных моделей набор данных необходимо активировать, чтобы получить информацию из новых источников информации. Подождите 30 минут, пока обновление источников данных завершится, прежде чем возобновить работу.
Требуемая степень: Dataset.ReadWrite.All
Ограничения – обновление источников данных поддерживает SQL Server, Azure SQL Server, службы Analysis Services, службы Azure Analysis Services, OData Feed и источники данных SharePoint. Для других составов источников данных используйте параметры обновления
- Изменение состава источника данных не поддерживается.
- Источники данных, содержащие параметры в строке ассоциации, не поддерживаются.
- Источники данных, которые являются частью объединенных таблиц, не поддерживаются.
- Изменение ассоциации с облака на локальную или локальную на облако не поддерживается.
у. Обновить источники данных в группе
Обновляет источники данных определенного набора данных из определенной рабочей области.
Важно: первый источник данных и новый источник данных должны иметь одно и то же.
Для зарезервированных моделей необходимо активировать набор данных, чтобы получить информацию из новых источников данных. Подождите 30 минут, пока обновления источников данных завершится, прежде чем возобновить работу.
Требуемая степень: Dataset.ReadWrite.All
Ограничения – обновление источников данных поддерживает SQL Server, Azure SQL Server, службы Analysis Services, службы Azure Analysis Services, OData Feed и источники данных SharePoint. Для других составов источников данных используйте параметр «Обновить параметры в группе».
- Изменение состава источника данных не поддерживается.
- Источники данных, содержащие параметры в строке ассоциации, не поддерживаются.
- Источники данных, которые являются частью объединенных или объединенных таблиц, не поддерживаются.
- Изменение ассоциации с облака на локальную или локальную на облако не поддерживается.
z. Обновить параметры
Обновляет значение параметров для определенного набора данных из «Моего рабочего пространства».
Обязательно: набор данных должен быть доступен для подключения новых параметров. Подождите 30 минут, чтобы завершить задание параметров обновления, прежде чем активировать.
Требуемое расширение: Dataset.ReadWrite.All
А вы знаете, как создавать собственные показатели в Power BI Desktop?
i. Ограничения
- В наборе данных должны присутствовать все параметры. Имена чувствительны к регистру.
- Наборы данных с ассоциациями SQL, Oracle, Teradata и SapHana Direct Query не поддерживаются.
- Наборы данных с ассоциациями Analysis Services Live не поддерживаются.
- Допускается самый большой из 100 запрашиваемых параметров.
- Свойства должны быть ожидаемого типа.
- Нельзя передать недействительный стимул в параметр IsRequired.
- Rundown не может быть пустым или включать несколько событий одного и того же параметра.
- Параметры типа «Любой» или «Параллельный» не могут быть установлены.
- Параметры могут изменять реальную ассоциацию (сервер или потенциально базу данных), но не ее статус OnPrem (с Cloud на OnPrem или наоборот).
4. API импорта в Power BI.
a. Создать временной области загрузки
Позволяет использовать временный запас BLOB-объектов для импорта записей .pbix размером более 1 ГБ.
Чтобы импортировать документы .pbix размером более 1 ГБ, создайте временную область передачи и перенесите запись, используя URL-адрес подписи взаимного доступа (SAS) из реакции, а затем вызовите Post Import и определите 'fileUrl' как URL-адрес SAS в запросе Тело
Примечание. Импорт огромных документов .pbix доступен для рабочих областей с лимитом Premium.
Требуемое расширение: Dataset.ReadWrite.All
b. Сделать временную область загрузки в группе
Создаёт накопление больших двоичных объектов, используемое для импорта документов .pbix, размером более 1 ГБ.
Чтобы импортировать документы .pbix размером более 1 ГБ, создайте временную область передачи и перенесите запись .pbix, используя URL-адрес общей подписи доступа (SAS) из реакции, а затем вызовите Post Import In Group и определите 'fileUrl' как SAS URL в теле запроса.
Примечание. Импорт огромных записей .pbix доступен для рабочих областей с ограниченным доступом.
Требуемое расширение: Dataset.ReadWrite.All
c. Получить импорт по идентификатору
Возвращает предварительно определенный импорт из «Моего рабочего пространства».
Требуемая степень: Dataset.ReadWrite.All или Dataset.Read.All
d. Получить импорт по идентификатору в группе
Возвращает определенный импорт из определенного рабочего пространства.
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
е. Получить импорт
Возвращает краткое содержание из «Моя рабочая область».
Требуемая степень: Dataset.ReadWrite.All или Dataset.Read.All
Прочтите об источниках данных для преимущества Power BI (службы)
f. Получить импорт в группе
Возвращает краткое содержание из определенной рабочей области.
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
g. Опубликовать импорт
Создает новое содержание «Моя рабочая область» из .pbix, Excel или записывает в OneDrive для бизнеса.
Требуемая степень: Dataset.ReadWrite.All
Примечания. Чтобы импортировать запись, запросите заголовки, которые должны включать информацию Content-Type: multipart/frame с документом, закодированным как информация формы в теле запроса.
- Чтобы импортировать из OneDrive для бизнеса, запросите заголовки, которые должны включать Content-Type: application/json с ImportInfo в теле запроса.
- Чтобы импортировать записи .pbix размером более 1 ГБ, см. раздел «Создание временной области для загрузки», который поддерживается только для рабочих областей с ограничением «премиум».
h. Импорт публикации в группе
Создает новое содержание в заранее определенной рабочей области из .pbix, Excel или записывает путь в OneDrive для бизнеса.
Требуемая степень: Dataset.ReadWrite.All
Примечания. Чтобы импортировать документ, запросите заголовки, которые должны включать информацию Content-Type: multipart/shape с записью, закодированной как информация о кадре в теле запроса.
- Чтобы импортировать из OneDrive для бизнеса, запросите заголовки, которые должны включать Content-Type: application/json с ImportInfo в теле запроса.
- Чтобы импортировать документы .pbix размером более 1 ГБ, см. раздел «Создание временной области для загрузки», который поддерживается только для рабочих областей с ограниченным лимитом.
5. API Push наборов данных Power BI
REST API в Power BI – API наборов данных
а. Наборы данных DeleteRows
Удаляет все столбцы из определенной таблицы внутри определенного набора данных из «Моей рабочей области».
Примечание. Этот REST API в Power BI поддерживает только наборы Push данных.
Требуемое расширение: Dataset.ReadWrite.All
Перейдите по этой ссылке, чтобы узнать о стандартных блоках Power Bs
b. Наборы данных DeleteRowsInGroup
Удаляет все строки из определенной таблицы внутри определенного набора данных из определенной рабочей области.
Примечание. Этот REST API в Power BI находится в основе только наборов данных Push.
Требуемая степень: Dataset.ReadWrite.All
c. Наборы данных GetTables
Возвращает краткое содержание таблиц в заранее определенном наборе данных из «Моя рабочая область».
Примечание. Этот REST API в Power BI поддерживает только наборы данных Push.
Требуемое расширение: Dataset.ReadWrite.All или Dataset.Read.All
d. Наборы данных GetTablesInGroup
Возвращает краткое содержание таблиц в определенном наборе данных из определенной рабочей области.
Примечание. Этот REST API в Power BI лежит в основе только наборов данных Push.
Требуемая степень: Dataset.ReadWrite.All или Dataset.Read.All
е. Наборы данных PostDataset
Создает еще один набор данных в «Моем рабочем пространстве».
Требуемое расширение: Dataset.ReadWrite.All
f. Наборы данных PostDatasetInGroup
Создает другой набор данных в заранее определенной рабочей области.
Требуемое расширение: Dataset.ReadWrite.All
g. Наборы данных PostRows
Добавляет новые информационные столбцы в определенную таблицу внутри определенного набора данных из «Моей рабочей области».
Примечание. Этот REST API в Power BI поддерживает только наборы данных Push.
Требуемое расширение: Dataset.ReadWrite.All
h. Наборы данных PostRowsInGroup
Добавляет новые информационные строки в определенную таблицу внутри определенного набора данных из определенной рабочей области.
Примечание. Этот REST API в Power BI поддерживает только наборы данных Push.
Требуемая степень: Dataset.ReadWrite.All
Вы знаете, что такое динамическая безопасность на уровне строк в Power BI?
i. Наборы данных PutTable
Обновляет метаданные и структуру определенной таблицы внутри определенного набора данных из «Моя рабочая область».
Примечание. Этот REST API в Power BI поддерживает только наборы данных Push.
Требуемое расширение: Dataset.ReadWrite.All
j. Наборы данных PutTableInGroup
Обновляет метаданные и конструкцию для определенной таблицы внутри определенного набора данных из определенной рабочей области.
Примечание. Этот REST API в Power BI поддерживает только наборы данных Push.
Требуемое расширение: Dataset.ReadWrite.All
6. API отчетов Power BI
REST API в Power BI – API отчетов
а. Клонировать отчет
Клонирует предварительно определенный отчет из «Моего рабочего пространства».
Требуемое расширение: Content.Create
b. Клонировать отчет в группе
Клонирует предварительно определенный отчет из предварительно определенного рабочего пространства.
Требуемая степень: Content.Create
c. Удалить отчет
Удаляет заранее определенный отчет из «Моего рабочего пространства».
Требуемое расширение: Report.ReadWrite.All
d. Удалить отчет в группе
Удаляет определенный отчет из определенной рабочей области.
Требуемая степень: Report.ReadWrite.All
е. Отчет о тарифах
Переносит заранее определенный отчет из «Моя рабочая область» в документ .pbix.
Требуемая степень: Report.ReadWrite.All или Report.Read.All
f. Отчет о тарифах в группе
Переносит предварительно определенный отчет из предварительно определенного рабочего пространства в запись .pbix.
Обязательное расширение: Report.ReadWrite.All или Report.Read.All
g. Получить отчет
Возвращает предварительно определенный отчет из «Моей рабочей области».
Требуемое расширение: Report.ReadWrite.All или Report.Read.All
Давайте подробно обсудим сервер отчетов Power BI
h. Получить отчет в группе
Возвращает определенный отчет из определенного рабочего пространства.
Обязательное расширение: Report.ReadWrite.All или Report.Read.All
i. Получить отчеты
Возвращает краткое содержание отчетов из «Моей рабочей области».
Обязательное расширение: Report.ReadWrite.All или Report.Read.All
j. Получить отчеты в группе
Возвращает краткое содержание отчетов из заранее определенной рабочей области.
Требуемая степень: Report.ReadWrite.All или Report.Read.All
k. Повторная привязка отчета
Повторно привязывает заранее определенный отчет из «Моя рабочая область» к запрошенному набору данных.
Требуемая степень: Report.ReadWrite.All
l. Повторная привязка отчета в группе
Повторно привязывает определенный отчет из определенной рабочей области к запрошенному набору данных.
Требуемая степень: Report.ReadWrite.All
м. Обновить содержимое отчета
Обновляет определенный отчет из «Моя рабочая область», чтобы его содержание неотличимо от отчета в теле запроса.
Требуемая степень: Report.ReadWrite.All
n. Обновить содержимое отчета в группе
Обновляет предварительно определенный отчет из предварительно определенного рабочего пространства, чтобы он имел неотличимую сущность от предварительно определенного отчета в теле запроса.
Требуемое расширение: Report.ReadWrite.All
Итак, это все, что мы хотели рассказать о REST API в Power BI. Надеемся, вам понравилось наше объяснение.
7. Заключение
Итак, в этом руководстве по Power BI мы узнали о различных операциях REST API в Power BI: API импорта Power BI, API Push наборов данных Power BI, API отчетов Power BI и API наборов данных Power BI.