Azure API for 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, DICOM 및 MedTech 서비스를 제공합니다.

Azure API for FHIR에서 Azure Health Data Services FHIR 서비스로 FHIR 데이터를 마이그레이션하는 경우 조직은 향상된 성능, 확장성, 보안 및 규정 준수의 이점을 누릴 수 있습니다. 조직은 Azure API for FHIR에서 사용할 수 없는 새로운 기능에 액세스할 수도 있습니다.

Azure API for FHIR은 2026년 9월 30일에 사용 중지되므로 가능한 빨리 FHIR 데이터를 Azure Health Data Services FHIR 서비스로 마이그레이션해야 합니다. 더 쉬운 프로세스를 위해 준비 상태를 평가하고, 데이터를 준비하고, 애플리케이션을 마이그레이션하고, 새 서비스로 축소하는 데 도움이 되는 몇 가지 도구와 팁을 마련했습니다.

권장 방법

데이터를 마이그레이션하려면 다음 단계를 수행합니다.

• 1단계: 준비 상태 평가
• 2단계: 마이그레이션 준비
• 3단계: 데이터 및 애플리케이션 워크로드 마이그레이션
• 4단계: Azure API for FHIR에서 Azure Health Data Services로 컷오버

1단계: 준비 상태 평가

Azure API for FHIR과 Azure Health Data Services 간의 차이점 비교 또한 아키텍처를 검토하고 변경 필요 여부를 평가합니다.

기능	FHIR용 Azure API	Azure Health Data Services
설정	지원됨: • 로컬 RBAC • Smart On FHIR 프록시	계획된 사용 중단: • 로컬 RBAC(9/6/23) • Smart On FHIR 프록시(9/21/26)
데이터 스토리지 볼륨	4TB 초과	현재 지원은 4TB입니다(4TB 이상이 필요한 경우 Azure 지원 요청 열기).
데이터 수신	OSS에서 사용할 수 있는 도구	$import 작업
자동 확장	요청 시 지원되며 요금 발생	추가 비용 없이 기본적으로 사용하도록 설정
검색 매개 변수	지원되는 번들 유형: 일괄 처리 • 포함 및 취소, 한정자 반복 지원되지 않음 • 이름, 성, 생년월일 및 임상 날짜별로 지원되는 정렬	지원되는 번들 유형: 일괄 처리 및 트랜잭션 • 선택 가능한 검색 매개 변수 • 포함 및 취소, 한정자 반복 지원 • 문자열 및 dateTime 필드에서 지원되는 정렬
이벤트	지원되지 않음	지원됨
인프라	지원됨: • 고객 관리형 키 • 지역 간 DR(재해 복구)	지원됨: • PITR(지정 시간 복구) • 고객 관리형 키 예정: • 가용성 영역 지원

아키텍처에 영향을 줄 수 있는 고려 사항

• Sync 에이전트는 사용 중지되는 과정에 있습니다. 동기화 에이전트를 사용하여 Dataverse에 연결하는 경우 Data Integration Toolkit 개요를 참조하세요.

• FHIR 프록시는 사용 중지되는 과정에 있습니다. 이벤트에 FHIR 프록시를 사용하는 경우 기본 제공 이벤트 기능을 참조하세요. Azure Health Data Services 도구 키트를 사용하여 대체 방법을 사용자 지정하고 빌드할 수 있습니다.

• SMART on FHIR 프록시는 사용 중지되는 과정에 있습니다. 새로운 SMART on FHIR 기능을 사용해야 합니다. 추가 정보: SMART on FHIR

• Azure Health Data Services FHIR 서비스는 로컬 RBAC 및 사용자 지정 권한을 지원하지 않습니다. 토큰 발급자 인증 기관은 FHIR 서비스가 실행 중인 테넌트에 대한 인증 끝점이어야 합니다.

• IoT 커넥터는 Azure API for FHIR 서비스를 사용해서만 지원됩니다. IoT 커넥터는 MedTech 서비스로 이어집니다. 기존 또는 새 Azure Health Data Services 작업 영역 내에 MedTech 서비스 및 해당 FHIR 서비스를 배포하고 장치를 새 Azure Events Hubs 장치 이벤트 허브로 지정해야 합니다. MedTech 서비스 배포와 함께 기존 IoT 커넥터 장치 및 대상 매핑 파일을 사용합니다.

기존 IoT 커넥터 장치 FHIR 데이터를 Azure API for FHIR 서비스에서 Azure Health Data Services FHIR 서비스로 마이그레이션하려면 마이그레이션 도구에서 대량 내보내기 및 가져오기 기능을 사용합니다. 또 다른 마이그레이션 경로는 새 MedTech 서비스를 배포하고 MedTech 서비스를 통해 IoT 장치 메시지를 재생하는 것입니다.

