의료 데이터 솔루션에서 Azure Health Data Services - 데이터 내보내기 사용
참고
이 콘텐츠는 현재 업데이트 중입니다.
Azure Health Data Services - 데이터 내보내기를 사용하면 Azure Health Data Services FHIR 서비스에서 Fabric OneLake로 FHIR(전자 의료 기록 교환) 데이터를 가져올 수 있습니다. 기능에 대해 자세히 알아보고 배포 및 구성하는 방법을 이해하려면 다음을 참조하세요.
Azure Health Data Services - 데이터 내보내기 파이프라인 실행
필수 구성 요소 및 배포 단계를 완료한 후 Azure Health Data Services FHIR 서비스에서 FHIR 데이터 수집을 시작하고 브론즈 및 실버 레이크하우스 레이어를 통해 변환할 수 있습니다. 이 섹션에서는 BYOS(Bring Your Own Storage) 수집 패턴을 사용하여 FHIR 데이터를 수집하는 방법에 대한 지침을 제공합니다.
참고
Azure Health Data Services FHIR 서비스는 FHIR R4 v4.0.1을 지원합니다. 지원되는 FHIR 형식에 대한 자세한 내용은 임상 데이터 수집을 위한 사용 고려 사항을 참조하세요.
데이터를 수집하려면 healthcare#_msft_clinical_ahds_fhirservice_export 데이터 파이프라인을 실행합니다. healthcare#_msft_ahds_fhirservice_export Notebook은 먼저 Azure Health Data Services FHIR 서비스에서 지정된 Azure Data Lake Storage Gen2 컨테이너로 데이터를 내보냅니다. 후속 Notebook인 healthcare#_msft_fhir_ndjson_bronze_ingestion과 healthcare#_msft_bronze_silver_flatten은 의료 데이터 기반을 사용하여 임상 데이터 수집에 설명된 대로 데이터를 추가로 처리합니다.
healthcare#_msft_ahds_fhirservice_export Notebook은 다음 작업을 수행합니다.
- Azure Marketplace 제품과 연결된 Azure Key Vault에서 함수 키를 검색합니다.
- 이 기능 키를 사용하여 Azure Marketplace 제품과 함께 배포된 Azure 함수를 트리거합니다.
- 전역 구성의 FHIR 서비스 URL을 사용하여 Azure Health Data Services FHIR 서비스에서 대량 내보내기를 요청합니다.
- FHIR 서비스를 폴링하여 대량 내보내기 완료를 확인하고 성공 상태 또는 최대 폴링 일 임계값에 도달할 때까지 다시 시도합니다.
대량 내보내기가 완료되면 파이프라인은 healthcare#_msft_fhir_ndjson_bronze_ingestion 및 healthcare#_msft_bronze_silver_flatten Notebook을 순차적으로 실행하여 데이터를 변환하고 로드합니다.
Security 권장 사항
Microsoft Fabric의 의료 데이터 솔루션에 대한 Azure Marketplace 제품을 배포한 후 다음 보안 권장 사항을 고려합니다.
Azure Functions 액세스 키 순환에 대한 모범 사례를 따릅니다.
공유 액세스 서명(SAS) 대신 OneLake 프라이빗 엔드포인트에 관리 ID를 사용합니다.
Azure Health Data Services - 데이터 내보내기 문제 해결
이 섹션에서는 Azure Health Data Services - 데이터 내보내기 기능을 사용할 때 발생할 수 있는 일반적인 문제 또는 오류를 간략하게 설명하고 해결 단계를 제공합니다.
FHIR 내보내기 Notebook을 사용하여 권한 부여 오류 해결
FHIR 내보내기 Notebook healthcare#_msft_ahds_fhirservice_export를 실행할 때 Azure 함수 앱이나 FHIR 서버에 필요한 권한을 할당하지 않은 경우 HTTP 401: 권한 없음 오류가 표시될 수 있습니다.
구성된 내보내기 스토리지 계정에서 FHIR 서비스의 함수 앱에 FHIR 데이터 내보내기 역할을 할당하고, FHIR 서비스에 Storage BLOB 데이터 기여자 역할을 할당해야 합니다.
자세한 내용은 Azure Marketplace 제품 배포 및 리소스 설정을 참조하세요.
FHIR 내보내기 Notebook을 사용하여 충돌 오류 해결
FHIR 내보내기 Notebook healthcare#_msft_ahds_fhirservice_export를 실행하면 가끔 HTTP 409: 충돌 오류가 표시될 수 있습니다.
Azure 함수 앱은 언제든지 하나의 내보내기 인스턴스만 실행하도록 구성됩니다. HTTP 409 오류는 다른 내보내기 작업이 이미 실행 중임을 의미합니다. 완료될 때까지 기다린 다음 다른 내보내기를 트리거합니다.
Azure Log Analytics를 사용하여 함수 앱 로그 모니터링
Azure 리소스 그룹에 배포된 Log Analytics 작업 영역에서 내보내기 함수 앱 서비스의 로그를 모니터링할 수 있습니다. 함수 앱 추적을 보기 위한 샘플 Kusto 쿼리는 다음과 같습니다.
AppTraces
| where AppRoleName startswith "msft-func-datamanager-export"