你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
发行说明：Azure API for FHIR
重要
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 API for FHIR 的演化版本，可让客户管理 FHIR、DICOM 和医疗技术服务，并集成到其他 Azure 服务。
Azure API for FHIR 提供对 Microsoft FHIR Server for Azure 的完全托管部署。 该服务器是 FHIR 标准的一种实现。 本文档提供有关 Azure API for FHIR 的功能和增强功能的详细信息。
2024 年 3 月
默认情况下，Batch 捆绑并行化 Batch 捆绑包在 FHIR 服务中串行执行。 为了提高捆绑包调用的吞吐量，我们启用了批处理捆绑包的并行处理。
了解详细信息：
Bug 修复
- 已修复：提高捆绑处理的性能。 对任务执行方法进行汇报，从而导致捆绑处理性能改进。 请参阅 PR#3727。
2024 年 2 月
启用对资源 的所有版本（历史删除和软删除）进行计数。可将查询参数 _summary=count 和 _count=0 添加到_history终结点以获取所有版本控制的资源计数。 此计数包括软删除的资源。 有关详细信息，请参阅 历史记录管理。
提高导出操作 的吞吐量：可以将“_isparallel”查询参数添加到导出操作以提高其吞吐量。 请务必注意，使用此参数可能会导致在导出生命周期内请求单位消耗增加。 有关详细信息，请参阅 导出操作查询参数。
注意
$export操作存在一个已知问题，可能会导致状态成功导出不完整。 使用is_parallel标志时出现问题。 从 2024 年 2 月 13 日开始，使用 _isparallel 查询参数执行的导出作业将受到此问题的影响。
更改导出的文件名和默认存储帐户 的名称命名名称。更改此更改后，导出的文件名采用“{FHIR 资源名称}-{Number}-{Number}.ndjson”格式。 不保证文件的顺序与数据库中资源的任何排序相对应。 默认存储帐户名称将更新为“Export-{Number}”。 不会更改单个导出文件中添加的资源数。
可以使用 HTTP 标头“x-ms-query-latency-over-efficiency”启用 FHIR 查询的性能增强 并行优化。 此值需要设置为 true 才能在执行查询期间实现最大并发性。 有关详细信息，请参阅 Batch 捆绑包。
2024 年 1 月
使用条件交互 并发执行查询时，条件交互可能比较复杂且性能密集型。 若要增强涉及条件交互的查询延迟，可以选择使用请求标头 x-conditionalquery-processing-logic。 有关详细信息，请参阅 条件 API 交互的性能注意事项。
2023 年 12 月
添加到导出操作 的其他功能$export操作现在支持导出版本控制的资源和软删除的资源。 有关详细信息，请参阅 导出查询参数。
2023 年 11 月
批量删除功能现在以预览版 “$bulk-delete”提供，允许异步从 FHIR 服务器中删除资源。 可在系统级别或单个资源类型执行批量删除操作。 有关详细信息，请参阅 大容量删除操作。
批量删除操作目前以公共预览版提供。 查看免责声明以了解详细信息。 [!包括公共预览版免责声明]
Bug 修复：使用分页和重新验证的 FHIR 查询导致使用下一个链接时出错
现在解决了问题，并且 FHIR 查询使用包含/重新排除的延续令牌，不再报告异常。 有关修复的详细信息，请访问 #3525。
2023 年 6 月
Bug 修复：功能语句中的元数据终结点 URL 是每个 FHIR 规范的相对 URL ，功能语句中的元数据终结点 URL 必须是绝对 URL。 有关 FHIR 规范的详细信息，请访问 Capability 语句。 此扇区解决了此问题，有关详细信息，请访问 3265。
2023 年 5 月
SMART on FHIR：固定应用程序的临床范围映射
此 bug 修复了未正确解释后端应用程序临床范围的问题。 有关更多详细信息，请访问 #3250
2023 年 4 月
修复了与加载自定义搜索参数 相关的暂时性问题。此 bug 修复了该问题，其中 FHIR 服务在发生故障时不会加载最新的 SearchParameter 状态。 有关更多详细信息，请访问 #3222
2022 年 11 月
修复了使用 if-match 标头和 PATCH 更新资源时生成的错误
Bug 现已修复，如果与 Etag 标头匹配，资源将更新。 有关详细信息，请参阅 #2877|。
2022 年 5 月
增强
| 增强功能 | 相关信息 |
|---|---|
| 如果资源内容未更改，Azure API for FHIR 不会创建资源的新版本。 | 如果用户更新了现有资源，并且只有 meta.versionId 或 meta.lastUpdated 发生更改，则我们会返回“确定”以及现有资源信息，而不会更新 VersionId 和 lastUpdated。 有关详细信息，请参阅 #2519。 |
2022 年 4 月
增强功能
| 增强功能 | 相关信息 |
|---|---|
| FHIRPath Patch | FHIRPath Patch 已作为一项功能添加到 Azure API for FHIR。 这实现了 HL7 网站上定义的 FHIRPath Patch。 |
| 将捆绑包通知移动到核心 | 将 Resource.Bundle 命名空间引入核心后，对字符串资源文件的资源引用必须更加明确。 有关详细信息，请参阅 PR #2478。 |
| 在版本控制更新时处理无效标头 | 当版本控制策略设置为“版本控制更新”时，我们要求在更新时在请求的 if-match 标头中提供资源的最新版本。 指定的版本必须采用 ETag 格式。 以前，如果版本无效或格式不正确，将返回 500。 此更新现在返回“400 错误请求”。 有关详细信息，请参阅 PR #2467。 |
Bug 修复
| 缺陷修复 | 相关信息 |
|---|---|
| 将核心添加到资源路径 | 版本控制策略中意外删除了字符串资源的部分路径。 此修复会将其添加回去。 有关详细信息，请参阅 PR #2470。 |
| SQL 超时返回 500 错误 | 修复了当 SQL 请求超时且请求返回 500 时的 bug。 在日志中，与收到来自前端的 429 错误相比，这是 SQL 超时。 有关详细信息，请参阅 PR #2497。 |
2022 年 3 月
功能
| 功能 | 相关信息 |
|---|---|
| FHIRPath Patch | 此新功能使你能够在 FHIR 资源上使用 FHIRPath Patch。 有关详细信息，请参阅适用于 Azure API for FHIR 的 FHIR REST API 功能。 |
Bug 修复
| 缺陷修复 | 相关信息 |
|---|---|
在包含 _include 的搜索中复制资源 |
修复了在包含 _include 的搜索中单个资源可以返回两次的问题。 有关详细信息，请参阅 PR #2448。 |
| PUT 在版本控制更新时创建 | 修复了在将版本控制策略配置为 versioned-update时，PUT 创建的问题会导致错误。 有关详细信息，请参阅 PR #2457。 |
| 版本控制更新时标头处理无效 | 修复了无效的 if-match 标头会导致 HTTP 500 错误的问题。 现在将返回“HTTP 错误请求”。 有关详细信息，请参阅 PR #2467。 |
2022 年 2 月
功能和增强功能
| 增强功能 | 相关信息 |
|---|---|
| 在 BundleHandler 中添加了 429 重试和日志记录 | 在处理捆绑包时，我们有时会遇到 429 错误。 如果 FHIR 服务在 BundleHandler 层收到 429，我们将中止对捆绑包的处理，并跳过剩余的资源。 除了数据存储层中的重试之外，我们还添加了另一个重试，该重试将针对每个遇到 429 的资源执行一次。 有关此增强功能的详细信息，请参阅 PR #2400。 |
$convert-data 和 $de-id 的计费 |
Azure API for FHIR 的数据转换和已取消识别的导出功能现已正式发布。 已启用 Azure API for FHIR 中 $convert-data 和 $de-id 操作的计费。 计费仪表于 2022 年 3 月 1 日启用。 |
Bug 修复
| 缺陷修复 | 相关信息 |
|---|---|
| 更新分段搜索索引 | 存在一种极端情况，即未在资源上设置分段搜索索引。 现在，我们使用与主要搜索相同的索引进行分段搜索，以确保返回所有数据。 有关代码修复的详细信息，请参阅 PR #2430。 |
2021 年 12 月
功能和增强功能
| 增强功能 | 相关信息 |
|---|---|
将发布服务器添加到 CapabiilityStatement.name |
现在可以在 CapabilityStatement.name 的功能声明中找到发布服务器。 #2319 |
日志 FhirOperation 链接到对请求指标的匿名调用 |
我们没有记录不需要身份验证的操作。 我们扩展了在匿名调用的 RequestMetrics 中获取 FhirOperation 类型的功能。 #2295 |
Bug 修复
| 缺陷修复 | 相关信息 |
|---|---|
修复了 SearchParameter 代码为 null 时的 500 错误 |
修复了 SearchParameter 的以下问题：如果它的代码值为 null，则结果将为 500。 现在，它生成 InvalidResourceException 与其他值类似。 #2343 |
当输入 JSON 正文无效时，返回包含有效消息的 BadRequestException |
对于无效的 JSON 正文请求，FHIR 服务器返回 500 错误。 现在，我们将返回包含有效消息的 BadRequestException 而不是 500。 #2239 |
_sort 可能导致 ChainedSearch 返回错误的结果 |
以前，未清除链接搜索的 SearchOption 对象中的排序选项，导致排序选项被传递到链接子搜索，这是无效的。 当应有结果时，这可能会导致不生成任何结果。 此 bug 现已修复 #2347。 它解决了 GitHub bug #2344。 |
2021 年 11 月
功能和增强功能
| 增强功能 | 相关信息 |
|---|---|
| 处理 Patient-everything 链接 | 我们扩展了 Patient-everything 功能以处理患者链接 #2305。 有关详细信息，请参阅 FHIR 中的 Patient-everything 文档。 |
| 向功能声明中添加了软件名称和版本 | 在功能声明中，软件名称现在可以区分你使用的是 Azure API for FHIR 还是 Azure Health Data Services。 软件版本现在将指定托管服务中存在的开源发布包#2294。 地址：#1778 和 #2241 |
将 500 记录到 RequestMetric |
以前，RequestMetric 中未记录 500 或任何未知/未处理的错误。 现在将记录它们 #2240。 有关详细信息，请参阅在 Azure API for FHIR 中启用诊断设置 |
| 压缩延续令牌 | 在某些情况下，延续令牌太长，无法跟踪搜索中的下一个链接，并且会导致 404。 为了解决此问题，我们对延续令牌进行了压缩，以确保其保持在大小限制以下 #2279。 解决了问题 #2250。 |
Bug 修复
| 缺陷修复 | 相关信息 |
|---|---|
| 解决了在传递带有时区的日期时的 500 错误。 | 这修复了在将带有时区的日期传递到日期/时间字段时的 500 错误 #2270。 |
| 解决了在发布具有错误媒体类型的捆绑包时返回 500 错误的问题。 | 以前，在通过包含特定字符的键发布搜索时，会返回 500 错误。 这修复了此问题 #2264，并解决了 #2148。 |
2021 年 10 月
Bug 修复
| 无限循环 bug | 相关信息 |
|---|---|
| 修复了条件删除可能导致无限循环的问题。 | #2269 |
2021 年 9 月
功能和增强功能
| 增强功能 | 相关信息 |
|---|---|
| 添加了对条件修补程序的支持 | 条件修补程序 |
| 条件修补程序 | #2163 |
| 添加了条件修补程序审核事件。 | #2213 |
| 允许捆绑包中的 JSON 修补程序 | 捆绑包中的 JSON 修补程序 |
|---|---|
| 允许通过修补程序请求搜索历史捆绑包。 | #2156 |
| 使用二进制资源在捆绑包中启用了 JSON 修补程序。 | #2143 |
| 新的审核事件子类型 | 相关信息 |
|---|---|
| 添加了新的审核 OperationName 子类型。 | #2170 |
| 重新索引改进 | 相关信息 |
|---|---|
| 为重新索引参数添加了边界。 | #2103 |
| 更新重新索引参数边界的错误消息。 | #2109 |
| 添加了最终重新索引计数检查。 | #2099 |
Bug 修复
| 缺陷修复 | 相关信息 |
|---|---|
| 应用修补程序时，更广泛地捕获异常。 | #2192 |
| 使用 STU3 中的 PATCH 修复历史记录。 | #2177 |
| 自定义搜索 bug | 相关信息 |
|---|---|
| 解决自定义搜索参数失败的问题。 | #2133 |
| 在删除搜索参数时添加了重试逻辑。 | #2121 |
| 在 SearchParameterDefinitionManager 的搜索选项中设置最大项计数。 | #2141 |
| 如果搜索参数中存在错误的表达式，则提供更好的异常。 | #2157 |
| 解决了重试 503 错误 | 相关信息 |
|---|---|
| Azure Cosmos DB 中的重试 503 错误。 | #2106 |
| 修复了 StoreProcedures 中的 429 处理。 | #2165 |
| 解决了 GitHub 问题 | 相关信息 |
|---|---|
| 无法为 CarePlan 医疗设备创建自定义搜索参数。 | #2146 |
| 没有 ID 的条件创建的错误消息不明确。 | #2168 |
适用于 FHIR 的 IoT 连接器（预览版）
| 缺陷修复 | 相关信息 |
|---|---|
| 修复了断开的链接。 | 更新了指向 Azure API for FHIR 门户中 IoT 连接器 Azure 文档的链接。 |
后续步骤
有关 Azure Health Data Services（FHIR 服务、DICOM 服务和医疗技术服务）中的功能和 bug 修复的信息，请参阅
FHIR® 是 HL7 的注册商标，经 HL7 许可使用。