Azure API for FHIR에 대해 자주 묻는 질문

신속한 전자 의료 기록 교환(FHIR-"fire"로 발음됨)은 서로 다른 상태 시스템 간의 의료 데이터 교환을 가능하게 하는 상호 운용성 표준입니다. 이 표준은 HL7 조직에서 개발했으며 전 세계 의료 기관에서 채택하고 있습니다. 사용 가능한 FHIR의 최신 버전은 R4(릴리스 4)입니다. Azure API for FHIR은 R4 및 이전 버전 STU3(평가판용 표준 사용 3)을 지원합니다. FHIR에 대한 자세한 내용은 HL7.org를 방문하세요.

예, 데이터는 Azure의 관리되는 데이터베이스에 저장됩니다. Azure API for FHIR은 기본 데이터 저장소에 대한 직접 액세스를 제공하지 않습니다.

관리되는 서비스에서는 기본 데이터에 액세스할 수 없습니다. 이는 Azure API for FHIR이 의료 데이터에 필요한 개인 정보 및 규정 준수 인증을 제공하는지 확인하기 위한 것입니다. 기본 데이터에 액세스해야 하는 경우 오픈 소스 FHIR 서버를 사용할 수 있습니다.

ID 공급자로 Microsoft Entra ID를 지원합니다.

아니요, Azure API for FHIR에서는 B2C를 지원하지 않습니다. 보다 세부적인 액세스 제어가 필요한 경우 오픈 소스 FHIR 프록시를 살펴보는 것이 좋습니다.

관리되는 서비스의 데이터는 4시간마다 자동으로 백업되고 두 개의 백업이 유지 관리됩니다. 따라서 보존 기간은 8시간입니다. 데이터 복구는 지원 팀에서 수행하며 RPO(복구 지점 목표)는 240분 미만입니다.

고객은 지원 티켓을 통해 데이터를 복원하거나 기본 데이터 백업 정책을 변경하도록 요청할 수 있습니다.

버전 4.0.0 및 3.0.1을 지원합니다. 자세한 내용은 FHIR 지원 기능을 참조하세요. HL7 FHIR의 버전 기록에서 FHIR 버전(STU3에서 R4) 간의 변경된 내용을 읽을 수도 있습니다.

Azure IoT Connector for FHIR(미리 보기)은 현재 FHIR 버전 R4만 지원하며 Azure API for FHIR의 R4 인스턴스에 표시됩니다.

Azure API for FHIR은 일반적으로 사용 가능한 관리되는 FHIR 서비스입니다. Azure Health Data Services를 사용하면 동일한 작업 영역에 FHIR 서비스 및 DICOM 서비스를 배포할 수 있습니다. Azure Health Data Services 개요에서 더 자세한 내용을 제공합니다.

Azure API for FHIR은 Azure용 오픈 소스 Microsoft FHIR Server의 호스트되고 관리되는 버전입니다. 관리되는 서비스에서 Microsoft는 모든 유지 관리 및 업데이트를 제공합니다.

Azure용 FHIR Server를 실행하는 경우 기본 서비스에 직접 액세스할 수 있지만 PHI 데이터를 저장하는 경우 서버 및 모든 필수 규정 준수 작업을 유지 관리 및 업데이트해야 합니다.

Microsoft는 여러 지역에서 공공 및 정부 모두에 일반 공급을 제공합니다. Microsoft의 정부 클라우드 서비스에 대한 자세한 내용은 FedRAMP의 Azure 서비스를 참조하세요.

릴리스 정보 페이지에서는 지난달 관리되는 서비스에 제공된 모든 항목에 대한 개요를 제공합니다.

Azure API for FHIR에서 릴리스되는 내용에 대한 자세한 내용은 오픈 소스 FHIR 서버의 릴리스를 참조하세요. 관리되는 서비스에 릴리스될 경우 Azure-API-for-FHIR을 사용하여 항목에 태그를 지정하기 위해 노력했으며, 일반적으로 오픈 소스의 릴리스 페이지에 게시된 후 2주 후에 사용할 수 있습니다. 사용자 고유의 환경에서 테스트하려는 경우를 위해 빌드를 테스트하는 방법에 대한 지침도 포함되어 있습니다.

