FHIR 서비스 시작
이 문서에서는 Azure Health Data Services에서 FHIR 서비스를 시작하는 기본 단계를 간략하게 설명합니다.
필수 조건으로 Azure 구독이 필요하며 Azure 리소스 그룹을 만들고 Azure 리소스를 배포할 수 있는 적절한 권한이 부여됩니다. 모든 단계를 수행하거나 기존 환경이 있는 경우 일부 단계를 건너뛸 수 있습니다. 또한 모든 단계를 결합하고 PowerShell, Azure CLI 및 REST API 스크립트에서 완료할 수 있습니다.
Azure 구독에 작업 영역 만들기
Azure Portal에서 또는 PowerShell, Azure CLI 및 REST API를 사용하여 작업 영역을 만들 수 있습니다. Azure Health Data Services 샘플에서 스크립트를 찾을 수 있습니다.
참고 항목
각 Azure 구독에서 만들 수 있는 작업 영역 수와 FHIR 서비스 인스턴스 수에는 제한이 있습니다.
작업 영역에서 FHIR 서비스 만들기
Azure Portal에서 또는 PowerShell, Azure CLI 및 REST API를 사용하여 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 메서드를 사용하여 직접 데이터를 로드할 수 있습니다. 데이터를 대량 로드하려면 아래에 나열된 오픈 소스 도구 중 하나를 사용할 수 있습니다.
- FHIR 로더 .NET 콘솔 앱이며 Azure Storage에 저장된 데이터를 FHIR 서비스에 로드합니다. 단일 스레드 앱이지만 로컬 또는 Docker 컨테이너에서 여러 복사본을 실행할 수 있습니다.
- FHIR 대량 로더 이 도구는 Azure 함수 앱(마이크로 서비스)이며 병렬 스레드에서 실행됩니다.
- 대량 가져오기 이 도구는 오픈 소스 FHIR 서버에서만 작동합니다. 그러나 나중에 Azure Health Data Services에 사용할 수 있습니다.
CMS, 검색, 프로필 유효성 검사 및 다시 인덱싱
상호 운용성 및 환자 액세스, 검색, 프로필 유효성 검사 및 다시 인덱스에 대한 자세한 내용은 FHIR 서비스 설명서에서 확인할 수 있습니다.
데이터 내보내기
필요에 따라($export) 데이터를 Azure Storage로 내보내고 분석 또는 기계 학습 프로젝트에서 사용할 수 있습니다. 데이터를 "있는 그대로" 내보내거나 ID 를 해제할 수 있습니다 ndjson .
오픈 소스 프로젝트를 사용하여 Synapse로 데이터를 내보 낼 수도 있습니다. 나중에 이 기능은 관리되는 서비스에 통합될 예정입니다.
데이터 변환
필요에 따라 HL7 v2 및 기타 형식 데이터를 FHIR로 변환할 수 있습니다.
Power BI 대시보드에서 FHIR 데이터 사용
필요에 따라 FHIR 데이터를 사용하여 Power BI 대시보드 보고서를 만들 수 있습니다.
다음 단계
이 문서에서는 FHIR 서비스 사용을 시작하는 기본 단계를 설명했습니다. Azure Health Data Services 작업 영역에서 FHIR 서비스를 배포하는 방법에 대한 자세한 내용은
FHIR®은 HL7의 등록 상표이며 HL7의 권한으로 사용됩니다.