Bagikan melalui

Datasets - Update Direct Query Refresh Schedule

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

Updates jadwal refresh untuk himpunan data DirectQuery atau LiveConnection tertentu dari Ruang kerja saya.

Permintaan harus berisi satu set hari dan waktu atau frekuensi yang valid, tetapi tidak keduanya. Jika Anda memilih sekumpulan hari tanpa menentukan kapan saja, Maka Power BI akan menggunakan satu waktu default per hari. Mengatur frekuensi akan secara otomatis menimpa pengaturan hari dan waktu.

Izin

Pengguna harus menjadi pemilik himpunan data.

Cakupan yang Diperlukan

Dataset.ReadWrite.All

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
datasetId
 path True

string

ID himpunan data

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
value True

DirectQueryRefreshSchedule

Objek yang berisi detail jadwal refresh untuk DirectQuery atau LiveConnection

Respons

Nama Jenis Deskripsi
200 OK

OK

Contoh

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

Definisi

Nama Deskripsi
days

Hari-hari untuk menjalankan refresh
DirectQueryRefreshSchedule

Jadwal refresh Power BI untuk DirectQuery atau LiveConnection, menentukan frekuensi atau kombinasi hari dan waktu.
DirectQueryRefreshScheduleRequest

Permintaan jadwal refresh Power BI untuk DirectQuery atau LiveConnection

days

Hari-hari untuk menjalankan refresh

Nama Jenis Deskripsi
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

DirectQueryRefreshSchedule

Jadwal refresh Power BI untuk DirectQuery atau LiveConnection, menentukan frekuensi atau kombinasi hari dan waktu.

Nama Jenis Deskripsi
days

days[]

Hari-hari untuk menjalankan refresh
frequency

integer

Interval dalam menit di antara refresh berturut-turut. Nilai yang didukung adalah 15, 30, 60, 120, dan 180.
localTimeZoneId

string

ID zona waktu yang akan digunakan. Untuk informasi selengkapnya, lihat Info zona waktu
times

string[]

Waktu hari untuk menjalankan refresh

DirectQueryRefreshScheduleRequest

Permintaan jadwal refresh Power BI untuk DirectQuery atau LiveConnection

Nama Jenis Deskripsi
value

DirectQueryRefreshSchedule

Objek yang berisi detail jadwal refresh untuk DirectQuery atau LiveConnection