Datasets - Refresh Dataset In Group

참조

서비스:: Power BI REST APIs

API 버전:: v1.0

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

권한을

이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded서비스 주체 프로필을 참조하세요.

필수 범위

Dataset.ReadWrite.All

제한

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

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasetId	path	True	string	데이터 세트 ID
groupId	path	True	string uuid	작업 영역 ID

요청 본문

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

응답

Name	형식	Description
202 Accepted		허용 헤더 x-ms-request-id: string Location: string

Name

형식

Description

202 Accepted

허용

헤더

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

예제

Example of refreshing a dataset

Example of refreshing one partition

Example of refreshing a dataset

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes

요청 본문

{
  "notifyOption": "MailOnFailure",
  "retryCount": 3
}

샘플 응답

상태 코드:: 202

x-ms-request-id: 87f31ef7-1e3a-4006-9b0b-191693e79e9e
Location: https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes/87f31ef7-1e3a-4006-9b0b-191693e79e9e

Example of refreshing one partition

샘플 요청

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

요청 본문

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

샘플 응답

상태 코드:: 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	작업이 실패하기 전에 다시 시도하는 횟수입니다. 임시 내부 오류는 이 매개 변수가 0으로 설정된 경우에도 새로 고침 재시도를 트리거할 수 있습니다.
type	DatasetRefreshType	수행할 처리 유형

DatasetRefreshType

수행할 처리 유형

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

NotifyOption

메일 알림 옵션

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

다음을 통해 공유

Datasets - Refresh Dataset In Group

권한을

필수 범위

제한

URI 매개 변수

요청 본문

응답

예제

Example of refreshing a dataset

샘플 요청

샘플 응답

Example of refreshing one partition

샘플 요청

샘플 응답

정의

DatasetCommitMode

DatasetRefreshObjects

DatasetRefreshRequest

DatasetRefreshType

NotifyOption

추가 리소스