Udostępnij przez


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

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
datasetId
path True

string

Identyfikator zestawu danych

groupId
path True

string (uuid)

Identyfikator obszaru roboczego

Treść żądania

Nazwa Wymagane Typ Opis
value True

DirectQueryRefreshSchedule

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

DirectQueryRefreshSchedule

Harmonogram odświeżania usługi Power BI dla trybu DirectQuery lub LiveConnection określający częstotliwość lub kombinację dni i godzin.

DirectQueryRefreshScheduleRequest

Żą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

DirectQueryRefreshSchedule

Obiekt zawierający szczegóły harmonogramu odświeżania dla trybu DirectQuery lub LiveConnection