FHIR 서비스에 대한 질문과 대답
Important
Azure API for FHIR은 2026년 9월 30일에 사용 중지됩니다. 해당 날짜까지 마이그레이션 전략에 따라 Azure Health Data Services FHIR 서비스로 전환합니다. Azure API for FHIR의 사용 중지로 인해 2025년 4월 1일부터 신규 배포가 허용되지 않습니다. Azure Health Data Services FHIR 서비스는 고객이 다른 Azure 서비스에 통합하여 FHIR, DICOM 및 MedTech 서비스를 관리할 수 있도록 하는 Azure API for FHIR의 진화된 버전입니다.
이 섹션에서는 Azure Health Data Services FHIR 서비스(여기서는 FHIR 서비스라고 함)에 대한 질문과 대답을 다룹니다.
FHIR 서비스: 기본 사항
FHIR이란?
FHIR(Fast Healthcare Interoperability Resources)은 서로 다른 의료 시스템 간에 의료 데이터를 교환할 수 있도록 하기 위한 상호 운용성 표준입니다. 이 표준은 HL7 조직에서 개발했으며 전 세계 의료 기관에서 채택하고 있습니다. 사용 가능한 FHIR의 최신 버전은 R4(릴리스 4)입니다. FHIR 서비스는 R4 및 이전 버전 STU3(Standard for Trial Use 3)을 지원합니다. FHIR에 대한 자세한 내용은 HL7.org를 방문하세요.
FHIR API 뒤에 있는 데이터가 Azure에 저장되어 있나요?
예, 데이터는 Azure의 관리되는 데이터베이스에 저장됩니다. Azure Health Data Services의 FHIR 서비스는 기본 데이터 저장소에 대한 직접 액세스를 제공하지 않습니다.
기본 데이터에 액세스하려면 어떻게 해야 하나요?
관리되는 서비스에서는 기본 데이터에 액세스할 수 없습니다. 이는 FHIR 서비스가 의료 데이터에 필요한 개인 정보 및 규정 준수 인증을 제공하는지 확인하기 위한 것입니다. 기본 데이터에 액세스해야 하는 경우 오픈 소스 FHIR 서버를 사용할 수 있습니다.
어떤 ID 공급자를 지원하나요?
ID 공급자로 Microsoft Entra ID를 지원합니다.
FHIR 서비스에서 Azure AD B2C를 사용할 수 있나요?
예. FHIR 서비스와 함께 Azure AD B2C(Azure Active Directory B2C)를 사용하여 애플리케이션 및 사용자에게 액세스 권한을 부여할 수 있습니다. 자세한 내용은 Azure Active Directory B2C를 사용하여 FHIR 서비스에 대한 액세스 권한을 부여합니다.
어떤 FHIR 버전을 지원합니까?
버전 4.0.0 및 3.0.1을 지원합니다.
자세한 내용은 지원되는 FHIR 기능을 참조 하세요. HL7 FHIR의 버전 기록에서 FHIR 버전(STU3에서 R4) 간의 변경된 내용을 읽을 수도 있습니다.
Azure Health Data Services의 FHIR용 Azure API와 FHIR 서비스의 차이점은 무엇인가요?
Azure API for FHIR은 처음 일반 공급 제품이며 2026년 9월 30일부터 사용 중지됩니다. Azure Health Data Services FHIR 서비스는 다음과 같은 추가 기능을 지원합니다.
기본적으로 각 Azure Health Data Services의 FHIR 인스턴스는 4TB의 스토리지 용량으로 제한됩니다. 스토리지 용량이 4TB를 초과하는 FHIR 인스턴스를 프로비전하려면 문제 유형 '서비스 및 구독 제한(할당량)'을 사용하여 지원 요청을 만듭니다.
Azure Health Data Services의 FHIR 서비스와 오픈 소스 FHIR 서버의 차이점은 무엇인가요?
Azure Health Data Services의 FHIR 서비스는 Azure용 오픈 소스 Microsoft FHIR Server의 호스트되고 관리되는 버전입니다. 관리되는 서비스에서 Microsoft는 모든 유지 관리 및 업데이트를 제공합니다.
Azure용 FHIR Server를 실행하는 경우 기본 서비스에 직접 액세스할 수 있지만 PHI 데이터를 저장하는 경우 서버 및 모든 필수 규정 준수 작업을 유지 관리 및 업데이트해야 합니다.
FHIR 서비스를 사용할 수 있는 지역은 무엇인가요?
FHIR 서비스는 Azure Health Data Services를 사용할 수 있는 모든 지역에서 사용할 수 있습니다. 지역별 제품 페이지에서 볼 수 있습니다.
FHIR 서비스에 릴리스되는 항목은 어디에서 확인할 수 있나요?
릴리스 정보 페이지에서는 지난달 관리되는 서비스에 제공된 모든 항목에 대한 개요를 제공합니다.
관리되는 서비스에 릴리스될 항목을 보려면 오픈 소스 FHIR 서버의 릴리스 페이지를 검토할 수 있습니다. Azure Health Data Services가 관리되는 서비스에 릴리스되고 오픈 소스의 릴리스 페이지에 있는 후 2주 후에 사용할 수 있는 경우 Azure Health Data Services를 사용하여 항목에 태그를 지정하기 위해 노력했습니다. 사용자 고유의 환경에서 테스트하려는 경우를 위해 빌드를 테스트하는 방법에 대한 지침도 포함되어 있습니다. 추가 관리 서비스 업데이트를 가장 잘 공유하는 방법을 평가하고 있습니다.
현재 관리되는 서비스에 있는 릴리스 패키지를 확인하려면 FHIR 서비스 및 속성 아래에 software.version 대한 기능 문을 볼 수 있습니다. 배포된 패키지가 표시됩니다.
내 데이터베이스에서 실행 중인 FHIR(R4/STU3) 버전은 어디에서 찾을 수 있나요?
속성(FHIR URL/메타데이터) 아래 fhirVersion 의 기능 문에서 노출된 정확한 FHIR 버전을 찾을 수 있습니다.
FHIR 서비스를 STU3에서 R4로 전환할 수 있나요?
아니요. 기존 데이터베이스의 버전을 변경할 방법이 없습니다. 새 FHIR 서비스를 만들고 데이터를 다시 로드해야 합니다. JSON에서 FHIR 변환기를 활용하여 STU3 데이터를 R4로 변환할 수 있습니다.
FHIR 서비스의 URL을 사용자 지정할 수 있나요?
아니요. FHIR 서비스의 URL은 변경할 수 없습니다.
FHIR 구현 및 사양
SMART on FHIR이란?
SMART(대체 가능한 의료 애플리케이션 및 재사용 가능한 기술) on FHIR는 파트너 애플리케이션을 FHIR 서버 및 건강 전자 기록 및 건강 정보 교환과 같은 기타 건강 IT 시스템과 통합하기 위한 오픈 사양의 집합입니다. SMART on FHIR 애플리케이션을 만들면 다양한 시스템에서 애플리케이션에 액세스하고 활용할 수 있습니다. SMART에 대한 자세한 내용은 SMART Health IT를 참조 하세요.
FHIR 서비스는 SMART on FHIR을 지원하나요?
예, 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 리소스가 필요한 경우 확장을 통해 기본 리소스 위에 사용자 지정 리소스를 빌드할 수 있습니다.
FHIR 서비스에서 확장이 지원되는가요?
유효한 FHIR JSON 데이터를 서버에 로드할 수 있습니다. 확장을 정의하는 구조 정의를 저장하려는 경우 이를 구조 정의 리소스로 저장할 수 있습니다. 확장을 검색하려면 고유한 검색 매개 변수를 정의해야 합니다.
XML에서 FHIR 서비스를 볼 어떻게 할까요? 있나요?
관리되는 서비스에서는 JSON만 지원합니다. 오픈 소스 FHIR 서버는 JSON 및 XML을 지원합니다. 오픈 소스에서 XML 버전을 확인하려면 _format= application/fhir+xml을 사용합니다.
_count 제한은 무엇인가요?
현재 _count 제한은 1000개입니다. _count를 1000개 이상으로 설정하면 1000개의 레코드만 표시된다는 경고가 번들에 표시됩니다.
FHIR 서비스에 번들을 게시할 수 있나요?
현재 일괄 처리 번들을 게시하고 FHIR 서비스에 트랜잭션 번들을 게시할 수 있습니다.
FHIR 서비스에서 단일 환자에 대한 모든 리소스를 얻으려면 어떻게 해야 하나요?
우리는 당신에게 단일 환자와 관련된 모든 데이터를 얻을 것이다 $patient 모든 작업을 지원합니다.
FHIR 서비스에서 리소스를 검색할 때 기본 정렬은 무엇인가요?
FHIR 서비스에서 문자열 및 dateTime 필드를 기준으로 정렬할 수 있습니다. 지원되는 다른 검색 매개 변수에 대한 자세한 내용은 FHIR 검색 개요를 참조하세요.
FHIR 서비스는 용어 작업을 지원하나요?
아니요, FHIR 서비스는 현재 용어 작업을 지원하지 않습니다.
FHIR 서비스의 삭제 형식 간의 차이점은 무엇인가요?
FHIR 서비스 내에서 지원되는 두 가지 기본 삭제 유형이 있습니다. 삭제 및 조건부 삭제입니다.
- 삭제를 사용하면 일시 삭제(가장 일반적인 형식)를 수행하도록 선택할 수 있으며 레코드의 기록 버전을 복구할 수 있습니다.
- 조건부 삭제를 사용하면 검색 조건을 전달하여 리소스를 한 번에 하나씩 또는 한 번에 여러 개 삭제할 수 있습니다.
- Delete 또는 조건부 삭제를 사용하여 매개 변수를 전달
hardDelete한 경우 모든 레코드와 기록이 삭제되고 복구할 수 없습니다.
FHIR 서비스 사용
FHIR 서비스에서 상태 검사를 수행할 수 있나요?
FHIR 서비스에서 상태 검사 수행하려면 GET 요청을 입력 {{fhirurl}}/health/check 합니다. FHIR 서비스의 상태 볼 수 있어야 합니다. 응답에서 200 및 OverallStatus가 정상인 HTTP 상태 코드 응답은 상태 검사 성공적임을 의미합니다.
오류가 발생할 경우 HTTP 상태 코드 404(찾을 수 없음) 또는 상태 코드 500(내부 서버 오류)과 응답 본문의 자세한 정보를 사용하여 오류 응답을 받을 수 있습니다.
다음 단계
이 문서에서는 FHIR 서비스에 대한 질문과 대답을 알아보았습니다. Azure API for FHIR의 FHIR 서비스에 대한 질문과 대답을 보려면 다음을 참조하세요.
FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.