Datasets - Get Refresh Execution Details

참조

Service:: Power BI REST APIs

API Version:: v1.0

내 작업 영역에서 지정된 데이터 세트에 대한 향상된 새로 고침 작업의 실행 세부 정보를 반환합니다.

필수 범위

Dataset.ReadWrite.All 또는 Dataset.Read.All

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasetId	path	True	string uuid	데이터 세트 ID
refreshId	path	True	string uuid	새로 고침 ID

응답

Name	형식	Description
200 OK	DatasetRefreshDetail	확인(새로 고침 작업이 완료되었거나 실패하면 이 응답이 반환됨)
202 Accepted	DatasetRefreshDetail	수락됨(이 응답은 새로 고침 작업이 아직 진행 중일 때 반환됨)

예제

Completed refresh example

Failed refresh example

In progress refresh example

Completed refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/datasets/f7fc6510-e151-42a3-850b-d0805a391db0/refreshes/87f31ef7-1e3a-4006-9b0b-191693e79e9e

Sample Response

Status code:: 200

{
  "startTime": "2021-12-10T08:40:31.57",
  "endTime": "2021-12-10T08:40:43.87",
  "type": "Full",
  "commitMode": "Transactional",
  "status": "Completed",
  "extendedStatus": "Completed",
  "currentRefreshType": "Full",
  "numberOfAttempts": 0,
  "objects": [
    {
      "table": "DateTableTemplate_78e78207-b3fb-41b5-8b95-e5efca989067",
      "partition": "DateTableTemplate_78e78207-b3fb-41b5-8b95-e5efca989067-ae306fb4-3b7e-4a41-824d-cb3b452fedfc",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_e9d8a66b-4018-4d16-be8c-402b2037c051",
      "partition": "LocalDateTable_e9d8a66b-4018-4d16-be8c-402b2037c051-59bc07f8-85c9-456a-ad36-18e1de4d77ed",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_55935f6b-04d1-4cfe-8856-ed9f9e73ab2e",
      "partition": "LocalDateTable_55935f6b-04d1-4cfe-8856-ed9f9e73ab2e-d95ae7f7-19c9-48a8-9c16-fcab26558bc2",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_ff25f80e-eb04-4229-986d-b40223c04f1c",
      "partition": "LocalDateTable_ff25f80e-eb04-4229-986d-b40223c04f1c-6606fc4c-4cda-49e1-8acd-e55a6ec36cb3",
      "status": "Completed"
    },
    {
      "table": "DimCurrency",
      "partition": "DimCurrency-e5524cc4-a898-433b-91aa-c001b9a6d676",
      "status": "Completed"
    },
    {
      "table": "DimCustomer",
      "partition": "DimCustomer-a31bbd93-e20a-4dee-a33c-7afa27785953",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_fa65a206-f320-4d5d-abcc-1dc0f051ca7d",
      "partition": "LocalDateTable_fa65a206-f320-4d5d-abcc-1dc0f051ca7d-06a48a0a-a32b-48a3-b113-924aafd6363c",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_78a4e1b7-a2e5-4bbf-ab68-7c87961b68a2",
      "partition": "LocalDateTable_78a4e1b7-a2e5-4bbf-ab68-7c87961b68a2-5b3ba715-7c84-4e52-b310-485b93cfbe6d",
      "status": "Completed"
    },
    {
      "table": "DimDate",
      "partition": "DimDate-62e2f91b-53e5-4ed3-8618-fec74dba5e0d",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_e72c294f-0a06-4051-b943-e6bf8389e2c3",
      "partition": "LocalDateTable_e72c294f-0a06-4051-b943-e6bf8389e2c3-891a0e68-d414-4ba3-9c4b-e6f1ec73d4f3",
      "status": "Completed"
    },
    {
      "table": "DimProduct",
      "partition": "DimProduct-3d07cc89-2bd7-4a98-bb37-3368c1562f98",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_e37e4431-8c1a-449c-8796-b704df200a92",
      "partition": "LocalDateTable_e37e4431-8c1a-449c-8796-b704df200a92-8596ebb8-418f-4e50-a921-dac88c6f1339",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_73faffeb-a0c7-4ea1-83dc-530823b0fea0",
      "partition": "LocalDateTable_73faffeb-a0c7-4ea1-83dc-530823b0fea0-13795c4e-708f-4ddc-8ea3-5a2f39ae2253",
      "status": "Completed"
    },
    {
      "table": "DimPromotion",
      "partition": "DimPromotion-21e6c333-430e-4350-8c94-cdceb362c4c7",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_9c19746b-db7d-4b7e-b95d-c66e4b8fefc8",
      "partition": "LocalDateTable_9c19746b-db7d-4b7e-b95d-c66e4b8fefc8-395de144-ad53-41c0-9ec0-68bab6158d99",
      "status": "Completed"
    },
    {
      "table": "LocalDateTable_d96435dd-6110-4246-996c-616c96125e71",
      "partition": "LocalDateTable_d96435dd-6110-4246-996c-616c96125e71-891737ee-c46c-4b9f-bfa8-e4555004e20f",
      "status": "Completed"
    },
    {
      "table": "DimSalesTerritory",
      "partition": "DimSalesTerritory-6d88f938-13d5-49f8-899c-d11b3d346ad5",
      "status": "Completed"
    },
    {
      "table": "FactInternetSales",
      "status": "Completed"
    }
  ],
  "refreshAttempts": [
    {
      "attemptId": 1,
      "startTime": "2021-12-10T08:40:31.57",
      "endTime": "2021-12-10T08:40:43.87",
      "type": "Data"
    }
  ]
}

