정확한 저장 문서 읽기
현재 Report handle이 고정한 revision을 불변 ReportDocument로 읽습니다.
문법
report.document() -> 'ReportDocument'예제
document = report.document()
if document.freshness is not None:
for result in document.freshness.results:
print(result.connection_key, result.mapping_key, result.status, result.reason)규칙
저장 전이나 미저장 편집이 있으면 거부합니다. 최신 head를 따라가지 않으며 소유 Client가 열려 있어야 합니다.
freshness는 Runtime이 판정한 저장 결과의 최신성입니다. current는 저장 입력·고정 Flow·연결이 실행 당시와 일치하고, stale은 그중 하나가 달라졌으며, unknown은 근거가 부족함을 뜻합니다. 기존 결과 값은 그대로 둡니다. 오프라인 문서 또는 해당 조회를 지원하지 않는 Runtime에서는 None이며 이를 최신으로 추정하면 안 됩니다. .pxreport 직렬화에는 이 조회 값을 넣지 않습니다.
표의 여러 행을 Batch로 실행하면 각 case의 결과가 서로 다른 실행에서 올 수 있습니다. Runtime은 표의 기존 presentation metadata에 resultProvenance를 보존합니다. 각 출처에는 연결·mapping·port·snapshot·value 식별자와 그 결과가 채운 rowKeys·fieldKeys가 있습니다. 일부 영역을 다시 계산하면 교체된 영역의 출처만 바뀌고 나머지 결과와 출처는 유지됩니다. SDK의 freshness.results는 이러한 저장 출처에 대응하는 판정을 반환하며, 조회 시 이를 표 셀 값이나 새 revision으로 저장하지 않습니다. 오래된 문서에 출처가 없는 결과는 목록에 없을 수 있으므로, 빈 목록이나 항목 부재를 current로 해석하면 안 됩니다.
정확한 저장 경계는 SDK 문법을 따릅니다.