Datasets - Update Direct Query Refresh Schedule

Služba:

Power BI REST APIs

Verze rozhraní API:

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

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Text požadavku

{
  "value": {
    "enabled": false
  }
}

Ukázková odpověď

Stavový kód:

200

Set a days and times based schedule example

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Text požadavku

{
  "value": {
    "days": [
      "Sunday",
      "Tuesday",
      "Friday",
      "Saturday"
    ],
    "times": [
      "07:00",
      "11:30",
      "16:00",
      "23:30"
    ],
    "localTimeZoneId": "UTC"
  }
}

Ukázková odpověď

Stavový kód:

200

Set a frequency based schedule example

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Text požadavku

{
  "value": {
    "frequency": 30
  }
}

Ukázková odpověď

Stavový kód:

200

Update the times of a days and times based schedule example

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Text požadavku

{
  "value": {
    "times": [
      "07:00",
      "16:30",
      "23:30"
    ]
  }
}

Ukázková odpověď

Stavový kód:

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

Enumeration

Dny, ve kterých se má aktualizace spustit

Hodnota	Description
Friday
Monday
Saturday
Sunday
Thursday
Tuesday
Wednesday

DirectQueryRefreshSchedule

Object

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

Object

Žá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