2단계: 마이그레이션 준비

먼저 마이그레이션 계획을 만듭니다. 표에 설명된 마이그레이션 패턴을 사용하는 것이 좋습니다. 가동 중지 시간에 대한 조직의 허용 범위에 따라 마이그레이션을 용이하게 하는 데 도움이 되는 특정 패턴 및 도구를 사용하도록 결정할 수 있습니다.

마이그레이션 패턴	세부 정보	방법은?
리프트 앤 시프트	가장 간단한 패턴입니다. 데이터 파이프라인이 더 긴 가동 중지 시간을 감당할 수 있는 경우 이상적입니다.	조직에 가장 적합한 옵션을 선택합니다. • Azure API for FHIR에서 데이터를 $export한 다음, Azure Health Data Services FHIR 서비스로 $import하는 워크플로를 구성합니다. • GitHub 리포지토리는 이러한 명령 실행에 대한 팁과 $import 페이로드 만들기를 자동화하는 데 도움이 되는 스크립트를 제공합니다. • 또는 $export 및 $import를 사용하여 데이터를 마이그레이션하는 고유한 도구를 만듭니다.
증분 복사	가동 중지 시간이 적은 리프트 앤 시프트의 연속 버전입니다. 복사하는 데 시간이 오래 걸리는 많은 양의 데이터가 있거나, 마이그레이션 중에 Azure API for FHIR을 계속 실행하려는 경우에 적합합니다.	조직에 가장 적합한 옵션을 선택하세요. • 이 마이그레이션 패턴을 지원하는 OSS 마이그레이션 도구를 제작했습니다. • 또는 데이터를 증분 방식으로 마이그레이션하는 고유한 도구를 만듭니다.

OSS 마이그레이션 도구 고려 사항

OSS 마이그레이션 도구를 사용하기로 결정했다면 마이그레이션 도구의 기능 및 제한 사항을 검토하고 이해합니다.

Azure API for FHIR 서버 준비

마이그레이션할 데이터를 식별합니다.

• 이 기회를 통해 FHIR 서버에서 더 이상 사용하지 않는 데이터 세트를 정리합니다.

• 기록 버전의 마이그레이션 여부를 결정합니다.

새 Azure Health Data Services FHIR 서비스 서버를 배포합니다.

• 먼저 Azure Health Data Services 작업 영역을 배포합니다.

• 이제 Azure Health Data Services FHIR 서비스 서버를 배포합니다. 자세한 내용은 Azure Health Data Services 내에 FHIR 서비스 배포를 참조하세요.

• 새 Azure Health Data Services FHIR 서비스 서버를 구성합니다. 새 서버에 대해 Azure API for FHIR에서와 동일한 구성을 사용해야 하는 경우 마이그레이션 도구 설명서에서 권장 확인 목록을 참조하세요. 마이그레이션하기 전에 설정을 구성합니다.

3단계: 마이그레이션

조직에 가장 적합한 마이그레이션 패턴을 선택합니다. OSS 마이그레이션 도구를 사용하는 경우 GitHub의 지침을 따릅니다.

4단계: 애플리케이션 마이그레이션 및 설정 다시 구성

이전 FHIR 서버를 가리키는 애플리케이션을 마이그레이션합니다.

• 새 FHIR 서버의 URL을 가리키도록 애플리케이션의 엔드포인트를 변경합니다.

• 이러한 앱에 대한 권한을 다시 설정합니다.

• 마이그레이션 후 새 Azure Health Data Services FHIR 서비스 서버에서 나머지 설정을 다시 구성합니다.

• Azure Health Data Services FHIR 서비스 및 Azure API for FHIR 서버의 구성이 동일한지 다시 확인하려면 두 메타데이터 엔드포인트를 확인하여 두 서버를 비교하고 대조할 수 있습니다.

• 이전 Azure API for FHIR 서버에서 이전에 실행되었던 모든 작업 설정(예: $export 작업)

5단계: Azure Health Data Services FHIR 서비스 컷오버

Azure Health Data Services FHIR 서비스 서버가 안정적이라 확신되면 Azure Health Data Services FHIR 서비스를 사용하여 비즈니스 시나리오를 이행할 수 있습니다. Azure API for FHIR에서 실행되는 나머지 파이프라인을 해제하고, 필요한 경우 마이그레이션 도구에 사용된 중간 스토리지 계정에서 데이터를 삭제하고, Azure API for FHIR 서버에서 데이터를 삭제하고, Azure API for FHIR 계정을 서비스 해제합니다.