Failed refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/datasets/f7fc6510-e151-42a3-850b-d0805a391db0/refreshes/351f7113-59bb-4e5e-8c1e-e15ae7414121

Sample Response

Status code:: 200

{
  "startTime": "2021-12-10T08:39:28.517",
  "endTime": "2021-12-10T08:39:30.04",
  "type": "Full",
  "commitMode": "PartialBatch",
  "status": "Failed",
  "extendedStatus": "Failed",
  "currentRefreshType": "Full",
  "numberOfAttempts": 0,
  "messages": [
    {
      "message": "RefreshApiRequest for table refresh using refresh policy must have the property 'CommitMode' = 'Transactional' instead of 'PartialBatch'.",
      "type": "Error"
    }
  ],
  "refreshAttempts": [
    {
      "attemptId": 1,
      "startTime": "2021-12-10T08:39:28.517",
      "endTime": "2021-12-10T08:39:30.04",
      "serviceExceptionJson": "{\"errorCode\":\"ModelRefresh_ShortMessage_ProcessingError\",\"errorDescription\":\"0xC112001C: Expression.Error: Forced Error. . The exception was raised by the IDbCommand interface.\\n0xC112001C: The command has been canceled.. The exception was raised by the IDbCommand interface.\\n0xC11C0006: The current operation was cancelled because another operation in the transaction failed.\\n0xC112001C: The command has been canceled.. The exception was raised by the IDbCommand interface.\\n0xC112001C: The command has been canceled.. The exception was raised by the IDbCommand interface.\\n0xC112001C: The command has been canceled.. The exception was raised by the IDbCommand interface.\"}",
      "type": "Data"
    }
  ]
}

In progress refresh example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/datasets/f7fc6510-e151-42a3-850b-d0805a391db0/refreshes/630110f5-8f93-49c2-afee-bfc87072460c

Sample Response

Status code:: 202

{
  "startTime": "2021-12-14T03:46:04.833",
  "type": "Full",
  "commitMode": "Transactional",
  "status": "Unknown",
  "extendedStatus": "NotStarted",
  "currentRefreshType": "Full",
  "numberOfAttempts": 0
}

정의

Name	Description
DatasetRefreshDetail	Power BI 새로 고침 세부 정보 항목
DatasetRefreshDetailCommitMode	개체가 일괄 처리로 커밋되는지 아니면 완료된 경우에만 커밋되는지 확인합니다.
DatasetRefreshDetailExtendedStatus	자세한 데이터 세트 작업 상태
DatasetRefreshDetailStatus	데이터 세트 작업 일반 상태
DatasetRefreshDetailType	수행할 처리 유형
DatasetRefreshObjects	Power BI 데이터 세트 새로 고침 대상
EngineMessage	향상된 새로 고침을 위한 엔진의 오류 또는 경고 메시지
RefreshAttempt	Power BI는 새로 고침 오류가 발생하는 경우 데이터 세트를 새로 고치려고 여러 차례 자동으로 시도합니다. 이 개체에는 각 새로 고침 시도에 대한 정보가 포함됩니다.
RefreshAttemptType	새로 고침 시도 유형입니다.
RefreshEngineErrorType	오류의 유형

DatasetRefreshDetail

Power BI 새로 고침 세부 정보 항목

