FHIR 서비스 시작

아티클
07/02/2024

이 문서에서는 Azure Health Data Services에서 FHIR® 서비스를 시작하기 위한 기본 단계를 간략하게 설명합니다.

필수 조건으로 Azure 리소스 그룹을 만들고 Azure 리소스를 배포하려면 Azure 구독 및 권한이 필요합니다. 기존 환경에서는 아래의 모든 단계를 수행하거나 일부 단계를 건너뛸 수 있습니다. 또한 모든 단계를 결합하고 PowerShell, Azure CLI 및 REST API 스크립트에서 완료할 수 있습니다.

Azure 구독에 작업 영역 만들기

PowerShell, Azure CLI 및 REST API를 사용하거나 Azure Portal에서 작업 영역을 만듭니다. Azure Health Data Services 샘플에서 스크립트를 찾을 수 있습니다.

참고 항목

각 Azure 구독에서 만들 수 있는 작업 영역 수와 FHIR 서비스 인스턴스 수는 제한되어 있습니다.

작업 영역에서 FHIR 서비스 만들기

PowerShell, Azure CLI 및 REST API를 사용하거나 Azure Portal에서 FHIR 서비스 인스턴스를 만들 수 있습니다. Azure Health Data Services 샘플에서 스크립트를 찾을 수 있습니다.

필요에 따라 작업 영역에서 DICOM 서비스 및 MedTech 서비스를 만들 수 있습니다.

FHIR 서비스에 액세스

FHIR 서비스는 비활성화할 수 없는 Microsoft Entra ID로 보호됩니다. 서비스 API에 액세스하려면 Microsoft Entra ID에서 서비스 주체라고도 하는 클라이언트 애플리케이션을 만들어 올바른 권한을 부여해야 합니다.

클라이언트 애플리케이션 등록

Azure Portal에서 또는 PowerShell 및 Azure CLI 스크립트를 사용하여 클라이언트 응용 프로그램을 만들거나 등록할 수 있습니다. 이 클라이언트 응용 프로그램은 하나 이상의 FHIR 서비스 인스턴스에 사용할 수 있습니다. Azure Health Data Services의 다른 서비스에도 사용할 수 있습니다.

클라이언트 애플리케이션이 인증서 또는 클라이언트 비밀로 만들어진 경우 만료 전에 인증서 또는 클라이언트 암호를 갱신하고 애플리케이션에서 클라이언트 자격 증명을 바꿔야 합니다.

클라이언트 애플리케이션을 삭제할 수 있습니다. 클라이언트 애플리케이션을 삭제하기 전에 프로덕션, 개발, 테스트 또는 품질 보증(QA) 환경에서 사용되지 않는지 확인합니다.

액세스 권한 부여

Azure Portal에서 또는 PowerShell 및 Azure CLI 스크립트를 사용하여 액세스 권한을 부여하거나 역할을 할당합니다.

CRUD(만들기, 읽기, 업데이트 및 삭제) 트랜잭션 수행

애플리케이션의 FHIR 서비스에 대해 또는 Postman, REST 클라이언트 및 cURL과 같은 도구를 사용하여 CRUD(만들기, 읽기(검색), 업데이트 및 삭제) 트랜잭션을 수행할 수 있습니다. FHIR 서비스는 기본적으로 보호되므로 액세스 토큰을 가져와 트랜잭션 요청에 포함해야 합니다.

액세스 토큰 가져오기

PowerShell, Azure CLI, REST CCI 또는 .NET SDK를 사용하여 Microsoft Entra 액세스 토큰을 확보할 수 있습니다. 자세한 내용은 액세스 토큰 가져오기를 참조하세요.

기존 도구를 사용하여 액세스

데이터 로드

FHIR 서비스에 대해 POST 또는 PUT 메서드를 사용하여 데이터를 직접 로드할 수 있습니다. 데이터를 대량으로 로드하려면 $import 작업을 사용할 수 있습니다. 자세한 내용은 가져오기 작업을 참조하세요.

CMS, 검색, 프로필 유효성 검사 및 다시 인덱싱

상호 운용성 및 환자 액세스, 검색, 프로필 유효성 검사 및 다시 인덱싱에 대한 자세한 내용은 FHIR 서비스 설명서에서 확인할 수 있습니다.

데이터 내보내기

필요에 따라 데이터를 Azure Storage로 내보내고($export) 분석 또는 기계 학습 프로젝트에서 사용할 수 있습니다. 데이터를 ndjson 형식으로 "있는 그대로" 내보내거나 비식별화하여 내보낼 수 있습니다.

데이터 변환

필요에 따라 HL7 v2 데이터 및 기타 형식을 FHIR로 변환할 수 있습니다.

Power BI 대시보드에서 FHIR 데이터 사용

필요에 따라 FHIR 데이터를 사용하여 Power BI 대시보드 보고서를 만들 수 있습니다.

다음 단계

Azure Health Data Services에 FHIR 서비스 배포