Datasets - Refresh Dataset
내 작업 영역에서 지정된 데이터 세트에 대한 새로 고침을 트리거합니다. 향상된 새로 고침은 이외의 요청 페이로드 notifyOption
가 설정된 경우에만 트리거됩니다.
필수 범위
Dataset.ReadWrite.All
제한 사항
- 공유 용량의 경우 예약된 새로 고침을 사용하여 실행된 새로 고침을 포함하여 하루에 최대 8개의 요청을 시작할 수 있습니다.
- 공유 용량의 경우 요청 본문에만
notifyOption
지정할 수 있습니다. - 향상된 새로 고침은 공유 용량에 대해 지원되지 않습니다.
- 향상된 새로 고침의 경우 는
notifyOption
필요하지 않으며 요청 본문에서 제외해야 합니다. 그러나 이외의notifyOption
하나 이상의 매개 변수가 필요합니다. - 프리미엄 용량의 경우 일일 최대 요청은 용량에서 사용 가능한 리소스에 의해서만 제한됩니다. 사용 가능한 리소스가 오버로드되면 부하가 감소할 때까지 새로 고침이 제한됩니다. 제한이 1시간을 초과하면 새로 고침이 실패합니다.
POST https://api.powerbi.com/v1.0/myorg/datasets/{datasetId}/refreshes
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
dataset
|
path | True |
string |
데이터 세트 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/datasets/cfafbeb1-8037-4d0c-896e-a46fb27ff229/refreshes
Sample Response
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
{
"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 |
알림이 전송되지 않습니다. |