Datasets - Update Direct Query Refresh Schedule In Group
Updates den Aktualisierungszeitplan für ein angegebenes DirectQuery- oder LiveConnection-Dataset aus dem angegebenen Arbeitsbereich.
Eine Anforderung sollte entweder eine Reihe von Tagen und Zeiten oder eine gültige Häufigkeit enthalten, aber nicht beides. Wenn Sie eine Reihe von Tagen ohne Angabe von Zeiten auswählen, verwendet Power BI standardmäßig eine einzelne Uhrzeit pro Tag. Wenn Sie die Häufigkeit festlegen, werden die Tage und Zeiten automatisch überschrieben.
Berechtigungen
- Der Benutzer muss der Datasetbesitzer sein.
- Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter Dienstprinzipalprofile in Power BI Embedded.
Erforderlicher Bereich
Dataset.ReadWrite.All
PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/directQueryRefreshSchedule
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
Die Dataset-ID |
|
group
|
path | True |
string uuid |
Arbeitsbereich-ID |
Anforderungstext
| Name | Erforderlich | Typ | Beschreibung |
|---|---|---|---|
| value | True |
Ein Objekt, das die Aktualisierungszeitplandetails für DirectQuery oder LiveConnection enthält |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
OK |
Beispiele
| Set a days and times based schedule example |
| Set a frequency based schedule example |
| Update the times of an existing days and times based schedule example |
Set a days and times based schedule example
Beispielanforderung
PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
{
"value": {
"frequency": 30
}
}
Beispiel für eine Antwort
Update the times of an existing days and times based schedule example
Beispielanforderung
PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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 Zeiten angibt. |
|
Direct |
Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection |
days
Die Tage, an denen die Aktualisierung ausgeführt werden soll
| Wert | Beschreibung |
|---|---|
| Friday | |
| Monday | |
| Saturday | |
| Sunday | |
| Thursday | |
| Tuesday | |
| Wednesday |
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 zum Ausführen der Aktualisierung |
DirectQueryRefreshScheduleRequest
Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection
| Name | Typ | Beschreibung |
|---|---|---|
| value |
Ein Objekt, das die Aktualisierungszeitplandetails für DirectQuery oder LiveConnection enthält |