共用方式為

Datasets - Update Direct Query Refresh Schedule

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

更新 [我的工作區] 中指定DirectQuery或LiveConnection資料集的重新整理排程。

要求應包含一組天數 和時間或 有效頻率，但不能同時包含兩者。 如果您選擇一組天數而不指定任何時間，則 Power BI 會每天使用預設單一時間。 設定頻率會自動覆寫天數和時間設定。

權限

使用者必須是資料集擁有者。

必要範圍

Dataset.ReadWrite.All

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

URI 參數

名稱 位於 必要 類型 Description
datasetId
 path True

string

資料集識別碼

要求本文

名稱 必要 類型 Description
value True

DirectQueryRefreshSchedule

物件，包含 DirectQuery 或 LiveConnection 的重新整理排程詳細資料

回應

名稱 類型 Description
200 OK

確定

範例

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

定義

名稱 Description
days

要執行重新整理的天數
DirectQueryRefreshSchedule

DirectQuery 或 LiveConnection 的 Power BI 重新整理排程，指定頻率或天數和時間的組合。
DirectQueryRefreshScheduleRequest

DirectQuery 或 LiveConnection 的 Power BI 重新整理排程要求

days

要執行重新整理的天數

名稱 類型 Description
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

DirectQueryRefreshSchedule

DirectQuery 或 LiveConnection 的 Power BI 重新整理排程，指定頻率或天數和時間的組合。

名稱 類型 Description
days

days[]

要執行重新整理的天數
frequency

integer

連續重新整理之間的間隔，以分鐘為單位。 支援的值為15、30、60、120和180。

localTimeZoneId

string

要使用的時區識別碼。 如需詳細資訊，請參閱 時區資訊
times

string[]

執行重新整理的一天時間

DirectQueryRefreshScheduleRequest

DirectQuery 或 LiveConnection 的 Power BI 重新整理排程要求

名稱 類型 Description
value

DirectQueryRefreshSchedule

物件，包含 DirectQuery 或 LiveConnection 的重新整理排程詳細資料