현재 관리되는 서비스에 있는 릴리스 패키지를 확인하려면 software.version 속성 아래에 Azure API for FHIR에 대한 기능 문을 볼 수 있습니다. 배포된 패키지가 표시됩니다.

fhirVersion 속성 아래 기능 문에서 노출되는 정확한 FHIR 버전을 찾을 수 있습니다.

아니요. 기존 데이터베이스의 버전을 변경할 방법이 없습니다. 새 Azure API for FHIR을 만들고 데이터를 다시 로드해야 합니다. JSON에서 FHIR 변환기를 활용하여 STU3 데이터를 R4로 변환할 수 있습니다.

아니요. Azure API for FHIR의 URL은 변경할 수 없습니다.

SMART(대체 가능한 의료 애플리케이션 및 재사용 가능한 기술) on FHIR는 파트너 애플리케이션을 FHIR 서버 및 건강 전자 기록 및 건강 정보 교환과 같은 기타 건강 IT 시스템과 통합하기 위한 오픈 사양의 집합입니다. SMART on FHIR 애플리케이션을 만들면 다양한 시스템에서 애플리케이션에 액세스하고 활용할 수 있습니다. SMART에 대한 자세한 내용은 SMART Health IT 웹 사이트를 방문하세요.

예, SMART on FHIR 기능은 AHDS 샘플을 사용하여 지원됩니다. 이를 SMART on FHIR(고급)이라고 합니다. SMART on FHIR(고급)은 SMART on FHIR 구현 가이드(v 1.0.0) 및 환자 및 인구 서비스 기준에 대한 §170.315(g)(10) 표준화된 API의 요구 사항을 충족하는 것으로 간주될 수 있습니다. 자세한 내용은 SMART on FHIR(고급) 설명서를 참조하세요.

사용자 지정 FHIR 리소스는 허용되지 않습니다. 사용자 지정 FHIR 리소스가 필요한 경우 확장을 통해 기본 리소스 위에 사용자 지정 리소스를 빌드할 수 있습니다.

유효한 FHIR JSON 데이터를 서버에 로드할 수 있습니다. 확장을 정의하는 구조 정의를 저장하려는 경우 이를 구조 정의 리소스로 저장할 수 있습니다. 확장을 검색하려면 고유한 검색 매개 변수를 정의해야 합니다.

리소스는 2MB 미만이어야 합니다. 이는 기본 데이터 저장소의 한도로 이 값을 늘릴 수 없습니다.

관리되는 서비스에서는 JSON만 지원합니다. 오픈 소스 FHIR 서버는 JSON 및 XML을 지원합니다. 오픈 소스에서 XML 버전을 확인하려면 _format= application/fhir+xml을 사용합니다.

현재 _count 제한은 1000개입니다. _count를 1000개 이상으로 설정하면 1000개의 레코드만 표시된다는 경고가 번들에 표시됩니다.

그룹 내보내기의 경우 그룹 리소스의 모든 특성이 아닌 그룹에 포함된 참조만 내보냅니다.

현재 일괄 처리 번들을 게시하는 것은 지원되지만 Azure API for FHIR에 트랜잭션 번들을 게시하는 것은 지원되지 않습니다. 트랜잭션 번들 지원이 필요한 경우 Azure Health Data Services에서 FHIR 서비스를 사용할 수 있습니다.

Patient-$everything 작업을 사용하거나 Azure API for FHIR에서 구획 검색을 사용할 수 있습니다. 이를 통해 특정 환자와 관련된 모든 리소스를 가져올 수 있습니다. 환자 구획에는 환자와 관련된 모든 리소스가 포함되지만 환자 자체는 포함되지 않으므로 결과에 환자 리소스가 필요한 경우 환자를 찾기 위해 검색해야 합니다.

마지막으로 업데이트된 날짜별 정렬을 지원합니다. _sort=_lastUpdated 또한 FirstName, LastName, BirthDate 및 ClinicalDate 요소에 대해 _sort를 지원합니다. 지원되는 다른 검색 매개 변수에 대한 자세한 내용은 FHIR 검색 개요를 참조하세요.

