Datasets - Update Direct Query Refresh Schedule

Updates den Aktualisierungszeitplan für ein angegebenes DirectQuery- oder LiveConnection-Dataset aus Meinem Arbeitsbereich aus.

Eine Anforderung sollte entweder eine Reihe von Tagen und Uhrzeiten oder eine gültige Häufigkeit enthalten, aber nicht beides. Wenn Sie eine Reihe von Tagen ohne Angabe von Uhrzeiten auswählen, verwendet Power BI standardmäßig eine einzelne Uhrzeit pro Tag. Wenn Sie die Häufigkeit festlegen, werden die Einstellungen für Tage und Uhrzeiten automatisch überschrieben.

Berechtigungen

Der Benutzer muss der Besitzer des Datasets sein.

Erforderlicher Bereich

Dataset.ReadWrite.All

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
datasetId
path True

string

Die Dataset-ID

Anforderungstext

Name Erforderlich Typ Beschreibung
value True

DirectQueryRefreshSchedule

Ein Objekt mit den Details zum Aktualisierungszeitplan für DirectQuery oder LiveConnection

Antworten

Name Typ Beschreibung
200 OK

OK

Beispiele

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

Sample Response

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

Sample Response

Set a frequency based schedule example

Sample Request

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

Sample Response

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

Sample Response

Definitionen

Name Beschreibung
days

Die Tage, an denen die Aktualisierung ausgeführt werden soll

DirectQueryRefreshSchedule

Ein Power BI-Aktualisierungszeitplan für DirectQuery oder LiveConnection, der entweder die Häufigkeit oder eine Kombination aus Tagen und Zeiten angibt.

DirectQueryRefreshScheduleRequest

Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection

days

Die Tage, an denen die Aktualisierung ausgeführt werden soll

Name Typ Beschreibung
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

DirectQueryRefreshSchedule

Ein Power BI-Aktualisierungszeitplan für DirectQuery oder LiveConnection, der entweder die Häufigkeit oder eine Kombination aus Tagen und Zeiten angibt.

Name Typ Beschreibung
days

days[]

Die Tage, an denen die Aktualisierung ausgeführt werden soll

frequency

integer

Das Intervall in Minuten zwischen aufeinander folgenden Aktualisierungen. Unterstützte Werte sind 15, 30, 60, 120 und 180.

localTimeZoneId

string

Die ID der zu verwendenden Zeitzone. Weitere Informationen finden Sie unter Zeitzoneninformationen.

times

string[]

Die Tageszeiten, zu denen die Aktualisierung ausgeführt werden soll

DirectQueryRefreshScheduleRequest

Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection

Name Typ Beschreibung
value

DirectQueryRefreshSchedule

Ein Objekt mit den Details zum Aktualisierungszeitplan für DirectQuery oder LiveConnection