Share via

Datasets - Update Direct Query Refresh Schedule

  • Başvuru
Service:
Power BI REST APIs
API Version:
v1.0

Çalışma alanım'dan belirtilen DirectQuery veya LiveConnection veri kümesi için yenileme zamanlamasını Güncelleştirmeler.

İstek bir dizi gün ve saat veya geçerli bir sıklık içermelidir, ancak ikisini birden içermemelidir. Saat belirtmeden bir gün kümesi seçerseniz, Power BI varsayılan olarak günde tek bir saat kullanır. Sıklık ayarı otomatik olarak gün ve saat ayarının üzerine yazılır.

İzinler

Kullanıcının veri kümesi sahibi olması gerekir.

Gerekli Kapsam

Dataset.ReadWrite.All

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

URI Parametreleri

Name İçinde Gerekli Tür Description
datasetId
 path True

string

Veri kümesi kimliği

İstek Gövdesi

Name Gerekli Tür Description
value True

DirectQueryRefreshSchedule

DirectQuery veya LiveConnection için yenileme zamanlaması ayrıntılarını içeren bir nesne

Yanıtlar

Name Tür Description
200 OK

Tamam

Örnekler

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

Tanımlar

Name Description
days

Yenilemenin yürütülecek gün sayısı
DirectQueryRefreshSchedule

Sıklığı veya gün ve saatlerin birleşimini belirten DirectQuery veya LiveConnection için bir Power BI yenileme zamanlaması.
DirectQueryRefreshScheduleRequest

DirectQuery veya LiveConnection için Power BI yenileme zamanlaması isteği

days

Yenilemenin yürütülecek gün sayısı

Name Tür Description
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

DirectQueryRefreshSchedule

Sıklığı veya gün ve saatlerin birleşimini belirten DirectQuery veya LiveConnection için bir Power BI yenileme zamanlaması.

Name Tür Description
days

days[]

Yenilemenin yürütülecek gün sayısı
frequency

integer

Ardışık yenilemeler arasındaki dakika cinsinden aralık. Desteklenen değerler 15, 30, 60, 120 ve 180'tir.
localTimeZoneId

string

Kullanılacak saat diliminin kimliği. Daha fazla bilgi için bkz . Saat dilimi bilgileri
times

string[]

Yenilemeyi yürütmek için günün saatleri

DirectQueryRefreshScheduleRequest

DirectQuery veya LiveConnection için Power BI yenileme zamanlaması isteği

Name Tür Description
value

DirectQueryRefreshSchedule

DirectQuery veya LiveConnection için yenileme zamanlaması ayrıntılarını içeren bir nesne