릴리스 정보: 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 API for FHIR®은 Azure용 Microsoft FHIR Server의 완전 관리형 배포를 제공합니다. 서버는 FHIR 표준의 구현입니다. 이 문서에서는 Azure API for FHIR의 기능 및 향상된 기능에 대해 자세히 설명합니다.
2024년 11월
FHIR 서비스
버그 수정
- 내보내기 유효성 검사 개선: 잘못된 검색 매개 변수에도 불구하고 내보내기가 진행되는 문제가 발견되었습니다. 이러한 조건에서 내보내기를 방지하기 위해 새 변경 내용이 구현됩니다. 이 옵션은 기본 동작입니다. 고객은 관대한 플래그를 사용하여 재정의할 수 있습니다. 이 변경 내용은 지난 달 고객에게 전달되었습니다.
- 번들 성능 향상: 번들 실행 중 프로필 새로 고침 프로세스가 간소화되었습니다. 번들에 변경 내용
ValueSet
이CodeSystem
포함된 경우 번StructureDefinition
들이 완전히 완료될 때까지 프로필 새로 고침이 발생하지 않습니다. 이 변경은 이러한 리소스 종류에 대한 변경 내용을 처리할 때 여러 새로 고침으로 인한 지연을 줄여 번들의 성능을 향상시킵니다. - 콘텐츠 형식 헤더 구문 분석: 콘텐츠 형식 헤더 구문 분석
application/x-www-form-urlencoded
과 관련된 문제가 해결되었습니다. - 향상된 인덱싱 기능 다시 인덱싱 작업은 이전에 큰 기록 데이터 세트의 처리를 제한했던 인위적인 제한 사항 또는 고객이 제한된 쿼리 크기를 요청한 경우를 제거하여 개선되었습니다. 또한 다시 인덱스 프로세스는 기본 쿼리 크기로 여러 순차적 기록 또는 삭제된 리소스를 처리할 때 "완료됨"으로 잘못 보고됩니다. 이 문제는 다시 인덱싱 프로세스가 올바르게 완료되고 적절한 상태를 보고하도록 하기 위해 해결되었습니다.
2024년 10월
FHIR 서비스
버그 수정
- 내보내기 유효성 검사: 잘못된 검색 매개 변수에도 불구하고 내보내기가 진행되는 문제가 확인되었습니다. 이러한 조건에서 내보내기를 방지하는 변경 사항이 도입되었습니다. 이 기능은 현재 엄격한 유효성 검사 플래그 뒤에 있으며 10월 30일 이후의 기본 동작이 됩니다.
- 검색 매개 변수 포함: 추가 검색 매개 변수(예
_include
: )_has
가 예상된 모든 결과를 반환하지 않는 문제를 해결했으며, 때로는 다음 링크를 생략하기도 했습니다. - 내보내기 작업 실행: 내보내기 작업이 완료되는 동안 드물게 발생하는
System.ObjectDisposedException
경우는 조기 종료를 방지하여 해결되었습니다. - HTTP 상태 코드 업데이트: 작업을 만드는 동안
$reindex
잘못된 매개 변수에 대한 HTTP 상태 코드가 이제 400으로 업데이트되어 더 나은 오류 처리가 보장됩니다. - 검색 매개 변수 정리: 삭제 API 호출로 트리거될 때 데이터베이스의 검색 매개 변수를 완전히 정리하여 불완전한 삭제와 관련된 문제를 해결하는 수정 사항이 구현되었습니다.
2024년 8월
FHIR 서비스
버그 수정 자식 작업이 여전히 처리 중인 동안 큰 내보내기가 "완료됨" 상태를 잘못 표시하는 문제를 해결하기 위해 수정이 구현되었습니다. 이 솔루션은 이러한 상태 오류 발생을 완화하기 위해 지연을 통합하여 내보내기 안정성을 향상합니다.
2024년 7월
FHIR 서비스
버그 수정
수정됨: SMART 사용자로 데이터를 내보내는 SMART 사용자 로 데이터를 내보내는 경우 더 이상 쓰기 범위가 필요하지 않습니다. 이전에는 더 높은 권한 수준을 의미하는 데이터를 내보내기 위해 SMART 사용자에게 "쓰기" 권한을 부여해야 했습니다. SMART 사용자로 내보내기 작업을 시작하려면 사용자가 RBAC에서 FHIR 내보내기 역할의 멤버인지 확인하고 "읽기" SMART 임상 범위를 요청합니다.
수정됨: 패치 작업 중에 페이로드가 매개 변수 이외의 리소스 종류에 대한 업데이트를 요청한 경우 상태 코드를 HTTP 500 에서 HTTP 400으로 업데이트하면 처음에 내부 서버 오류(HTTP 500)가 throw되었습니다. 대신 HTTP 400 오류를 throw하도록 업데이트되었습니다.
2024년 5월
FHIR 서비스
제거 기록 작업의 향상된 기능 제거 기록 작업을 사용하면 쿼리 매개 변수 'allowPartialSuccess'를 사용하여 부분 삭제를 수행할 수 있습니다. 기본적으로 제거 기록 작업은 리소스를 삭제하기 전에 성공적으로 완료될 때까지 기다립니다. 그러나 실행 중에 오류가 발생하면 리소스 삭제가 롤백됩니다. 'allowPartialSuccess' 쿼리 매개 변수를 사용하면 오류가 발생할 경우 트랜잭션이 롤백되지 않도록 방지할 수 있습니다.
버그 수정
- 수정됨: 장기 실행 요청에 대한 HTTP 상태 코드입니다. 실행하는 데 100초보다 오래 걸리는 FHIR 요청은 HTTP 500 대신 HTTP 408 상태 코드를 반환합니다.
- 수정됨: 번들에 기록 요청이 있습니다. 수정하기 전에 번들에서 기록 요청이 HTTP 상태 코드 404를 반환했습니다.
2024년 3월
일괄 처리 번들 병렬 처리 일괄 처리 번들은 기본적으로 FHIR 서비스에서 직렬로 실행됩니다. 번들 호출을 통해 처리량을 개선하기 위해 일괄 처리 번들의 병렬 처리를 사용하도록 설정했습니다.
자세히 보기:
버그 수정
- 수정됨: 번들 처리 성능을 향상시킵니다. 작업 실행 방법에 대한 업데이트가 수행되어 번들 처리 성능이 향상됩니다. PR#3727을 참조하세요.
2024년 2월
리소스 의 모든 버전(기록 및 일시 삭제)을 계산할 수 있도록 쿼리 매개 변수 _summary=count 및 _count=0을 _history 엔드포인트에 추가하여 버전이 지정된 모든 리소스의 수를 가져올 수 있습니다. 이 수에는 일시 삭제된 리소스가 포함됩니다. 자세한 내용은 기록 관리를 참조하세요.
내보내기 작업의 처리량 향상 "_isparallel" 쿼리 매개 변수를 내보내기 작업에 추가하여 처리량을 향상시킬 수 있습니다. 이 매개 변수를 사용하면 내보내기 수명 동안 요청 단위 사용량이 증가할 수 있다는 점에 유의해야 합니다. 자세한 내용은 내보내기 작업 쿼리 매개 변수를 참조 하세요.
참고 항목
상태 성공으로 불완전한 내보내기를 초래할 수 있는 $export 작업에 알려진 문제가 있습니다. is_parallel 플래그를 사용할 때 문제가 발생합니다. 2024년 2월 13일부터 _isparallel 쿼리 매개 변수로 실행된 내보내기 작업이 이 문제의 영향을 받았습니다.
내보낸 파일 이름 및 기본 스토리지 계정에 대한 이름 명명법 변경이 변경되면 내보낸 파일 이름은 '{FHIR 리소스 이름}-{Number}-{Number}.ndjson' 형식을 따릅니다. 파일 순서는 데이터베이스의 리소스 순서에 해당하지 않습니다. 기본 스토리지 계정 이름은 'Export-{Number}'로 업데이트됩니다. 내보낸 개별 파일에 추가된 리소스 수는 변경되지 않습니다.
FHIR 쿼리에 대한 성능 향상 병렬 최적화는 HTTP 헤더 "x-ms-query-latency-over-efficiency"를 사용하여 사용하도록 설정할 수 있습니다. 쿼리를 실행하는 동안 최대 동시성을 달성하려면 이 값을 true로 설정해야 합니다. 자세한 내용은 Batch 번들을 참조 하세요.
2024년 1월
조건부 상호 작용 을 사용하여 쿼리를 동시에 실행하는 조건부 상호 작용은 복잡하고 성능이 많이 사용될 수 있습니다. 조건부 상호 작용과 관련된 쿼리의 대기 시간을 향상시키기 위해 요청 헤더 x-conditionalquery-processing-logic을 활용하는 옵션이 있습니다. 자세한 내용은 조건부 API 상호 작용에 대한 성능 고려 사항을 참조 하세요.
2023년 12월
내보내기 작업 $export 작업에 추가된 추가 기능은 이제 버전이 지정된 리소스 및 일시 삭제된 리소스 내보내기를 지원합니다. 자세한 내용은 쿼리 매개 변수 내보내기(Export Query Parameters)를 참조 하세요.
2023년 11월
이제 미리 보기 '$bulk 삭제'에서 대량 삭제 기능을 사용할 수 있으므로 FHIR 서버에서 리소스를 비동기적으로 삭제할 수 있습니다. 시스템 수준 또는 개별 리소스 종류에 대해 대량 삭제 작업을 실행할 수 있습니다. 자세한 내용은 대량 삭제 작업을 참조 하세요.
대량 삭제 작업은 현재 공개 미리 보기로 제공됩니다. 자세한 내용은 고지 사항을 검토하세요. [! 공개 미리 보기 고지 사항 포함]
버그 수정: 페이지 매김 및 revinclude를 사용하는 FHIR 쿼리로 인해 다음 링크 사용에 오류가 발생했습니다.
이제 문제가 해결되고 include/revinclude가 있는 연속 토큰을 사용하는 FHIR 쿼리가 더 이상 예외를 보고하지 않습니다. 수정에 대한 자세한 내용은 #3525를 방문하세요.
2023년 6월
버그 수정: 기능 문의 메타데이터 엔드포인트 URL은 FHIR 사양별 상대 URL 이며 기능 문의 메타데이터 엔드포인트 URL은 절대 URL이어야 합니다. FHIR 사양에 대한 자세한 내용은 Capability Statement를 참조 하세요. 이 fanix는 문제를 해결합니다. 자세한 내용은 3265를 방문하세요.
2023년 5월
SMART on FHIR: 애플리케이션에 대한 임상 범위 매핑 수정
이 버그 수정은 백 엔드 애플리케이션에 대해 임상 범위가 올바르게 해석되지 않는 문제를 해결합니다. 자세한 내용은 #3250을 참조 하세요.
2023년 4월
사용자 지정 검색 매개 변수 로드와 관련된 일시적인 문제가 해결되었습니다. 이 버그 수정은 FHIR 서비스가 실패 시 최신 SearchParameter 상태를 로드하지 않는 문제를 해결합니다. 자세한 내용은 #3222를 참조 하세요.
2022년 11월
if-match 헤더 및 PATCH를 사용하여 리소스를 업데이트할 때 발생하는 오류를 수정했습니다.
이제 버그가 수정되고 Etag 헤더와 일치하는 경우 리소스가 업데이트됩니다. 자세한 내용은 #2877|을(를) 참조하세요.
2022년 5월
향상
향상 | 관련 정보 |
---|---|
리소스 콘텐츠가 변경되지 않은 경우 Azure API for FHIR은 새 버전의 리소스를 만들지 않습니다. | 사용자가 기존 리소스를 업데이트하고 meta.versionId 또는 meta.lastUpdated만 변경한 경우 VersionId 및 lastUpdated를 업데이트하지 않고 기존 리소스 정보로 확인을 반환합니다. 자세한 내용은 #2519를 참조 하세요. |
2022년 4월
향상
향상된 기능 | 관련 정보 |
---|---|
FHIRPath 패치 | FHIRPath 패치는 Azure API for FHIR 모두에 기능으로 추가되었습니다. HL7 웹 사이트에 정의된 대로 FHIRPath 패치를 구현합니다. |
번들 알림을 Core로 이동 | Core에 Resource.Bundle 네임스페이스가 도입되면 문자열 리소스 파일에 대한 리소스 참조를 보다 명시적으로 만들어야 했습니다. 자세한 내용은 PR #2478을 참조 하세요. |
버전이 지정된 업데이트에서 잘못된 헤더 처리 | 버전 관리 정책이 "versioned-update"로 설정된 경우 업데이트에 대한 요청의 if-match 헤더에 최신 버전의 리소스가 제공되어야 합니다. 지정된 버전은 ETag 형식이어야 합니다. 이전에는 버전이 잘못되었거나 형식이 잘못된 경우 500이 반환되었습니다. 이 업데이트는 이제 400 잘못된 요청을 반환합니다. 자세한 내용은 PR #2467을 참조하세요. |
버그 수정
버그 수정 | 관련 정보 |
---|---|
리소스 경로에 코어 추가 | 문자열 리소스에 대한 경로의 일부가 버전 관리 정책에서 실수로 제거되었습니다. 이 수정은 다시 추가합니다. 자세한 내용은 PR #2470을 참조 하세요. |
SQL 시간 제한이 500 오류를 반환합니다. | SQL 요청이 시간 제한에 도달하고 요청이 500을 반환하는 버그가 수정되었습니다. 로그에서 이는 프런트 엔드에서 429 오류를 가져오는 것과 비교하여 SQL의 시간 제한입니다. 자세한 내용은 PR #2497을 참조하세요. |
2022년 3월
기능
기능 | 관련 정보 |
---|---|
FHIRPath 패치 | 이 새로운 기능을 사용하면 FHIR 리소스에서 FHIRPath 패치 작업을 사용할 수 있습니다. 자세한 내용은 Azure API for FHIR에 대한 FHIR REST API 기능을 참조하세요. |
버그 수정
버그 수정 | 관련 정보 |
---|---|
을 사용하여 검색 중인 리소스 복제 _include |
있는 검색에서 단일 리소스를 두 번 반환할 수 있는 문제가 해결되었습니다 _include . 자세한 내용은 PR #2448을 참조 하세요. |
버전이 지정된 업데이트에서 PUT 생성 | 해결된 문제: PUT을 사용하여 만들면 버전 관리 정책이 구성 versioned-update 될 때 오류가 발생했습니다. 자세한 내용은 PR #2457을 참조하세요. |
버전이 지정된 업데이트에서 헤더 처리가 잘못되었습니다. | 잘못된 if-match 헤더로 인해 HTTP 500 오류가 발생하는 문제가 해결되었습니다. 이제 HTTP 잘못된 요청이 대신 반환됩니다. 자세한 내용은 PR #2467을 참조하세요. |
2022년 2월
기능 및 향상된 기능
향상된 기능 | 관련 정보 |
---|---|
BundleHandler에서 429 다시 시도 및 로깅 추가 | 번들을 처리할 때 때때로 429개의 오류가 발생합니다. FHIR 서비스가 BundleHandler 계층에서 429를 받으면 번들 처리를 중단하고 나머지 리소스를 건너뜁니다. 429가 발생하는 리소스당 한 번 실행되는 또 다른 재시도(데이터 저장소 계층에 있는 재시도 외에)를 추가했습니다. 이 기능 향상에 대한 자세한 내용은 PR #2400을 참조 하세요. |
$convert-data 대금 청구 및$de-id |
이제 FHIR용 Azure API의 데이터 변환 및 식별되지 않은 내보내기 기능이 일반 공급됩니다. $convert-data Azure API for FHIR의 청구 및 $de-id 작업이 사용하도록 설정되었습니다. 청구 미터는 2022년 3월 1일에 설정되었습니다. |
버그 수정
버그 수정 | 관련 정보 |
---|---|
구획 검색 인덱스 업데이트 | 구획 검색 인덱스가 리소스에 설정되지 않은 경우가 있었습니다. 이제 구획 검색에 대한 기본 검색과 동일한 인덱스로 모든 데이터가 반환되는지 확인합니다. 코드 수정에 대한 자세한 내용은 PR #2430을 참조 하세요. |
2021년 12월
기능 및 향상된 기능
향상된 기능 | 관련 정보 |
---|---|
게시자를 에 추가 CapabilityStatement.name |
이제 기능 문에서 게시자를 찾을 수 있습니다 CapabilityStatement.name . #2319 |
요청 메트릭에 대한 익명 호출에 연결된 로그 FhirOperation |
인증이 필요하지 않은 작업을 로깅하지 않았습니다. 익명 호출에 대한 형식을 가져오는 FhirOperation 기능을 확장했습니다 RequestMetrics . #2295 |
버그 수정
버그 수정 | 관련 정보 |
---|---|
코드가 null인 경우 SearchParameter 500 오류 수정 |
Code에 null 값이 있는 경우 결과는 500이 되는 문제를 해결 SearchParameter 했습니다. 이제 다른 값과 InvalidResourceException 같은 결과가 발생합니다. #2343 |
입력 JSON 본문이 잘못된 경우 유효한 메시지와 함께 반환 BadRequestException 됩니다. |
잘못된 JSON 본문 요청의 경우 FHIR 서버가 500 오류를 반환했습니다. 이제 500이 아닌 유효한 메시지를 반환 BadRequestException 합니다. #2239 |
_sort ChainedSearch 잘못된 결과를 반환할 수 있습니다. |
이전에는 연결된 검색 개체의 SearchOption 정렬 옵션이 지워지지 않아 정렬 옵션이 연결된 하위 구조로 전달되어 유효하지 않습니다. 결과가 있을 때 결과가 발생하지 않을 수 있습니다. 이 버그는 이제 #2347로 수정되었습니다. GitHub 버그 #2344를 해결했습니다. |
2021년 11월
기능 및 향상된 기능
향상된 기능 | 관련 정보 |
---|---|
환자-모든 링크 처리 | 환자 링크 #2305를 처리하기 위해 환자-모든 기능을 확장했습니다. 자세한 내용은 FHIR 설명서의 Patient-Everything을 참조하세요. |
기능 문에 소프트웨어 이름 및 버전 추가 | 이제 기능 문에서 소프트웨어 이름은 Azure API for FHIR 또는 Azure Health Data Services를 사용하는 경우 구분됩니다. 이제 소프트웨어 버전에서 관리되는 서비스 #2294에 있는 오픈 소스 릴리스 패키지를 지정합니다. 주소: #1778 및 #2241 |
로 500s RequestMetric |
이전에는 500년대 또는 알 수 없거나 처리되지 않은 오류가 로그인되지 RequestMetric 않았습니다. 이제 기록되고 있습니다 #2240. 자세한 내용은 Azure API for FHIR에서 진단 설정 사용을 참조 하세요. |
연속 토큰 압축 | 특정 경우에 연속 토큰이 너무 길어서 검색에서 다음 링크를 따를 수 없으며 404가 발생합니다. 이 문제를 해결하기 위해 연속 토큰을 압축하여 크기 제한 #2279 이하로 유지되도록 했습니다. 문제 #2250을 해결합니다. |
버그 수정
버그 수정 | 관련 정보 |
---|---|
날짜가 표준 시간대와 함께 전달되었을 때 500 오류가 해결되었습니다. | 표준 시간대가 있는 날짜가 날짜/시간 필드 #2270으로 전달된 경우 500 오류가 수정됩니다. |
잘못된 미디어 유형이 있는 번들을 게시할 때 해결된 문제가 500 오류를 반환했습니다. | 이전에는 특정 문자가 포함된 키로 검색을 게시할 때 500 오류가 반환되었습니다. 이렇게 하면 이 문제 #2264가 해결되고 #2148이 해결됩니다. |
2021년 10월
버그 수정
무한 루프 버그 | 관련 정보 |
---|---|
조건부 삭제로 인해 무한 루프가 발생할 수 있는 문제가 해결되었습니다. | #2269 |
2021년 9월
기능 및 향상된 기능
향상된 기능 | 관련 정보 |
---|---|
조건부 패치에 대한 지원 추가 | 조건부 패치 |
조건부 패치 | #2163 |
조건부 패치 감사 이벤트가 추가되었습니다. | #2213 |
번들에서 JSON 패치 허용 | 번들의 JSON 패치 |
---|---|
패치 요청이 있는 검색 기록 번들을 허용합니다. | #2156 |
이진 리소스를 사용하여 번들에서 JSON 패치를 사용하도록 설정했습니다. | #2143 |
새 감사 이벤트 하위 형식 | 관련 정보 |
---|---|
새 Audit OperationName 하위 형식이 추가되었습니다. | #2170 |
향상된 다시 인덱싱 | 관련 정보 |
---|---|
다시 인덱스 매개 변수에 대한 경계가 추가되었습니다. | #2103 |
다시 인덱스 매개 변수 경계에 대한 오류 메시지를 업데이트합니다. | #2109 |
최종 다시 인덱스 수 검사가 추가되었습니다. | #2099 |
버그 수정
버그 수정 | 관련 정보 |
---|---|
패치를 적용할 때 예외에 대한 더 넓은 catch입니다. | #2192 |
STU3에서 PATCH를 사용하여 기록을 수정합니다. | #2177 |
사용자 지정 검색 버그 | 관련 정보 |
---|---|
사용자 지정 검색 매개 변수를 사용하여 오류를 해결합니다. | #2133 |
검색 매개 변수를 삭제하는 동안 재시도 논리가 추가되었습니다. | #2121 |
SearchParameterDefinitionManager의 검색 옵션에서 최대 항목 수를 설정합니다. | #2141 |
검색 매개 변수에 잘못된 식이 있는 경우 더 나은 예외를 제공합니다. | #2157 |
해결된 재시도 503 오류 | 관련 정보 |
---|---|
Azure Cosmos DB에서 503 오류를 다시 시도합니다. | #2106 |
StoreProcedures에서 429s 처리를 수정합니다. | #2165 |
GitHub 문제가 종결됨 | 관련 정보 |
---|---|
CarePlan 의료 기기에 대한 사용자 지정 검색 매개 변수를 만들 수 없습니다. | #2146 |
ID가 없는 조건부 만들기에 대한 명확하지 않은 오류 메시지입니다. | #2168 |
FHIR용 IoT 커넥터(미리 보기)
버그 수정 | 관련 정보 |
---|---|
끊어진 링크가 수정되었습니다. | Azure API for FHIR 포털의 IoT 커넥터 Azure 설명서에 대한 링크가 업데이트되었습니다. |
다음 단계
Azure Health Data Services(FHIR 서비스, DICOM 서비스 및 MedTech 서비스)의 기능 및 버그 수정에 대한 자세한 내용은 다음을 참조하세요.
참고 항목
FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.