Datasets - Update Direct Query Refresh Schedule
Updates den Aktualisierungszeitplan für ein angegebenes DirectQuery- oder LiveConnection-Dataset aus Meinem Arbeitsbereich aus.
Eine Anforderung sollte entweder eine Reihe von Tagen und Uhrzeiten oder eine gültige Häufigkeit enthalten, aber nicht beides. Wenn Sie eine Reihe von Tagen ohne Angabe von Uhrzeiten auswählen, verwendet Power BI standardmäßig eine einzelne Uhrzeit pro Tag. Wenn Sie die Häufigkeit festlegen, werden die Einstellungen für Tage und Uhrzeiten automatisch überschrieben.
Berechtigungen
Der Benutzer muss der Besitzer des Datasets 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 Details zum Aktualisierungszeitplan für DirectQuery oder LiveConnection |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK |
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
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
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 Zeiten angibt. |
Direct |
Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection |
days
Die Tage, an denen die Aktualisierung ausgeführt werden soll
Name | Typ | Beschreibung |
---|---|---|
Friday |
string |
|
Monday |
string |
|
Saturday |
string |
|
Sunday |
string |
|
Thursday |
string |
|
Tuesday |
string |
|
Wednesday |
string |
DirectQueryRefreshSchedule
Ein Power BI-Aktualisierungszeitplan für DirectQuery oder LiveConnection, der entweder die Häufigkeit oder eine Kombination aus Tagen und Zeiten 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, zu denen die Aktualisierung ausgeführt werden soll |
DirectQueryRefreshScheduleRequest
Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection
Name | Typ | Beschreibung |
---|---|---|
value |
Ein Objekt mit den Details zum Aktualisierungszeitplan für DirectQuery oder LiveConnection |