Datasets - Refresh Dataset In Group
지정된 작업 영역에서 지정된 데이터 세트에 대한 새로 고침을 트리거합니다. 향상된 새로 고침은 이외의 요청 페이로드 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 |
---|---|---|---|---|
dataset
|
path | True |
string |
데이터 세트 ID |
group
|
path | True |
string uuid |
작업 영역 ID |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
notifyOption | True |
메일 알림 옵션. 이 매개 변수는 서비스 주체를 사용하는 향상된 새로 고침 또는 API 작업에는 적용되지 않습니다. |
|
applyRefreshPolicy |
boolean |
정책이 적용되었는지 여부를 확인합니다. |
|
commitMode |
개체가 일괄 처리로 커밋되는지 아니면 완료된 경우에만 커밋되는지 확인합니다. |
||
effectiveDate |
string |
증분 새로 고침 정책이 적용되면 |
|
maxParallelism |
integer |
병렬 처리 명령을 실행할 최대 스레드 수 |
|
objects |
처리할 개체의 배열 |
||
retryCount |
integer |
실패하기 전에 작업이 다시 시도되는 횟수 |
|
type |
수행할 처리 유형 |
응답
Name | 형식 | Description |
---|---|---|
202 Accepted |
수락됨 Headers
|
예제
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/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
{
"notifyOption": "MailOnFailure",
"retryCount": 3
}
Sample Response
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
Sample Request
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"
}
Sample Response
정의
Name | Description |
---|---|
Dataset |
개체가 일괄 처리로 커밋되는지 아니면 완료된 경우에만 커밋되는지 확인합니다. |
Dataset |
Power BI 데이터 세트 새로 고침 대상 |
Dataset |
Power BI 데이터 세트 새로 고침 요청 |
Dataset |
수행할 처리 유형 |
Notify |
메일 알림 옵션 |
DatasetCommitMode
개체가 일괄 처리로 커밋되는지 아니면 완료된 경우에만 커밋되는지 확인합니다.
Name | 형식 | Description |
---|---|---|
PartialBatch |
string |
일괄 처리로 새로 고침 작업을 커밋합니다. 모드를 |
Transactional |
string |
전체 새로 고침 작업을 트랜잭션으로 커밋 |
DatasetRefreshObjects
Power BI 데이터 세트 새로 고침 대상
Name | 형식 | Description |
---|---|---|
partition |
string |
새로 고칠 파티션 |
table |
string |
새로 고칠 테이블 |
DatasetRefreshRequest
Power BI 데이터 세트 새로 고침 요청
Name | 형식 | Description |
---|---|---|
applyRefreshPolicy |
boolean |
정책이 적용되었는지 여부를 확인합니다. |
commitMode |
개체가 일괄 처리로 커밋되는지 아니면 완료된 경우에만 커밋되는지 확인합니다. |
|
effectiveDate |
string |
증분 새로 고침 정책이 적용되면 |
maxParallelism |
integer |
병렬 처리 명령을 실행할 최대 스레드 수 |
notifyOption |
메일 알림 옵션. 이 매개 변수는 서비스 주체를 사용하는 향상된 새로 고침 또는 API 작업에는 적용되지 않습니다. |
|
objects |
처리할 개체의 배열 |
|
retryCount |
integer |
실패하기 전에 작업이 다시 시도되는 횟수 |
type |
수행할 처리 유형 |
DatasetRefreshType
수행할 처리 유형
Name | 형식 | Description |
---|---|---|
Automatic |
string |
개체를 새로 고치고 다시 계산해야 할 경우 개체 및 해당하는 모든 종속 항목을 새로 고치고 다시 계산합니다. 파티션이 준비 이외의 상태인 경우에 적용됩니다. |
Calculate |
string |
이 개체 및 해당하는 모든 종속 항목을 다시 계산하지만, 필요한 경우에만 이렇게 합니다. 이 값은 휘발성 수식을 제외하고 강제로 다시 계산하지 않습니다. |
ClearValues |
string |
이 개체 및 모든 종속의 값 지우기 |
DataOnly |
string |
이 개체의 데이터를 새로 고치고 모든 종속성 지우기 |
Defragment |
string |
지정한 테이블의 데이터를 조각 모음합니다. 데이터가 테이블에 추가되거나 테이블에서 제거되면 각 열의 사전이 더 이상 실제 열 값에 존재하지 않는 값으로 유효하지 않게 될 수 있습니다. 조각 모음 옵션은 더 이상 사용되지 않는 사전의 값을 정리합니다. |
Full |
string |
지정한 파티션, 테이블 또는 데이터베이스의 모든 파티션의 경우 데이터를 새로 고치고 모든 종속 항목을 다시 계산합니다. 계산 파티션의 경우 파티션 및 해당하는 모든 종속 항목을 다시 계산합니다. |
NotifyOption
메일 알림 옵션
Name | 형식 | Description |
---|---|---|
MailOnCompletion |
string |
새로 고침 완료 시 성공 또는 실패를 나타내는 메일 알림이 전송됩니다. |
MailOnFailure |
string |
새로 고침 실패 시 메일 알림이 전송됩니다. |
NoNotification |
string |
알림이 전송되지 않습니다. |