다음을 통해 공유

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 매개 변수

Name In(다음 안에) 필수 형식 Description
datasetId
 path True

string

데이터 세트 ID

요청 본문

Name 필수 형식 Description
value True

DirectQueryRefreshSchedule

DirectQuery 또는 LiveConnection에 대한 새로 고침 일정 세부 정보가 포함된 개체

응답

Name 형식 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

정의

Name Description
days

새로 고침을 실행할 일
DirectQueryRefreshSchedule

빈도 또는 일 및 시간의 조합을 지정하는 DirectQuery 또는 LiveConnection에 대한 Power BI 새로 고침 일정입니다.
DirectQueryRefreshScheduleRequest

DirectQuery 또는 LiveConnection에 대한 Power BI 새로 고침 일정 요청

days

새로 고침을 실행할 일

Name 형식 Description
Friday

string

Monday

string

Saturday

string

Sunday

string

Thursday

string

Tuesday

string

Wednesday

string

DirectQueryRefreshSchedule

빈도 또는 일 및 시간의 조합을 지정하는 DirectQuery 또는 LiveConnection에 대한 Power BI 새로 고침 일정입니다.

Name 형식 Description
days

days[]

새로 고침을 실행할 일
frequency

integer

연속 새로 고침 사이의 간격(분)입니다. 지원되는 값은 15, 30, 60, 120 및 180입니다.
localTimeZoneId

string

사용할 표준 시간대의 ID입니다. 자세한 내용은 표준 시간대 정보를 참조하세요.
times

string[]

새로 고침을 실행하는 하루 중 시간

DirectQueryRefreshScheduleRequest

DirectQuery 또는 LiveConnection에 대한 Power BI 새로 고침 일정 요청

Name 형식 Description
value

DirectQueryRefreshSchedule

DirectQuery 또는 LiveConnection에 대한 새로 고침 일정 세부 정보가 포함된 개체