Datasets - Refresh Dataset

Ссылка

Service:: Power BI REST APIs

API Version:: v1.0

Активирует обновление для указанного набора данных из моей рабочей области. Расширенное обновление активируется только в том случае, если заданы полезные данные запроса, отличные от notifyOption .

Требуемая область

Dataset.ReadWrite.All

Ограничения

Для общих емкостей можно инициировать не более восьми запросов в день, включая обновления, выполняемые с помощью запланированного обновления.
Для общих емкостей можно указать только notifyOption в тексте запроса.
Расширенное обновление не поддерживается для общих емкостей.
Для расширенного обновления notifyOption не требуется и должен быть исключен из текста запроса. Однако требуется один или несколько параметров, отличных от notifyOption .
Для емкостей Premium максимальное количество запросов в день ограничивается только доступными ресурсами в емкости. Если доступные ресурсы перегружены, обновления регулируются до снижения нагрузки. Обновление завершится ошибкой, если регулирование превышает 1 час.

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes

Параметры URI

Имя	В	Обязательно	Тип	Описание
datasetId	path	True	string	Идентификатор набора данных

Текст запроса

Имя	Обязательно	Тип	Описание
notifyOption	True	NotifyOption	Параметры уведомлений по почте. Этот параметр неприменим для расширенных обновлений или операций API с субъектом-службой.
applyRefreshPolicy		boolean	Определение того, применяется ли политика
commitMode		DatasetCommitMode	Определяет, будут ли объекты зафиксированы пакетами или только по завершении.
effectiveDate		string	Если применяется политика добавочного обновления, `effectiveDate` параметр переопределяет текущую дату.
maxParallelism		integer	Максимальное число потоков, в которых выполняются команды параллельной обработки.
objects		DatasetRefreshObjects[]	Массив обрабатываемых объектов
retryCount		integer	Количество повторных попыток выполнения операции перед сбоем
type		DatasetRefreshType	Тип выполняемой обработки

Ответы

Имя	Тип	Описание
202 Accepted		Принято Headers x-ms-request-id: string Location: string

Имя

Тип

Описание

202 Accepted

Принято

Headers

x-ms-request-id: string
Location: string

Примеры

Example of refreshing a dataset

Example of refreshing one partition

Example of refreshing a dataset

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes

Sample Response

Status code:: 202

x-ms-request-id: 03f22bb5-2e98-4ae8-8113-329bec3987b1
Location: https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes/03f22bb5-2e98-4ae8-8113-329bec3987b1

Example of refreshing one partition

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes

Request Body

{
  "type": "full",
  "commitMode": "transactional",
  "objects": [
    {
      "table": "Customer",
      "partition": "Robert"
    }
  ],
  "applyRefreshPolicy": "false"
}

Sample Response

Status code:: 200

Определения

Имя	Описание
DatasetCommitMode	Определяет, будут ли объекты зафиксированы пакетами или только по завершении.
DatasetRefreshObjects	Целевой объект обновления набора данных Power BI
DatasetRefreshRequest	Запрос на обновление набора данных Power BI
DatasetRefreshType	Тип выполняемой обработки
NotifyOption	Параметры уведомлений по почте

DatasetCommitMode

Определяет, будут ли объекты зафиксированы пакетами или только по завершении.

Имя	Тип	Описание
PartialBatch	string	Зафиксируйте операцию обновления в пакетах. При использовании `partialBatch` режима операция обновления не выполняется в транзакции. Следовательно, каждая команда будет зафиксирована по отдельности, и в случае сбоя модель может оказаться в состоянии, когда загружается только подмножество данных или таблица остается пустой. Если вы хотите гарантировать сохранение предыдущих данных в случае сбоя, следует выполнить операцию с `commitMode = transactional.`
Transactional	string	Фиксация всей операции обновления в виде транзакции

DatasetRefreshObjects

Целевой объект обновления набора данных Power BI

Имя	Тип	Описание
partition	string	Обновляемая секция
table	string	Обновляемая таблица

DatasetRefreshRequest

Запрос на обновление набора данных Power BI

Имя	Тип	Описание
applyRefreshPolicy	boolean	Определение того, применяется ли политика
commitMode	DatasetCommitMode	Определяет, будут ли объекты зафиксированы пакетами или только по завершении.
effectiveDate	string	Если применяется политика добавочного обновления, `effectiveDate` параметр переопределяет текущую дату.
maxParallelism	integer	Максимальное число потоков, в которых выполняются команды параллельной обработки.
notifyOption	NotifyOption	Параметры уведомлений по почте. Этот параметр неприменим для расширенных обновлений или операций API с субъектом-службой.
objects	DatasetRefreshObjects[]	Массив обрабатываемых объектов
retryCount	integer	Количество повторных попыток выполнения операции перед сбоем
type	DatasetRefreshType	Тип выполняемой обработки

DatasetRefreshType

Тип выполняемой обработки

Имя	Тип	Описание
Automatic	string	Если объект необходимо обновить и пересчитать, обновить и пересчитать объект и все его зависимости. Применяется, если секция находится в состоянии, отличном от "Готово".
Calculate	string	Пересчитать этот объект и все зависимые ресурсы только при необходимости. Это значение не приводит к принудительному пересчету, за исключением изменяемых формул.
ClearValues	string	Очистка значений в этом объекте и всех его зависимых объектах
DataOnly	string	Обновление данных в этом объекте и очистка всех зависимых элементов
Defragment	string	Дефрагментировать данные в указанной таблице. По мере добавления или удаления данных из таблицы словари для каждого столбца могут заполниться значениями, которых на самом деле больше не существует в столбцах. Параметр дефрагментации приведет к очистке более не используемых значений в словарях.
Full	string	Обновить данные и пересчитать все зависимые объекты для всех секций в указанной секции, таблице или базе данных. Для вычисления секции пересчитать раздел и все его зависимости.

NotifyOption

Параметры уведомлений по почте

Имя	Тип	Описание
MailOnCompletion	string	При завершении обновления будет отправлено почтовое уведомление об успешном или неудачном выполнении.
MailOnFailure	string	При сбое обновления будет отправлено почтовое уведомление
NoNotification	string	Уведомления не отправляются

Datasets - Refresh Dataset

Требуемая область

Ограничения

Параметры URI

Текст запроса

Ответы

Примеры

Example of refreshing a dataset

Sample Request

Sample Response

Example of refreshing one partition

Sample Request

Sample Response

Определения

DatasetCommitMode

DatasetRefreshObjects

DatasetRefreshRequest

DatasetRefreshType

NotifyOption

Дополнительные ресурсы