Datasets - Update Direct Query Refresh Schedule
Обновления расписание обновления для указанного набора данных DirectQuery или LiveConnection из раздела "Моя рабочая область".
Запрос должен содержать набор дней и времени или допустимую частоту, но не оба типа. Если выбрать набор дней без указания времени, Power BI будет использовать по умолчанию один раз в день. При установке частоты параметры дней и времени будут автоматически перезаписаны.
Разрешения
Пользователь должен быть владельцем набора данных.
Требуемая область
Dataset.ReadWrite.All
PATCH https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/directQueryRefreshSchedule
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
dataset
|
path | True |
string |
Идентификатор набора данных |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
value | True |
Объект , содержащий сведения о расписании обновления для DirectQuery или LiveConnection. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ОК |
Примеры
Disable a scheduled refresh example |
Set a days and times based schedule example |
Set a frequency based schedule example |
Update the times of a days and times based schedule example |
Disable a scheduled refresh example
Sample Request
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
{
"value": {
"enabled": false
}
}
Sample Response
Set a days and times based schedule example
Sample Request
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
{
"value": {
"days": [
"Sunday",
"Tuesday",
"Friday",
"Saturday"
],
"times": [
"07:00",
"11:30",
"16:00",
"23:30"
],
"localTimeZoneId": "UTC"
}
}
Sample Response
Set a frequency based schedule example
Sample Request
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
{
"value": {
"frequency": 30
}
}
Sample Response
Update the times of a days and times based schedule example
Sample Request
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
{
"value": {
"times": [
"07:00",
"16:30",
"23:30"
]
}
}
Sample Response
Определения
Имя | Описание |
---|---|
days |
Дни, в которые выполняется обновление |
Direct |
Расписание обновления Power BI для DirectQuery или LiveConnection, указывающее частоту или сочетание дней и времени. |
Direct |
Запрос расписания обновления Power BI для DirectQuery или LiveConnection |
days
Дни, в которые выполняется обновление
Имя | Тип | Описание |
---|---|---|
Friday |
string |
|
Monday |
string |
|
Saturday |
string |
|
Sunday |
string |
|
Thursday |
string |
|
Tuesday |
string |
|
Wednesday |
string |
DirectQueryRefreshSchedule
Расписание обновления Power BI для DirectQuery или LiveConnection, указывающее частоту или сочетание дней и времени.
Имя | Тип | Описание |
---|---|---|
days |
days[] |
Дни, в которые выполняется обновление |
frequency |
integer |
Интервал в минутах между последовательными обновлениями. Поддерживаемые значения: 15, 30, 60, 120 и 180. |
localTimeZoneId |
string |
Идентификатор используемого часового пояса. Дополнительные сведения см. в разделе Сведения о часовом поясе. |
times |
string[] |
Время суток для выполнения обновления |
DirectQueryRefreshScheduleRequest
Запрос расписания обновления Power BI для DirectQuery или LiveConnection
Имя | Тип | Описание |
---|---|---|
value |
Объект , содержащий сведения о расписании обновления для DirectQuery или LiveConnection. |