Datasets - Refresh Dataset

참조

Service:: Power BI REST APIs

API Version:: v1.0

내 작업 영역에서 지정된 데이터 세트에 대한 새로 고침을 트리거합니다. 향상된 새로 고침은 이외의 요청 페이로드 notifyOption 가 설정된 경우에만 트리거됩니다.

필수 범위

Dataset.ReadWrite.All

제한 사항

공유 용량의 경우 예약된 새로 고침을 사용하여 실행된 새로 고침을 포함하여 하루에 최대 8개의 요청을 시작할 수 있습니다.
공유 용량의 경우 요청 본문에만 notifyOption 지정할 수 있습니다.
향상된 새로 고침은 공유 용량에 대해 지원되지 않습니다.
향상된 새로 고침의 경우 는 notifyOption 필요하지 않으며 요청 본문에서 제외해야 합니다. 그러나 이외의 notifyOption 하나 이상의 매개 변수가 필요합니다.
프리미엄 용량의 경우 일일 최대 요청은 용량에서 사용 가능한 리소스에 의해서만 제한됩니다. 사용 가능한 리소스가 오버로드되면 부하가 감소할 때까지 새로 고침이 제한됩니다. 제한이 1시간을 초과하면 새로 고침이 실패합니다.

POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasetId	path	True	string	데이터 세트 ID

요청 본문

Name	필수	형식	Description
notifyOption	True	NotifyOption	메일 알림 옵션. 이 매개 변수는 서비스 주체를 사용하는 향상된 새로 고침 또는 API 작업에는 적용되지 않습니다.
applyRefreshPolicy		boolean	정책이 적용되는지 여부를 확인합니다.
commitMode		DatasetCommitMode	개체가 일괄 처리로 커밋되는지 또는 완료된 경우에만 커밋되는지 확인합니다.
effectiveDate		string	증분 새로 고침 정책이 적용되면 `effectiveDate` 매개 변수는 현재 날짜를 재정의합니다.
maxParallelism		integer	병렬 처리 명령을 실행할 최대 스레드 수
objects		DatasetRefreshObjects[]	처리할 개체의 배열입니다.
retryCount		integer	작업이 실패하기 전에 다시 시도하는 횟수
type		DatasetRefreshType	수행할 처리 유형

응답

Name	형식	Description
202 Accepted		수락됨 Headers x-ms-request-id: string Location: string

Name

형식

Description

202 Accepted

수락됨

Headers

x-ms-request-id: string
Location: string

예제

Example of refreshing a dataset

Example of refreshing one partition

Example of refreshing a dataset

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes

Sample Response

Status code:: 202

x-ms-request-id: 03f22bb5-2e98-4ae8-8113-329bec3987b1
Location: https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes/03f22bb5-2e98-4ae8-8113-329bec3987b1

Example of refreshing one partition

Sample Request

POST https://api.powerbi.com/v1.0/myorg/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes

Request Body

{
  "type": "full",
  "commitMode": "transactional",
  "objects": [
    {
      "table": "Customer",
      "partition": "Robert"
    }
  ],
  "applyRefreshPolicy": "false"
}

Sample Response

Status code:: 200

정의

Name	Description
DatasetCommitMode	개체가 일괄 처리로 커밋되는지 또는 완료된 경우에만 커밋되는지 확인합니다.
DatasetRefreshObjects	Power BI 데이터 세트 새로 고침 대상
DatasetRefreshRequest	Power BI 데이터 세트 새로 고침 요청
DatasetRefreshType	수행할 처리 유형
NotifyOption	메일 알림 옵션

DatasetCommitMode

개체가 일괄 처리로 커밋되는지 또는 완료된 경우에만 커밋되는지 확인합니다.

Name	형식	Description
PartialBatch	string	일괄 처리로 새로 고침 작업을 커밋합니다. 모드를 `partialBatch` 사용하는 경우 새로 고침 작업은 트랜잭션 내에서 발생하지 않습니다. 따라서 각 명령은 개별적으로 커밋되며, 오류가 발생할 경우 모델은 데이터의 하위 집합만 로드되거나 테이블이 비어 있는 상태로 끝날 수 있습니다. 오류가 발생한 경우 이전 데이터의 보존을 보장하려면 다음을 사용하여 작업을 실행해야 합니다. `commitMode = transactional.`
Transactional	string	전체 새로 고침 작업을 트랜잭션으로 커밋

DatasetRefreshObjects

Power BI 데이터 세트 새로 고침 대상

Name	형식	Description
partition	string	새로 고칠 파티션
table	string	새로 고칠 테이블

DatasetRefreshRequest

Power BI 데이터 세트 새로 고침 요청

Name	형식	Description
applyRefreshPolicy	boolean	정책이 적용되는지 여부를 확인합니다.
commitMode	DatasetCommitMode	개체가 일괄 처리로 커밋되는지 또는 완료된 경우에만 커밋되는지 확인합니다.
effectiveDate	string	증분 새로 고침 정책이 적용되면 `effectiveDate` 매개 변수는 현재 날짜를 재정의합니다.
maxParallelism	integer	병렬 처리 명령을 실행할 최대 스레드 수
notifyOption	NotifyOption	메일 알림 옵션. 이 매개 변수는 서비스 주체를 사용하는 향상된 새로 고침 또는 API 작업에는 적용되지 않습니다.
objects	DatasetRefreshObjects[]	처리할 개체의 배열입니다.
retryCount	integer	작업이 실패하기 전에 다시 시도하는 횟수
type	DatasetRefreshType	수행할 처리 유형

DatasetRefreshType

수행할 처리 유형

Name	형식	Description
Automatic	string	개체를 새로 고치고 다시 계산해야 할 경우 개체 및 해당하는 모든 종속 항목을 새로 고치고 다시 계산합니다. 파티션이 준비 이외의 상태인 경우에 적용됩니다.
Calculate	string	이 개체 및 해당하는 모든 종속 항목을 다시 계산하지만, 필요한 경우에만 이렇게 합니다. 이 값은 휘발성 수식을 제외하고 강제로 다시 계산하지 않습니다.
ClearValues	string	이 개체 및 모든 종속 개체의 값 지우기
DataOnly	string	이 개체의 데이터를 새로 고치고 모든 종속 항목을 지웁니다.
Defragment	string	지정한 테이블의 데이터를 조각 모음합니다. 데이터가 테이블에 추가되거나 테이블에서 제거되면 각 열의 사전이 더 이상 실제 열 값에 존재하지 않는 값으로 유효하지 않게 될 수 있습니다. 조각 모음 옵션은 더 이상 사용되지 않는 사전의 값을 정리합니다.
Full	string	지정한 파티션, 테이블 또는 데이터베이스의 모든 파티션의 경우 데이터를 새로 고치고 모든 종속 항목을 다시 계산합니다. 계산 파티션의 경우 파티션 및 해당하는 모든 종속 항목을 다시 계산합니다.

NotifyOption

메일 알림 옵션

Name	형식	Description
MailOnCompletion	string	새로 고침 완료 시 성공 또는 실패를 나타내는 메일 알림이 전송됩니다.
MailOnFailure	string	새로 고침 실패 시 메일 알림이 전송됩니다.
NoNotification	string	알림이 전송되지 않습니다.

Datasets - Refresh Dataset

필수 범위

제한 사항

URI 매개 변수

요청 본문

응답

예제

Example of refreshing a dataset

Sample Request

Sample Response

Example of refreshing one partition

Sample Request

Sample Response

정의

DatasetCommitMode

DatasetRefreshObjects

DatasetRefreshRequest

DatasetRefreshType

NotifyOption

추가 리소스