Datasets - Update Direct Query Refresh Schedule
Aktualisiert den Aktualisierungszeitplan für ein angegebenes DirectQuery - oder LiveConnection-Dataset aus meinem Arbeitsbereich.
Eine Anforderung sollte entweder eine Reihe von Tagen und Uhrzeiten oder eine gültige Häufigkeit enthalten, aber nicht beide. Wenn Sie eine Gruppe von Tagen ohne Angabe von Uhrzeiten auswählen, verwendet Power BI eine Standardzeit pro Tag. Wenn Sie die Häufigkeit festlegen, werden die Einstellung für Tage und Uhrzeiten automatisch überschrieben.
Erlaubnisse
Der Benutzer muss der Datasetbesitzer sein.
Erforderlicher Bereich
Dataset.ReadWrite.All
PATCH https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/directQueryRefreshSchedule
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
Die Dataset-ID |
Anforderungstext
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| value | True |
Ein Objekt mit den Aktualisierungszeitplandetails für DirectQuery oder LiveConnection |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
OKAY |
Beispiele
| 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
Beispielanforderung
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
{
"value": {
"enabled": false
}
}
Beispiel für eine Antwort
Set a days and times based schedule example
Beispielanforderung
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"
}
}
Beispiel für eine Antwort
Set a frequency based schedule example
Beispielanforderung
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
{
"value": {
"frequency": 30
}
}
Beispiel für eine Antwort
Update the times of a days and times based schedule example
Beispielanforderung
PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
{
"value": {
"times": [
"07:00",
"16:30",
"23:30"
]
}
}
Beispiel für eine Antwort
Definitionen
| Name | Beschreibung |
|---|---|
| days |
Die Tage, an denen die Aktualisierung ausgeführt werden soll |
|
Direct |
Ein Power BI-Aktualisierungszeitplan für DirectQuery oder LiveConnection, der entweder die Häufigkeit oder eine Kombination aus Tagen und Uhrzeiten angibt. |
|
Direct |
Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection |
days
Die Tage, an denen die Aktualisierung ausgeführt werden soll
| Wert | Beschreibung |
|---|---|
| Monday | |
| Tuesday | |
| Wednesday | |
| Thursday | |
| Friday | |
| Saturday | |
| Sunday |
DirectQueryRefreshSchedule
Ein Power BI-Aktualisierungszeitplan für DirectQuery oder LiveConnection, der entweder die Häufigkeit oder eine Kombination aus Tagen und Uhrzeiten angibt.
| Name | Typ | Beschreibung |
|---|---|---|
| days |
days[] |
Die Tage, an denen die Aktualisierung ausgeführt werden soll |
| frequency |
integer |
Das Intervall in Minuten zwischen aufeinander folgenden Aktualisierungen. Unterstützte Werte sind 15, 30, 60, 120 und 180. |
| localTimeZoneId |
string |
Die ID der zu verwendenden Zeitzone. Weitere Informationen finden Sie unter Zeitzoneninformationen |
| times |
string[] |
Die Tageszeiten, um die Aktualisierung auszuführen |
DirectQueryRefreshScheduleRequest
Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection
| Name | Typ | Beschreibung |
|---|---|---|
| value |
Ein Objekt mit den Aktualisierungszeitplandetails für DirectQuery oder LiveConnection |