버전 관리 정책 및 기록 관리

아티클
02/26/2024

Azure Health Data Services FHIR 서비스의 버전 관리 정책은 리소스별 구성 옵션을 사용하여 모든 리소스 종류에 대한 기록을 저장하는 방법을 결정하는 구성입니다. 이 정책은 FHIR 리소스에 대한 기록 관리 개념과 직접적으로 관련이 있습니다.

FHIR의 기록

FHIR의 기록은 모든 이전 버전의 리소스를 확인하는 기능을 제공합니다. FHIR의 기록은 리소스 수준, 유형 수준 또는 시스템 수준에서 쿼리할 수 있습니다. HL7 FHIR 설명서에는 기록 상호 작용에 대한 자세한 정보가 나와 있습니다. 기록은 FHIR에서 리소스의 진화를 확인하거나 특정 시점에 리소스의 정보를 확인하려는 시나리오에서 유용합니다.

이전 버전의 리소스는 모두 사용되지 않는 것으로 간주되며, 현재 버전의 리소스는 일반 비즈니스 워크플로 작업에 사용해야 합니다. 그러나 리소스의 상태를 과거 결정이 내려진 시점으로 보는 것이 유용할 수 있습니다.

버전 관리 정책

FHIR 서비스의 버전 관리 정책을 사용하면 기록이 FHIR 서비스 수준 또는 특정 리소스 수준에서 저장되는 방법을 결정할 수 있습니다.

버전 관리 정책에는 다음과 같은 세 가지 수준이 있습니다.

versioned: 리소스 작업에 대한 기록이 저장됩니다. 리소스 버전이 증가합니다. 기본값입니다.
version-update: 리소스 작업에 대한 기록이 저장됩니다. 리소스 버전이 증가합니다. 업데이트에는 유효한 If-Match 헤더가 필요합니다. 자세한 내용은 VersionedUpdateExample.http를 참조하세요.
no-version: 리소스에 대한 기록이 만들어지지 않습니다. 리소스 버전이 증가합니다.

버전 관리 정책은 시스템 수준 설정으로 구성하고 리소스 수준에서 재정의하는 데에도 사용할 수 있습니다. 시스템 수준 설정은 특정 리소스 수준 버전 관리 정책이 추가되지 않는 한 FHIR 서비스의 모든 리소스에 사용됩니다.

버전 관리 정책 비교

정책 값	기록 동작	`meta.versionId` 업데이트 동작	기본값
`versioned`	기록이 저장됨	If-Match가 필요하지 않음	예
`version-update`	기록이 저장됨	If-Match가 필요함	아니요
`no-version`	기록이 저장되지 않음	If-Match가 필요하지 않음	아니요

참고 항목

버전 관리 정책을 no-version으로 변경해도 기존 리소스 기록에는 영향을 주지 않습니다. 리소스에 대한 기록을 제거해야 하는 경우 $purge-history 작업을 사용합니다.

버전 관리 정책 구성

버전 관리 정책을 구성하려면 FHIR 서비스 내에서 버전 관리 정책 구성 블레이드를 선택합니다.

버전 관리 정책 구성으로 이동하면 시스템 수준과 리소스 수준에서 모두 설정을 구성할 수 있습니다(시스템 수준의 재정의로). 시스템 수준 구성(1로 표시)은 리소스별 재정의(2로 표시)가 구성되지 않은 한 FHIR 서비스의 모든 리소스에 적용됩니다.

리소스 수준 구성을 구성할 때 FHIR 리소스 종류(1로 표시)와 이 특정 리소스에 대한 특정 버전 관리 정책(2로 표시)을 선택할 수 있습니다. 저장을 위해 이 설정을 큐에 넣으려면 추가 단추(3으로 표시)를 선택해야 합니다.

버전 관리 정책 구성을 완료한 후 반드시 저장을 선택해야 합니다.

기록 관리

FHIR의 기록은 최종 사용자가 시간이 지남에 따라 리소스가 어떻게 변경되었는지 확인하는 데 중요합니다. 또한 감사 로그에 맞춰 사용자가 수정하기 전과 후의 리소스 상태를 확인하는 데 유용합니다. 일반적으로 기록이 필요하다는 것을 아는 한 리소스에 대한 기록을 유지하는 것이 좋습니다. 리소스를 자주 업데이트하면 데이터 저장소가 커질 수 있으며, 이는 대량의 데이터가 있는 FHIR 서비스에서 원치 않는 상황일 수 있습니다.

시스템 수준 또는 리소스 수준에서 버전 관리 정책을 변경해도 FHIR 서비스의 리소스에 대한 기존 기록이 제거되지 않습니다. FHIR 서비스에서 기록 데이터 크기를 줄이려는 경우 $purge-history 작업을 사용해야 합니다.

다음 단계

이 문서에서는 FHIR 서비스에서 리소스에 대한 기록을 삭제하는 방법을 알아보았습니다. 기록을 사용하지 않도록 설정하는 방법 및 기록 관리에 대한 몇 가지 개념에 대한 자세한 내용은 다음을 참조하세요.

기록 작업 삭제

FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.

다음을 통해 공유