Datasets - Update Direct Query Refresh Schedule In Group
Aktualizuje harmonogram odświeżania dla określonego zestawu danych Trybu DirectQuery lub LiveConnection z określonego obszaru roboczego.
Żądanie powinno zawierać zestaw dni i godziny lub prawidłową częstotliwość, ale nie obie. Jeśli wybierzesz zestaw dni bez określenia jakichkolwiek godzin, usługa Power BI będzie używać domyślnego pojedynczego czasu dziennie. Ustawienie częstotliwości spowoduje automatyczne zastąpienie ustawień dni i godzin.
Permissions
- Użytkownik musi być właścicielem zestawu danych.
- To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w usłudze Power BI Embedded.
Wymagany zakres
Dataset.ReadWrite.All
PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}/directQueryRefreshSchedule
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
dataset
|
path | True |
string |
Identyfikator zestawu danych |
|
group
|
path | True |
string (uuid) |
Identyfikator obszaru roboczego |
Treść żądania
| Nazwa | Wymagane | Typ | Opis |
|---|---|---|---|
| value | True |
Obiekt zawierający szczegóły harmonogramu odświeżania dla trybu DirectQuery lub LiveConnection |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
OK |
Przykłady
| 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
Przykładowe żądanie
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"
}
}
Przykładowa odpowiedź
Set a frequency based schedule example
Przykładowe żądanie
PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
{
"value": {
"frequency": 30
}
}
Przykładowa odpowiedź
Update the times of an existing days and times based schedule example
Przykładowe żądanie
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"
]
}
}
Przykładowa odpowiedź
Definicje
| Nazwa | Opis |
|---|---|
| days |
Dni, w których należy wykonać odświeżanie |
|
Direct |
Harmonogram odświeżania usługi Power BI dla trybu DirectQuery lub LiveConnection określający częstotliwość lub kombinację dni i godzin. |
|
Direct |
Żądanie harmonogramu odświeżania usługi Power BI dla trybu DirectQuery lub LiveConnection |
days
Dni, w których należy wykonać odświeżanie
| Wartość | Opis |
|---|---|
| Monday | |
| Tuesday | |
| Wednesday | |
| Thursday | |
| Friday | |
| Saturday | |
| Sunday |
DirectQueryRefreshSchedule
Harmonogram odświeżania usługi Power BI dla trybu DirectQuery lub LiveConnection określający częstotliwość lub kombinację dni i godzin.
| Nazwa | Typ | Opis |
|---|---|---|
| days |
days[] |
Dni, w których należy wykonać odświeżanie |
| frequency |
integer |
Interwał w minutach między kolejnymi odświeżeniami. Obsługiwane wartości to 15, 30, 60, 120 i 180. |
| localTimeZoneId |
string |
Identyfikator strefy czasowej do użycia. Aby uzyskać więcej informacji, zobacz Informacje o strefie czasowej |
| times |
string[] |
Czasy dnia do wykonania odświeżania |
DirectQueryRefreshScheduleRequest
Żądanie harmonogramu odświeżania usługi Power BI dla trybu DirectQuery lub LiveConnection
| Nazwa | Typ | Opis |
|---|---|---|
| value |
Obiekt zawierający szczegóły harmonogramu odświeżania dla trybu DirectQuery lub LiveConnection |