Datasets - Update Direct Query Refresh Schedule In Group

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

Aktualizace plán aktualizace pro zadanou datovou sadu DirectQuery nebo LiveConnection ze zadaného pracovního prostoru.

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.
• Toto volání rozhraní API lze volat pomocí profilu instančního objektu. Další informace najdete v tématu Profily instančního objektu v Power BI Embedded.

Požadovaný obor

Dataset.ReadWrite.All

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasetId	path	True	string	ID datové sady
groupId	path	True	string uuid	ID pracovního prostoru

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

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

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule

Text požadavku

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

Ukázková odpověď

Stavový kód:

200

Update the times of an existing days and times based schedule example

Ukázkový požadavek

PATCH https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/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í časy, kdy se má aktualizace provést

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