Freigeben über


Datasets - Update Direct Query Refresh Schedule

Aktualisiert den Aktualisierungszeitplan für ein angegebenes DirectQuery - oder LiveConnection-Dataset aus meinem Arbeitsbereich.

Eine Anforderung sollte entweder eine Reihe von Tagen und Uhrzeiten oder eine gültige Häufigkeit enthalten, aber nicht beide. Wenn Sie eine Gruppe von Tagen ohne Angabe von Uhrzeiten auswählen, verwendet Power BI eine Standardzeit pro Tag. Wenn Sie die Häufigkeit festlegen, werden die Einstellung für Tage und Uhrzeiten automatisch überschrieben.

Erlaubnisse

Der Benutzer muss der Datasetbesitzer 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 Aktualisierungszeitplandetails für DirectQuery oder LiveConnection

Antworten

Name Typ Beschreibung
200 OK

OKAY

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

Beispielanforderung

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

Beispiel für eine Antwort

Set a days and times based schedule example

Beispielanforderung

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"
  }
}

Beispiel für eine Antwort

Set a frequency based schedule example

Beispielanforderung

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

Beispiel für eine Antwort

Update the times of a days and times based schedule example

Beispielanforderung

PATCH https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/directQueryRefreshSchedule
{
  "value": {
    "times": [
      "07:00",
      "16:30",
      "23:30"
    ]
  }
}

Beispiel für eine Antwort

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 Uhrzeiten angibt.

DirectQueryRefreshScheduleRequest

Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection

days

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

Wert Beschreibung
Monday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday

DirectQueryRefreshSchedule

Ein Power BI-Aktualisierungszeitplan für DirectQuery oder LiveConnection, der entweder die Häufigkeit oder eine Kombination aus Tagen und Uhrzeiten 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, um die Aktualisierung auszuführen

DirectQueryRefreshScheduleRequest

Power BI-Aktualisierungszeitplananforderung für DirectQuery oder LiveConnection

Name Typ Beschreibung
value

DirectQueryRefreshSchedule

Ein Objekt mit den Aktualisierungszeitplandetails für DirectQuery oder LiveConnection