기능
Azure API for FHIR은 Azure용 Microsoft FHIR Server의 완전 관리형 배포를 제공합니다. 서버는 FHIR 표준의 구현입니다. 이 문서에서는 FHIR 서버의 기본 기능을 나열합니다.
FHIR 버전
지원되는 최신 버전: 4.0.1
또한 현재 지원되는 이전 버전은 다음과 같습니다. 3.0.2
REST API
다음은 지원되는 RESTful 기능에 대한 요약입니다. 이러한 기능의 구현에 대한 자세한 내용은 FHIR REST API 기능을 참조 하세요.
API | FHIR용 Azure API | Azure Health Data Services의 FHIR 서비스 | Comment(설명) |
---|---|---|---|
읽기 | 예 | 예 | |
vread | 예 | 예 | |
업데이트 | 예 | 예 | |
낙관적 잠금으로 업데이트 | 예 | 예 | |
update(조건부) | 예 | 예 | |
패치 | 예 | 예 | JSON 패치 및 FHIRPath 패치만 지원합니다. |
패치(조건부) | 예 | 예 | JSON 패치 및 FHIRPath 패치만 지원합니다. |
내역 | 예 | 예 | |
만들기 | 예 | 예 | POST/PUT 모두 지원 |
create(조건부) | 예 | 예 | 문제 #1382 |
search | 부분 | 부분 | FHIR 검색 개요를 참조하세요. |
연결된 검색 | 예 | 예 | 아래 메모를 참고하세요. |
역방향 체인 검색 | 예 | 예 | 아래 메모를 참고하세요. |
배치 | 예 | 예 | |
트랜잭션 | 예 | 예 | |
paging | 부분 | 부분 | self 지원됩니다.next |
중개자 | 아니요 | 없음 |
참고 항목
Azure Cosmos DB에서 지원되는 Azure API for FHIR 및 오픈 소스 FHIR 서버에서 연결된 검색 및 역방향 체인 검색은 MVP 구현입니다. Azure Cosmos DB에서 연결된 검색을 수행하기 위해 구현은 검색 식을 안내하고 하위 쿼리를 실행하여 일치하는 리소스를 확인합니다. 이 작업은 식의 각 수준에 대해 수행됩니다. 쿼리가 1000개 이상의 결과를 반환하면 오류가 throw됩니다.
확장 작업
REST API를 확장하는 모든 작업이 지원됩니다.
검색 매개 변수 유형 | FHIR용 Azure API | Azure Health Data Services의 FHIR 서비스 | Comment(설명) |
---|---|---|---|
$export | 예 | 예 | 시스템, 그룹 및 환자를 지원합니다. |
$convert 데이터 | 예 | 예 | |
$validate | 예 | 예 | |
$member 일치 | 예 | 예 | |
모든 $patient | 예 | 예 | |
$purge 기록 | 예 | 예 |
지속성
Microsoft FHIR 서버에는 플러그형 지속성 모듈이 있습니다(참조 Microsoft.Health.Fhir.Core.Features.Persistence
).
현재 FHIR Server 오픈 소스 코드에는 Azure Cosmos DB 및 SQL Database에 대한 구현이 포함되어 있습니다.
Azure Cosmos DB는 전역적으로 분산된 다중 모델(NoSQL, MongoDB 등) 데이터베이스입니다. 다양한 일관성 수준을 지원합니다. 기본 배포 템플릿은 일관성을 사용하여 Strong
FHIR 서버를 구성하지만 요청 헤더를 사용하여 x-ms-consistency-level
요청에 따라 일관성 정책을 수정(일반적으로 완화)할 수 있습니다.
역할 기반 액세스 제어
FHIR 서버는 액세스 제어에 Microsoft Entra ID를 사용합니다. 특히 구성 매개 변수가 설정된 true
경우 FhirServer:Security:Enabled
RBAC(역할 기반 액세스 제어)가 적용되고 FHIR 서버에 대한 모든 요청(제외/metadata
)에 요청 헤더가 Authorization
Bearer <TOKEN>
설정되어 있어야 합니다. 토큰은 클레임에 roles
정의된 역할을 하나 이상 포함해야 합니다. 토큰에 지정된 리소스에 대해 지정된 작업을 허용하는 역할이 포함된 경우 요청이 허용됩니다.
현재 지정된 역할에 대해 허용되는 작업은 API에 전역적으로 적용됩니다.
서비스 제한
RU(요청 단위) - 포털에서 Azure API for FHIR에 대해 최대 100,000RU를 구성할 수 있습니다. 최소 400RU 또는 40RU/GB 중 더 큰 RU가 필요합니다. RU가 100,000개 이상 필요한 경우 RU를 늘리기 위해 지원 티켓을 입력할 수 있습니다. 사용 가능한 최대값은 1,000,000입니다. 또한 RU의 자동 크기 조정도 지원 합니다.
번들 크기 - 각 번들은 500개 항목으로 제한됩니다.
데이터 크기 - 데이터/문서는 각각 2MB 미만이어야 합니다.
구독 제한 - 기본적으로 각 구독은 최대 10개의 FHIR 서버 인스턴스로 제한됩니다. 구독당 더 많은 인스턴스가 필요한 경우 지원 티켓을 열고 요구 사항에 대한 세부 정보를 제공합니다.
리소스 크기 - 기록을 포함한 개별 리소스 크기는 20GB를 초과하면 안 됩니다.
다음 단계
이 문서에서는 Azure API for FHIR에서 지원되는 FHIR 기능에 대해 알아보았습니다. Azure API for FHIR 배포에 대한 자세한 내용은
FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기