Name	형식	Description
commitMode	DatasetRefreshDetailCommitMode	개체가 일괄 처리로 커밋되는지 아니면 완료된 경우에만 커밋되는지 확인합니다.
currentRefreshType	DatasetRefreshDetailType	현재 반복에 대한 처리 유형입니다. 이 기능은 가 로 설정된 경우에 `commitMode` 유용합니다. `PartialBatch`
endTime	string	새로 고침의 종료 날짜 및 시간(새로 고침이 진행 중인 경우 비어 있을 수 있음)
extendedStatus	DatasetRefreshDetailExtendedStatus	자세한 데이터 세트 작업 상태
messages	EngineMessage[]	새로 고침 요청에 대한 엔진 오류 또는 경고 메시지 배열
numberOfAttempts	integer	새로 고침 요청에 대한 시도 횟수
objects	DatasetRefreshObjects[]	새로 고침 요청에 포함된 개체의 배열
refreshAttempts	RefreshAttempt[]	새로 고침 시도 목록입니다.
startTime	string	새로 고침의 시작 날짜 및 시간
status	DatasetRefreshDetailStatus	데이터 세트 작업 일반 상태
type	DatasetRefreshDetailType	수행할 처리 유형

DatasetRefreshDetailCommitMode

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

Name	형식	Description
PartialBatch	string	일괄 처리로 새로 고침 작업 커밋
Transactional	string	전체 새로 고침 작업을 트랜잭션으로 커밋

DatasetRefreshDetailExtendedStatus

자세한 데이터 세트 작업 상태

Name	형식	Description
Cancelled	string	고객이 새로 고침 작업을 취소했습니다.
Completed	string	새로 고침 작업이 성공적으로 완료되었습니다.
Disabled	string	선택적 새로 고침으로 새로 고침 작업을 사용하지 않도록 설정됨
Failed	string	새로 고침 작업이 실패했습니다.
InProgress	string	새로 고침 작업이 진행 중입니다.
NotStarted	string	새로 고침 작업이 시작되지 않음
TimedOut	string	새로 고침 작업이 시간 초과됨
Unknown	string	완료 상태를 알 수 없음

DatasetRefreshDetailStatus

데이터 세트 작업 일반 상태

Name	형식	Description
Completed	string	새로 고침 작업이 성공적으로 완료되었습니다.
Disabled	string	선택적 새로 고침으로 새로 고침 작업을 사용하지 않도록 설정됨
Failed	string	새로 고침 작업이 실패했습니다.
Unknown	string	완료 상태를 알 수 없거나 새로 고침이 진행 중입니다.

DatasetRefreshDetailType

수행할 처리 유형

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

DatasetRefreshObjects

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

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

EngineMessage

향상된 새로 고침을 위한 엔진의 오류 또는 경고 메시지

Name	형식	Description
code	string	16진수 형식의 오류 코드
message	string	오류 또는 경고 메시지의 텍스트
type	RefreshEngineErrorType	오류의 유형

RefreshAttempt

Power BI는 새로 고침 오류가 발생하는 경우 데이터 세트를 새로 고치려고 여러 차례 자동으로 시도합니다. 이 개체에는 각 새로 고침 시도에 대한 정보가 포함됩니다.

Name	형식	Description
attemptId	integer	새로 고침 시도의 인덱스입니다.
endTime	string	새로 고침 시도의 종료 날짜 및 시간입니다. 새로 고침 시도가 진행 중인 경우 값은 void입니다.
serviceExceptionJson	string	JSON 형식의 오류 오류 코드입니다. 오류가 없으면 Void입니다.
startTime	string	새로 고침 시도의 시작 날짜 및 시간입니다.
type	RefreshAttemptType	새로 고침 시도 유형입니다.

RefreshAttemptType

새로 고침 시도 유형입니다.

Name	형식	Description
Data	string	데이터 세트에 데이터를 로드하려는 새로 고침 시도입니다.
Query	string	프리미엄 쿼리 캐시를 새로 고치고 타일을 dashboard 시도

RefreshEngineErrorType

오류의 유형

Name	형식	Description
Error	string	오류 메시지
Warning	string	경고 메시지

다음을 통해 공유

Datasets - Get Refresh Execution Details

필수 범위

URI 매개 변수

응답

예제

Completed refresh example

Sample Request

Sample Response

Failed refresh example

Sample Request

Sample Response

In progress refresh example

Sample Request

Sample Response

정의

DatasetRefreshDetail

DatasetRefreshDetailCommitMode

DatasetRefreshDetailExtendedStatus

DatasetRefreshDetailStatus

DatasetRefreshDetailType

DatasetRefreshObjects

EngineMessage

RefreshAttempt

RefreshAttemptType

RefreshEngineErrorType

추가 리소스