Sdílet prostřednictvím

Datasets - Update Direct Query Refresh Schedule

  • Reference
Service:
Power BI REST APIs
API Version:
v1.0

Aktualizace plán aktualizace pro zadanou datovou sadu DirectQuery nebo LiveConnection z části Pracovní prostor.

Požadavek by měl obsahovat buď sadu dnů a časů , nebo platnou frekvenci, ale ne obojí. Pokud zvolíte sadu dnů bez zadání času, power BI použije výchozí jeden čas za den. Nastavení frekvence automaticky přepíše nastavení dnů a časů.

Oprávnění

Uživatel musí být vlastníkem datové sady.

Požadovaný obor

Dataset.ReadWrite.All

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
datasetId
 path True

string

ID datové sady

Text požadavku

Name Vyžadováno Typ Description
value True

DirectQueryRefreshSchedule

Objekt obsahující podrobnosti plánu aktualizace pro DirectQuery nebo LiveConnection

Odpovědi

Name Typ Description
200 OK

OK

Příklady

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

Definice

Name Description
days

Dny, ve kterých se má aktualizace spustit
DirectQueryRefreshSchedule

Plán aktualizace Power BI pro DirectQuery nebo LiveConnection, který určuje frekvenci nebo kombinaci dnů a časů.
DirectQueryRefreshScheduleRequest

Žádost o plán aktualizace Power BI pro DirectQuery nebo LiveConnection

days

Dny, ve kterých se má aktualizace spustit

Name Typ Description
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

DirectQueryRefreshSchedule

Plán aktualizace Power BI pro DirectQuery nebo LiveConnection, který určuje frekvenci nebo kombinaci dnů a časů.

Name Typ Description
days

days[]

Dny, ve kterých se má aktualizace spustit
frequency

integer

Interval v minutách mezi po sobě jdoucími aktualizacemi. Podporované hodnoty jsou 15, 30, 60, 120 a 180.
localTimeZoneId

string

ID časového pásma, které se má použít. Další informace najdete v tématu Informace o časovém pásmu.
times

string[]

Denní doby provádění aktualizace

DirectQueryRefreshScheduleRequest

Žádost o plán aktualizace Power BI pro DirectQuery nebo LiveConnection

Name Typ Description
value

DirectQueryRefreshSchedule

Objekt obsahující podrobnosti plánu aktualizace pro DirectQuery nebo LiveConnection