Datasets - Refresh Dataset
Активирует обновление для указанного набора данных из моей рабочей области. Расширенное обновление активируется только в том случае, если заданы полезные данные запроса, отличные от notifyOption
.
Требуемая область
Dataset.ReadWrite.All
Ограничения
- Для общих емкостей можно инициировать не более восьми запросов в день, включая обновления, выполняемые с помощью запланированного обновления.
- Для общих емкостей можно указать только
notifyOption
в тексте запроса. - Расширенное обновление не поддерживается для общих емкостей.
- Для расширенного обновления
notifyOption
не требуется и должен быть исключен из текста запроса. Однако требуется один или несколько параметров, отличных отnotifyOption
. - Для емкостей Premium максимальное количество запросов в день ограничивается только доступными ресурсами в емкости. Если доступные ресурсы перегружены, обновления регулируются до снижения нагрузки. Обновление завершится ошибкой, если регулирование превышает 1 час.
POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
dataset
|
path | True |
string |
Идентификатор набора данных |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
notifyOption | True |
Параметры уведомлений по почте. Этот параметр неприменим для расширенных обновлений или операций API с субъектом-службой. |
|
applyRefreshPolicy |
boolean |
Определение того, применяется ли политика |
|
commitMode |
Определяет, будут ли объекты зафиксированы пакетами или только по завершении. |
||
effectiveDate |
string |
Если применяется политика добавочного обновления, |
|
maxParallelism |
integer |
Максимальное число потоков, в которых выполняются команды параллельной обработки. |
|
objects |
Массив обрабатываемых объектов |
||
retryCount |
integer |
Количество повторных попыток выполнения операции перед сбоем |
|
type |
Тип выполняемой обработки |
Ответы
Имя | Тип | Описание |
---|---|---|
202 Accepted |
Принято Headers
|
Примеры
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
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
{
"type": "full",
"commitMode": "transactional",
"objects": [
{
"table": "Customer",
"partition": "Robert"
}
],
"applyRefreshPolicy": "false"
}
Sample Response
Определения
Имя | Описание |
---|---|
Dataset |
Определяет, будут ли объекты зафиксированы пакетами или только по завершении. |
Dataset |
Целевой объект обновления набора данных Power BI |
Dataset |
Запрос на обновление набора данных Power BI |
Dataset |
Тип выполняемой обработки |
Notify |
Параметры уведомлений по почте |
DatasetCommitMode
Определяет, будут ли объекты зафиксированы пакетами или только по завершении.
Имя | Тип | Описание |
---|---|---|
PartialBatch |
string |
Зафиксируйте операцию обновления в пакетах. При использовании |
Transactional |
string |
Фиксация всей операции обновления в виде транзакции |
DatasetRefreshObjects
Целевой объект обновления набора данных Power BI
Имя | Тип | Описание |
---|---|---|
partition |
string |
Обновляемая секция |
table |
string |
Обновляемая таблица |
DatasetRefreshRequest
Запрос на обновление набора данных Power BI
Имя | Тип | Описание |
---|---|---|
applyRefreshPolicy |
boolean |
Определение того, применяется ли политика |
commitMode |
Определяет, будут ли объекты зафиксированы пакетами или только по завершении. |
|
effectiveDate |
string |
Если применяется политика добавочного обновления, |
maxParallelism |
integer |
Максимальное число потоков, в которых выполняются команды параллельной обработки. |
notifyOption |
Параметры уведомлений по почте. Этот параметр неприменим для расширенных обновлений или операций API с субъектом-службой. |
|
objects |
Массив обрабатываемых объектов |
|
retryCount |
integer |
Количество повторных попыток выполнения операции перед сбоем |
type |
Тип выполняемой обработки |
DatasetRefreshType
Тип выполняемой обработки
Имя | Тип | Описание |
---|---|---|
Automatic |
string |
Если объект необходимо обновить и пересчитать, обновить и пересчитать объект и все его зависимости. Применяется, если секция находится в состоянии, отличном от "Готово". |
Calculate |
string |
Пересчитать этот объект и все зависимые ресурсы только при необходимости. Это значение не приводит к принудительному пересчету, за исключением изменяемых формул. |
ClearValues |
string |
Очистка значений в этом объекте и всех его зависимых объектах |
DataOnly |
string |
Обновление данных в этом объекте и очистка всех зависимых элементов |
Defragment |
string |
Дефрагментировать данные в указанной таблице. По мере добавления или удаления данных из таблицы словари для каждого столбца могут заполниться значениями, которых на самом деле больше не существует в столбцах. Параметр дефрагментации приведет к очистке более не используемых значений в словарях. |
Full |
string |
Обновить данные и пересчитать все зависимые объекты для всех секций в указанной секции, таблице или базе данных. Для вычисления секции пересчитать раздел и все его зависимости. |
NotifyOption
Параметры уведомлений по почте
Имя | Тип | Описание |
---|---|---|
MailOnCompletion |
string |
При завершении обновления будет отправлено почтовое уведомление об успешном или неудачном выполнении. |
MailOnFailure |
string |
При сбое обновления будет отправлено почтовое уведомление |
NoNotification |
string |
Уведомления не отправляются |