Udostępnij za pośrednictwem

Datasets - Update Direct Query Refresh Schedule

  • Odwołanie
Service:
Power BI REST APIs
API Version:
v1.0

Aktualizacje harmonogram odświeżania dla określonego zestawu danych Trybu DirectQuery lub LiveConnection z obszaru Mój obszar roboczy.

Żądanie powinno zawierać zestaw dni i godziny lub prawidłową częstotliwość, ale nie obie te wartości. 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.

Uprawnienia

Użytkownik musi być właścicielem zestawu danych.

Zakres wymagany

Dataset.ReadWrite.All

PATCH https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/directQueryRefreshSchedule

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
datasetId
 path True

string

Identyfikator zestawu danych

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

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
Request Body
{
  "value": {
    "enabled": false
  }
}

Sample Response

Status code:
200

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
Request Body
{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

Sample Response

Status code:
200

Set a frequency based schedule example

Sample Request

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
Request Body
{
  "value": {
    "frequency": 30
  }
}

Sample Response

Status code:
200

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
Request Body
{
  "value": {
    "times": [
      "07:00",
      "16:30",
      "23:30"
    ]
  }
}

Sample Response

Status code:
200

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

Nazwa Typ Opis
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

DirectQueryRefreshSchedule

Harmonogram odświeżania usługi Power BI dla trybu DirectQuery lub LiveConnection, określając 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