예, patient-$everything에 대한 지원을 제공합니다. 자세한 내용은 Patient-$Everything 방법 가이드를 참조하세요.

아니요, Azure API for FHIR은 현재 용어 작업을 지원하지 않습니다.

$export는 FHIR 사양의 일부입니다. FHIR 서비스가 관리 ID 및 스토리지 계정으로 구성되고 관리 ID가 해당 스토리지 계정에 액세스할 수 있는 경우 FHIR API에서 $export를 호출할 수 있으며 모든 FHIR 리소스가 스토리지 계정으로 내보내기 됩니다. 자세한 내용은 $export 문서를 참조하세요.

FHIR 데이터의 ID 관련 정보를 제거하는 오픈 소스 도구가 있습니다. 또한, 해당 기술은 ID 관련 정보를 제거하는 내보내기 형식으로 Azure API for FHIR에 통합됩니다.

익명화된 내보내기는 현재 전체 시스템 내보내기(/$export)에만 지원되며 환자 내보내기(/Patient/$export)에는 지원되지 않습니다. Microsoft에서는 환자 수준에서도 사용할 수 있도록 하기 위해 노력하고 있습니다.

Azure API for FHIR 내에서 지원되는 두 가지 기본 삭제 유형이 있습니다. 삭제 및 조건부 삭제입니다.

• 삭제를 사용하면 일시 삭제(가장 일반적인 형식)를 수행하도록 선택할 수 있으며 레코드의 기록 버전을 복구할 수 있습니다.
• 조건부 삭제를 사용하면 검색 조건을 전달하여 리소스를 한 번에 한 항목씩 삭제하거나 한 번에 여러 항목을 삭제할 수 있습니다.
• 삭제 또는 조건부 삭제를 사용하면 hardDelete 매개 변수를 전달할 경우 모든 레코드와 기록이 삭제되고 복구할 수 없습니다.

hardDelete 매개 변수를 사용하지 않으면 삭제된 파일을 복구할 수 있습니다. Azure API for FHIR의 레코드는 여전히 존재해야 합니다. 이 레코드는 리소스에 대한 기록 검색을 수행하고 데이터가 있는 마지막 버전을 검색하여 찾을 수 있습니다.

감사 로그 및 샘플 쿼리의 사용 설정에 대한 자세한 내용은 Azure API for FHIR에서 진단 로깅 사용을 참조하세요. 로그에 추가 정보를 포함하려면 사용자 지정 HTTP 헤더 사용을 참조하세요.

이 문제를 해결하려면 처리량을 늘리거나 자동 크기 조정으로 전환하여 요청을 처리하기에 충분한 컴퓨팅이 있는지 확인할 수 있습니다. 여전히 문제가 있는 경우 지원 티켓을 오픈하세요.

최소 RU 값은 GB당 40RU 이상이어야 합니다. 데이터를 로드할 때 이 최소값 미만이면 데이터베이스의 RU가 증가합니다.

상태 아키텍처 GitHub 페이지에서 사용할 수 있는 참조 아키텍처 컬렉션을 제공합니다.

FHIR 서비스에서 상태 검사를 수행하려면 GET 요청에 {{fhirurl}}/health/check를 입력합니다. FHIR 서비스의 상태를 볼 수 있어야 합니다. HTTP 상태 코드 응답이 200이고 OverallStatus가 응답에서 "정상"으로 표시되면 상태 검사가 성공적임을 의미합니다. 오류가 발생하면 HTTP 상태 코드 404(찾을 수 없음) 또는 상태 코드 500(내부 서버 오류)이 포함된 오류 응답과 일부 시나리오의 응답 본문에 자세한 정보를 받게 됩니다.

예, Azure API for FHIR을 사용하면 Azure Cosmos DB의 지원을 활용하여 고객 관리형 키를 구성할 수 있습니다. 개인 키를 사용하여 데이터를 암호화하는 방법에 대한 자세한 내용은 REST에서 고객 관리형 키 구성을 참조하세요.